用途:运行一次交互式 QA 会话。用户用自己的话描述遇到的问题,AI 进行轻度澄清、在后台探索代码库获取上下文,并提交持久的、以用户为中心、使用项目领域语言的 GitHub issue。适用于用户想报告 bug、做 QA、以对话方式提交 issue 或提到“QA session”的场景。
每个问题的处理流程:1)听取并轻度澄清,最多问 2-3 个简短问题,聚焦期望与实际行为的差异、复现步骤、是否稳定复现;描述足够清晰就直接提交,不要过度访谈。2)在对话同时启动 Agent(subagent_type=Explore)在后台了解相关区域,目的是了解该区域的领域语言(可查看 UBIQUITOUS_LANGUAGE.md)、功能应做什么以及面向用户的行为边界;issue 本身不应引用具体文件、行号或内部实现细节。3)评估范围:若修复涉及多个独立区域、有可分离的关注点或存在多种失败模式,则拆分为多个问题;若只是一个地方的一个行为出错且症状同源,则保持单个问题。4)用 gh issue create 提交,不请求用户预先审查,直接提交并分享 URL;issue 需保持持久、从用户角度编写,单个问题模板包含 What happened、What I expected、Steps to reproduce、Additional context。拆分时按依赖顺序创建(先创建阻塞项)以便引用真实编号,每个子问题模板含 Parent issue、What's wrong、What I expected、Steps to reproduce、Blocked by、Additional context;优先多个薄 issue,诚实标记阻塞关系,最大化并行性。
正文规则:不含文件路径或行号;使用项目领域语言;描述行为而非代码;复现步骤必需,无法确定时询问用户;保持简洁,开发者应在 30 秒内读完。提交后打印所有 issue URL(附阻塞关系摘要)并询问“下一个问题,还是结束了?”。持续进行直至用户说结束,每个 issue 独立,不要批量处理。