用途:从 bug 出发,通过排查代码库定位根本原因,再编写详尽的 agent brief 报告,引导 AFK agent 完成修正。把执行者当成在代码库中搜索线索的侦探。适用于用户遇到 bug 需要调查、排查测试失败,或需要系统性找出源代码问题时。
流程:一、获取上下文。读取 issue 对应的票,读取项目根目录下的 CONTEXT.md(如存在,让 /setup-matt-pocock-skills 确认),理解项目架构、领域术语以及 docs/adr/ 下相关的 ADR。二、阅读源代码。从用户看到的行为出发追溯调用路径,找出产生错误行为的具体高层级模块与逻辑,必要时运行测试和代码检查验证判断,并查看 git log(git log --oneline --all -- <path>)纳入近期改动线索。三、编写报告。报告包含发现(为什么出现问题)、原因(代码中的根本原因)、修复(应该如何改正),引用具体函数名、类型和领域术语,但不写文件路径或行号,避免过时。随后以评论形式更新 issue,并附上完整 agent brief,供 AFK agent 接手修正。
指导原则:做代码侦探而非复述者,不要只复述 issue 内容,应追溯代码并形成自己的判断,能说明调用链走向、原因和修改方式;引述代码库自身的领域术语(如 CONTEXT.md 称某模块为 resolver chain 就用该词),便于 agent 采取行动;撰写他人可直接使用的 agent brief,AFK agent 应能严格依据 brief 完成修复,无需再翻阅 issue 讨论上下文,具体格式见 AGENT-BRIEF.md。
限制:资料未提供该技能的安装方式、依赖环境、支持平台、收费或价格信息,也未提供完整代码示例,此处暂未提供。