[!info] related notes

• 相关主题: Hypothesis-Driven Debugging, Fast Feedback Loops
• 相关 MOC: Matt Pocock Skills MOC
• 相关 howto: Browser DevTools MOC

Diagnose Skill

这是什么

一个把 debug 变成实验流程的 skill。它要求先建立稳定的 pass/fail 信号，再复现问题、提出可证伪假设、插桩验证，最后修复并补回归测试。

适用平台

• Claude Code、Codex 等 coding agent
• 常规软件调试、测试失败分析、性能退化排查

核心特点 / 优势 / 局限

• 生效方式：强制先拿到复现和反馈循环，再进入猜想阶段
• 为什么要用：能防止人或 agent 直接“看代码瞎猜”
• 背后原理：debug 本质上是实验设计，不是灵感比赛
• 局限：如果系统没有可复现输入或没有观测手段，skill 本身也无能为力

常见用途

• 处理测试失败、线上 bug、偶发行为异常
• 性能回退时先测量、再 bisect、再定位
• 把修 bug 结果固化成回归测试

相关链接 / 官方入口

• 上游 skill：skills/engineering/diagnose/SKILL.md

Related notes

• Matt Pocock Skills MOC
• Skills 是什么，为什么重要