用途:从 bug 出发,通过排查代码库定位根本原因,然后编写详尽的 agent brief 报告,引导 AFK agent 完成修正。适用于用户遇到 bug 需要调查、排查测试失败,或需要系统性找出源代码中的问题。
主要流程:
- 获取上下文:读取 issue 对应的票,读取项目根目录下的 CONTEXT.md(如果存在),理解项目架构、领域术语以及 docs/adr/ 下的相关 ADR。
- 阅读源代码:从 issue 报告的症状出发,沿调用路径往回追溯,找出产生错误行为的逻辑,必要时运行测试和代码检查验证判断;查看 git log 找到最近对相关区域的修改(git log --oneline --all -- <path>),并把线索纳入结论。
- 编写报告:就发现(为什么出现问题)、原因(代码中的根本原因)、修复(应该如何改正)撰写有实质内容的报告。引用具体函数名、类型和领域术语,但不写文件路径或行号。然后用报告更新 issue(以评论形式),并附上完整的 agent brief,以便 AFK agent 接手修正。
指导原则:做代码侦探而非复述者,trace code 形成自己的判断;引述项目自身的领域术语;写一份其他人能直接拿来用的 agent brief,使 AFK agent 能严格依据 brief 完成修复,无需再翻阅 issue 讨论。具体格式见 AGENT-BRIEF.md。
限制:资料未提供收费、价格、平台支持范围等信息。