用途
这是一个交互式 QA 会话技能。用户以对话方式报告遇到的 bug 或问题,代理负责澄清、在后台探索代码库获取上下文,并创建持久、以用户为中心、使用项目领域语言的 GitHub issue。
主要能力
- 以对话方式接收用户报告的问题,进行轻量澄清(最多 2-3 个简短问题,聚焦于预期与实际行为、复现步骤、问题是否稳定复现)。
- 在对话的同时,后台启动 Explore 子代理理解相关区域,目的是学习该区域的领域语言(检查 UBIQUITOUS_LANGUAGE.md)、理解功能预期行为、识别面向用户的行为边界。
- 评估问题范围:判断应作为单个 issue 还是拆分为多个 issue。当修复跨越多个独立区域、存在可分离的关注点、或用户描述包含多个不同失败模式时进行拆分;当是单一位置的一个行为错误、症状由同一根因导致时保持单个 issue。
- 使用 gh issue create 创建 GitHub issue,不要求用户先审阅,直接创建并分享 URL。
- 支持单个 issue 模板和拆分(多个 issue)模板,拆分时按依赖顺序创建(阻塞项优先),以便引用真实 issue 编号。
- 拆分时倾向于多个薄 issue 而非少数厚 issue,每个应可独立修复和验证;如实标记阻塞关系;最大化并行性。
- 所有 issue 正文规则:不包含文件路径或行号;使用项目领域语言;描述行为而非代码;复现步骤为必填;保持简洁(开发者应能在 30 秒内读完)。
- 创建后打印所有 issue URL(并总结阻塞关系),询问“下一个 issue,还是结束了?”
- 持续会话直到用户表示完成,每个 issue 独立处理,不批量处理。
使用方式
用户以对话方式描述问题,代理进行澄清并在后台探索代码库,然后自动创建 GitHub issue。创建使用 gh issue create 命令。
适用场景
适用于需要将用户反馈快速转化为可追踪、可并行处理的 GitHub issue 的团队或项目。
限制
- 需要 GitHub CLI(gh)环境以创建 issue。
- issue 不引用具体文件、行号或内部实现细节。
- 复现步骤为必填,若无法确定需询问用户。
- 其他具体限制暂未提供。