用途:review-perf 是 agentic-workflow 评审包中的内部性能评审环节,由 review-change 或 product-audit 在对话中组合调用,作为被路由的步骤内联执行。它只产出发现,从不编辑、从不重构代码。
主要能力:按固定清单逐项评估调用方传入的 diff 或路径/glob(默认当前变更对比默认分支),并在返回表格顶部声明范围。检查项包括:变更的数据访问路径是否存在 N+1 查询/IO;新代码路径在输入可增长时是否说明算法复杂度;异步平台上热路径/请求路径是否新增阻塞 IO 或同步工作;变更打开的资源是否在所有路径(含错误路径)关闭或释放;是否引入无界增长(无淘汰的缓存、只追加的数组、未移除的监听器);Web 项目需说明包/资源影响;循环中不变量是否提升;读取用户规模数据的新列表是否有分页/限制;是否也存在过早优化;声明了性能命令时需在基线分支与变更上运行基准并引用两组数字,超出噪声带(项目声明值,否则 ±5%)为重大发现,命令失败本身也是发现;未声明性能命令时须明确标注 n/a。
使用方式:由调用方在对话中内联路由执行,按固定格式返回结果,包含范围、发现表格、清单统计、摘要与 PASS/FAIL 决策。存在未解决的 critical 或 major 发现则 FAIL,否则 PASS;minor 发现不阻塞,交由调用方分诊。
适用场景:对代码变更做性能层面的评审,尤其涉及数据访问、可增长输入、异步热路径与资源管理的改动。
限制:仅报告达到重要性门槛的问题,不报告注释/标点笔误、纯格式漂移、无规则依据的风格偏好或超出 SPEC 场景的假设性健壮性;空表格加 PASS 是良好变更的预期结果,不得填充表格。完成条件是每个清单项都有证据或明确标注 n/a 及原因,且不修改任何代码。官方文本暂未提供。