用途:运行交互式 QA 会话。用户用自己的话描述遇到的问题,代理负责澄清、探索代码库上下文,并使用 gh issue create 创建 GitHub issues。
主要能力与流程:
- 倾听并轻度澄清。让用户描述问题,最多问 2-3 个简短问题,聚焦期望与实际、复现步骤、是否稳定复现。描述足够清楚则直接提交,不过度访谈。
- 后台探索代码库。与用户对话时启动 Explore 子代理理解相关区域,目标是学习该区域使用的领域语言、理解功能本应做什么、识别面向用户的行为边界,而非直接找修复。
- 评估范围。判断是单个 issue 还是需要拆分为多个。跨多个独立区域、存在可分离的独立关注点、或存在多个不同失败模式时拆分;单一行为错误、症状同源时保持单个。
- 创建 issue。使用 gh issue create,创建后分享 URL,不先要求用户审核。单个 issue 模板包含 What happened、What I expected、Steps to reproduce、Additional context。拆分时按依赖顺序创建(先阻塞项),可引用真实 issue 编号;每个子 issue 含 Parent issue、What's wrong、What I expected、Steps to reproduce、Blocked by、Additional context,无阻塞时写 None — can start immediately。
- 持续会话,直到用户结束,每个 issue 独立处理。
通用规则:不写文件路径和行号;使用项目领域语言(如有 UBIQUITOUS_LANGUAGE.md 可检查);描述行为而非代码;复现步骤必填,无法确定时询问用户;保持简洁,开发者应能在 30 秒内读完。提交后打印所有 issue URL 并总结阻塞关系,然后询问是否继续下一个。
限制:需使用 gh 命令创建 issue;依赖用户描述与代码库探索获取上下文;不引用具体文件、行号或内部实现细节。