SuperAPI AI 工具集

qa-to-issues

编程与开发

查看项目

更新于 10-16 05:45

技能介绍

用途:运行一次交互式 QA 会话。用户以对话方式描述遇到的问题,智能体负责澄清、在后台探索代码库获取上下文,并创建持久、面向用户、使用项目领域语言的 GitHub issue。适用于用户想为自己项目报告 bug 的场景。

主要能力与流程:

  1. 倾听并轻度澄清:让用户用自己的话描述问题,最多问 2-3 个简短问题,聚焦预期与实际行为、复现步骤、是否稳定复现;描述足够清楚就直接进入下一步,不过度追问。
  2. 后台探索代码库:在对话同时启动 Explore 子智能体了解相关区域,目的是学习该区域的领域语言(可查 UBIQUITOUS_LANGUAGE.md)、理解功能应有行为、识别面向用户的行为边界;issue 本身不应引用具体文件、行号或内部实现细节。
  3. 评估范围:判断是单个 issue 还是需要拆分。当修复跨越多个独立区域、存在可分离的关注点、或用户描述包含多个不同失败模式时拆分;当只是单一位置的一个行为错误、症状同源时保持单个 issue。
  4. 创建 GitHub issue:使用 gh issue create,不先让用户审阅,直接创建并分享 URL。单个 issue 模板包含 What happened、What I expected、Steps to reproduce、Additional context。拆分时按依赖顺序创建(阻塞项优先),每个子 issue 模板包含 Parent issue、What's wrong、What I expected、Steps to reproduce、Blocked by、Additional context;优先多而薄的 issue,每个可独立修复和验证,如实标注阻塞关系,最大化并行。
  5. 继续会话:直到用户表示结束,每个 issue 独立处理,不批量合并。

所有 issue 正文规则:不写文件路径或行号(会过时);使用项目领域语言;描述行为而非代码;复现步骤必填,无法确定时询问用户;保持简洁,开发者应能在 30 秒内读完。创建后打印所有 issue URL 并汇总阻塞关系,询问“下一个 issue,还是结束?”。

限制:资料未提供具体安装方式、收费、价格、支持平台或效果数据。