SuperAPI AI 工具集

perf-ops

部署与运维

查看项目

更新于 10-13 16:55

技能介绍

用途

perf-ops 是一个面向多语言的性能剖析与优化编排器(Performance Operations)。它的核心职责是:诊断性能症状、将剖析任务分派给预加载了对应语言 -ops 技能的通用代理、并在用户确认后管理优化与前后对比。它本身不直接替代各语言的剖析工具,而是负责分类、路由、调度和结果整合。

主要能力

该技能采用三层结构运作。

T1 诊断(内联执行):无需代理,直接通过 Bash 运行以获得即时结果。包括:分类症状(决策树)、从项目检测语言与运行时(检查 package.json、go.mod、Cargo.toml、pyproject.toml、requirements.txt)、检查已安装的剖析工具、判断生产还是开发环境、采集系统基线(CPU/内存/磁盘)。工具检测示例:Python 检测 py-spy、memray、scalene;Go 检测 go tool pprof;Rust 检测 cargo-flamegraph、samply;Node 检测 clinic、0x;基准工具检测 hyperfine、k6、vegeta。生产安全规则:在生产环境中只推荐采样型剖析器(py-spy、pprof HTTP endpoint、perf),绝不建议附加调试器、追踪型剖析器或需要重启进程的工具。

T2 剖析(分派代理):根据 T1 上下文,分派通用代理并预加载相关语言 -ops 技能及 perf-ops 参考资料。语言路由表覆盖:Python(py-spy、memray、scalene、tracemalloc)、Go(pprof 的 CPU/heap/goroutine/mutex、benchstat)、Rust(cargo-flamegraph、samply、DHAT、criterion)、TypeScript/JavaScript 后端(clinic flame/doctor/bubbleprof、0x)、TypeScript/JavaScript 前端打包问题(webpack-bundle-analyzer、Lighthouse、source-map-explorer)、页面速度/Core Web Vitals(路由到 web-perf-ops 而非分派)、SQL/PostgreSQL(EXPLAIN ANALYZE、pg_stat_statements、pgbench)、SQL/SQLite 及 Cloudflare D1、libSQL/Turso(EXPLAIN QUERY PLAN、eqp-triage.py、sqlite3 .timer/.stats、wrangler d1 insights、sql_duration_ms 与 rows_read)、通用/未知/CLI 基准(hyperfine、perf、strace)。执行模式依据场景选择前台或后台:用户等待结果、快速基准(hyperfine)用前台;用户继续其他工作、负载测试(k6、artillery)用后台。

T3 优化(需预检确认):分派通用代理但明确要求在任何代码变更前生成预检报告,内容包括:将做的确切代码/配置变更、预期性能提升及理由、风险(正确性、副作用、边界情况)、如何验证改进(具体基准或测试)、如出问题如何回滚。用户确认后再重新分派执行,并附前后协议:记录当前基线与具体命令、应用已批准变更、再次运行相同基准、报告对比(指标:前值 -> 后值,百分比变化,如工具支持则含统计置信度)、如检测到回归则回滚并报告。

并行剖析:当存在多个独立症状或用户要求全面剖析时,可分派并行代理。可并行组合包括:CPU 剖析器 + 内存剖析器(不同工具不同数据)、CPU 剖析器 + 基线基准(读取 vs 测量)、后端剖析器 + 前端打包分析(不同运行时)、服务 A 剖析器 + 服务 B 剖析器(不同进程)。不可并行的组合:剖析与结果解读(有依赖关系)、前基准与后基准(中间需改代码)、负载测试与同进程 CPU 剖析(工具相互干扰)。

回退机制:若无语言 -ops 技能覆盖目标,则分派通用代理并内联剖析命令;对于简单基准(hyperfine、单命令计时),完全跳过代理分派,直接内联运行。

使用方式

当收到性能相关请求时:1)分类请求(症状描述 -> 从 T1 开始;"profile my app" -> T1 检测语言与工具后进 T2;"benchmark X vs Y" -> 直接 T2;"optimize this" -> 先 T2 后 T3;"why is X slow" -> T1 后针对性 T2)。2)T1 诊断对新问题总是先运行。3)T2 在诊断指向具体瓶颈时按路由表分派。4)T3 仅在用户希望应用变更时执行,始终先生成预检报告并等待明确确认。

适用场景

覆盖跨语言性能剖析(Python、Go、Rust、TypeScript/JavaScript、SQL)、前端打包分析与页面速度、数据库查询优化、负载测试、基准对比、CI 中的性能回归检测等。可与其他技能组合使用,例如 web-perf-ops(前端页面速度与 Core Web Vitals)、debug-ops(性能回归根因分析)、monitoring-ops(生产指标与延迟告警)、testing-ops(CI 中的性能回归测试与基准套件)、code-stats(识别可能对性能敏感的复杂代码)、postgres-ops(PostgreSQL 查询优化与索引)、sqlite-ops(SQLite/D1/libSQL 查询计划)、container-orchestration(资源限制与容器性能)。

限制

资料中未提供该技能的安装步骤、收费与价格信息、平台兼容性范围及具体可用性说明,这些事实暂未提供。