SuperAPI AI 工具集

performance-review

编程与开发

查看项目

更新于 11-11 11:01

技能介绍

用途

performance-review 是一个用于性能瓶颈分析与验证性修复的审查技能。当工作流步骤或用户请求性能瓶颈分析及验证性修复时使用,覆盖数据访问、计算、运行时/GC、网络、客户端交付和并发/韧性等层面。其目标是确保每一个交付的性能修复都能消除已测量或标记为静态风险的瓶颈,并用证据证明修复前后的变化。

主要能力

  • 多维度审查:按12个维度串行审查:查询形态/过度获取、索引/访问路径/数据拓扑、N+1 扇出、聚合/连接形态、物化/内存、写入路径/锁/事务、缓存、API 负载/前端交付/Core Web Vitals、进程内计算/算法复杂度、网络/协议往返、运行时/内存/GC 暂停、分布式韧性/负载管理。
  • 严重程度校准:每个数字须对照已知基准(延迟阶梯、利用率拐点、Core Web Vitals 阈值、缓存命中率数学等)校准后才能分配严重程度。
  • 证据驱动:每个性能主张须用测量或静态证据(文件:行号、查询文本/形态、行数、查询计划/explain 输出、跟踪、分析器或日志)证明。
  • 审查模式:默认独立运行仅审查(--review-only / --report-only 别名);--fix-loop 启用审查→验证→授权修复→全新复审循环,默认最多3轮;--fix-loop --loop-owner=caller 向拥有修复/复审的调用方返回只读通过。
  • 报告模式:--report-only 为只读叶子模式,仅执行阶段0–6,不嵌套子代理,不修改报告之外的任何内容,由调用方负责修复。

使用方式

该技能以 SKILL.md 形式注册于 .agents/skills/<name>/ 目录,在 Codex 环境中通过 $skill-name 调用,无需单独 Skill 工具或 Claude 模式切换。工作流步骤或其它技能指定技能时,需自行完整读取该文件(逐行、不限行数;仅在输出被截断时分段读取)。执行前跟踪步骤并保持进度/证据最新。显式技能请求执行其协议。需要提问时使用原生 question 工具。

适用场景

  • 工作流步骤或用户请求性能瓶颈分析与验证性修复。
  • 数据库慢查询、全表扫描、排序溢出、高扫描行数等读性能问题。
  • 慢保存、锁等待、逐行更新、事务膨胀等写性能问题。
  • N+1 扇出、循环内查询/API 调用、延迟加载、逐项查找。
  • API 延迟高(p95/p99)、超时、慢端点/作业。
  • 操作本身快但 p95/p99 高(饱和/排队)、连接池耗尽、线程阻塞于获取。
  • 内存/OOM:大物化、blob、无分页、缓冲。
  • 前端交付与 Core Web Vitals 问题。
  • 架构层面的性能评审(使用 Architecture-Altitude 视角)。

限制

  • 仅依据资料事实,具体实现细节和平台兼容性暂未提供。
  • 所有性能结论必须有证据,不得凭记忆引用基准常数分配严重程度。
  • 修复须保持行为、授权与语义不变,不得隐藏浪费或破坏正确性。
  • 二值门禁失败始终阻塞。
  • 默认最多3轮修复循环,扩展轮次需用户批准。
  • --report-only 模式下不运行阶段7,不进行嵌套扇出,不向用户提问,仅写报告。
  • 资料中未提供收费、价格、平台、效果或具体使用步骤的完整信息。