diagnose
Installation
SKILL.md
Diagnose
从 bug 出发,通过排查代码库来定位根本原因,然后编写详尽的 agent brief 报告,引导 AFK agent 完成修正。把你自己当成一位在代码库中搜索线索的侦探。
流程
1. 获取上下文
读取 issue 对应的票。读取项目根目录下的 CONTEXT.md(如果存在,让 /setup-matt-pocock-skills 确认),理解项目架构、领域术语以及任何相关的 docs/adr/ 下的 ADR。
2. 阅读源代码
追溯 bug —— 从用户看到的行为开始,追踪代码路径,直到找到根源。目标是对应到一个具体的高层级模块以及其中出错的逻辑。具体来说:
- 从 issue 报告的症状出发
- 沿着调用路径往回追溯
- 找出哪段逻辑产生了错误行为
- 如果需要,运行测试和代码检查来验证你的判断
- 查看 git log,找到最近对相关区域所做的修改(
git log --oneline --all -- <path>),并把线索一并纳入结论中