diagnosing-bugs
Installation
SKILL.md
诊断 bug
处理疑难 bug 的方法。按阶段推进;跳过某个阶段时,明确说明理由。
探索代码库时,阅读 CONTEXT.md(如果存在),准确理解相关模块,并查看相关区域的 ADR。
脱敏
本 skill 需要你展示命令、输出和抓取的数据。先对所有密钥脱敏:在原位置写 <已脱敏>。
- 反馈回路通过环境变量读取凭据,让凭据留在环境中,不出现在你展示的内容里。
- 抓取的数据常带有认证头:只引用包含诊断信息的那几行。
脱敏后的输出不足以诊断时,说明这一点并请用户协助。
阶段 1:建立反馈回路
这是本 skill 的核心。 其余阶段都比较机械。只要拥有一个针对这个 bug 的快速、确定的通过或失败信号(一个会在这个 bug 上变红的信号),就一定能找到原因;二分、假设检验和插桩都建立在这个信号之上。没有这个信号,读再久的代码也无法定位问题。