用途:运行交互式 QA 会话。用户用自己的语言描述遇到的问题,代理进行澄清、在后台探索代码库获取上下文,并提交持久化、以用户为中心、使用项目领域语言的 GitHub issue。
主要能力:
- 倾听并轻微澄清:让用户描述问题,最多问 2-3 个简短澄清问题,关注预期与实际、重现步骤、是否一致或间歇出现;描述足够清晰即继续,不过度询问。
- 后台探索代码库:与用户交谈时启动 Explore 子代理理解相关区域,学习领域语言(检查 UBIQUITOUS_LANGUAGE.md)、理解功能应做什么、识别面向用户的行为边界;issue 本身不引用文件、行号或内部实现细节。
- 评估范围:判断是单个 issue 还是需拆分。涉及多个独立区域、可分离关注点、多个不同失败模式或症状时拆分;一个地方一个行为出错、所有症状同源时保持单个。
- 提交 GitHub issue:使用 gh issue create 创建,不先要求用户审查,直接提交并分享 URL。单个 issue 模板含“发生了什么”“我的预期”“重现步骤”“附加上下文”。拆分时按依赖顺序创建(阻塞项优先),子 issue 模板含“父 issue”“什么问题”“我的预期”“重现步骤”“阻塞于”“附加上下文”。优先多个薄 issue,诚实标记阻塞关系,最大化并行性。
- 继续会话:提交后打印所有 issue URL 并总结阻塞关系,询问“下一个 issue,还是我们完成了?”,持续到用户说完成,每个 issue 独立处理,不批量。
所有 issue 正文规则:无文件路径或行号;使用项目领域语言;描述行为而非代码;重现步骤必需,无法确定时询问用户;保持简洁,30 秒内可读完。
适用场景:用户想报告 bug、进行 QA、以对话方式提交 issue 或提到“QA 会话”时。
限制:资料未提供具体安装方式、依赖版本、平台支持或收费信息。