用途:perf 用于性能剖析、基准测试、回归检测与优化建议,覆盖 Go、Python、Node、Rust、Shell 等语言运行时,产出可落地的指标而非泛泛建议。
主要能力与模式:/perf profile <target> 剖析执行找热点;/perf bench <target> 创建或运行基准;/perf compare <baseline> <candidate> 比较两次运行找回归;/perf optimize <target> 分析并应用优化。未指定模式时默认 profile。
使用方式:先按文件扩展名、go.mod、package.json、pyproject.toml、Cargo.toml 等识别语言与工具链,检查工具是否已安装,缺失时优先回退标准库方案。随后建立基线,运行已有基准或新建基准,记录墙钟时间、内存分配与 p50/p95/p99 延迟,原始输出保存到 .agents/perf/baseline-YYYY-MM-DD.txt。再做 CPU、内存与 I/O 剖析并输出按累计耗时排序的热点列表,按影响等级(高:>20% 时间或 >50% 分配;中:5-20%;低:<5%)分类。optimize 模式强调一次只做一处优化,改后重跑基准,用 benchstat 或手动对比决定保留或回滚,提交信息形如 perf(<scope>): <description> (+X% throughput)。报告写入 .agents/perf/YYYY-MM-DD-perf-<target>.md。
适用场景与限制:适合已有明确目标函数或模块、需要量化性能瓶颈的工程任务;需已有或可创建基准。若缺少性能剖析工具,只能回退 time 与手动插桩;无基准且目标不明时先用 /refactor 找热点。验收要求改进具统计显著性(benchstat p<0.05 或一致变化 >5%)、不引入正确性回归、且不以可读性换取 <2% 的微小收益。其他平台支持与费用信息暂未提供。