| name | perf-diagnosis |
| description | 性能诊断(诊断型 skill·只读)。定位慢 SQL、内存热点、接口耗时,给结论与建议。触发:慢查询/接口卡/内存高/CPU 飙时排查根因。只读不改动系统。 |
| license | MIT |
| metadata | {"author":"Johnson","version":"1.0"} |
性能诊断技能(诊断型 skill · 只读)
分析性能问题(慢 SQL / 内存热点 / 链路耗时),给结论与建议。只读,绝不改动系统。
这是「诊断型 skill」的范例——和工具型(连库查数据)、编排型(跑流程)不同,诊断型 skill 的命门是只读 + 给依据:只采集、分析、归因、建议,不执行任何变更。变更交给人和 devflow。
何时触发
- 用户说「这条 SQL 慢」「接口耗时高」「内存/CPU 飙」「查性能根因」
- AI 拿到 EXPLAIN / 日志 / 指标时,主动归因
工作流
慢 SQL:解析 EXPLAIN
python3 ~/.claude/skills/perf-diagnosis/scripts/analyze_slow_sql.py <explain文件>
检测全表扫描 / 高成本节点 / 嵌套循环,给索引/JOIN 优化建议。
内存 / 链路:见 reference/checklist.md
按清单逐项归因(堆 dump / 火焰图 / 链路 trace)。
设计要点
- 只读边界:脚本只解析输入文本(EXPLAIN/日志),不连库、不执行 SQL、不改配置。安全是诊断型的命门。
- 给依据不给命令:输出"问题 + 原因 + 建议",不直接"帮你改"——变更走 devflow + 人确认。
- 可复用清单:
reference/checklist.md 沉淀诊断方法论,新场景按清单扩展。