SuperAPI AI 工具集

to-issues

编程与开发

查看项目

更新于 10-15 20:10

技能介绍

用途:把计划、规格或 PRD 转换为项目 issue tracker 上可独立认领的 issue,采用 tracer bullet 垂直切片方式,每个切片端到端贯穿所有集成层,而非只覆盖某一层的横向切片。

必要前提:issue tracker 需可通过 gh 访问。若需要标签词表,请查看项目的 AGENTS.md 或 issue 模板。

使用流程:

  1. 收集上下文。基于对话中已有内容工作;若用户以参数传入 issue 引用(issue 编号、URL 或路径),则从 issue tracker 获取并阅读其正文与评论。
  2. 探索代码库(可选)。如尚未探索代码库,则先了解代码现状。issue 标题和描述应使用项目的领域词汇表,并遵守所涉区域的 ADR。
  3. 草拟垂直切片。将计划拆成 tracer bullet issue。切片可标记为 HITL 或 AFK:HITL 需要人工交互,如架构决策或设计评审;AFK 无需人工交互即可实现并合并。尽量优先 AFK。
  4. 向用户确认。以编号列表展示拆分方案,每项显示:标题(简短描述性名称)、类型(HITL/AFK)、被谁阻塞(需先完成的切片)、覆盖的用户故事(若源材料含用户故事)。并向用户询问:粒度是否合适、依赖关系是否正确、是否有切片需合并或进一步拆分、HITL 与 AFK 标记是否正确,迭代直至用户批准。
  5. 发布 issue。对每个已批准的切片,按下方正文模板在 issue tracker 发布新 issue,并应用 needs-triage 分类标签。按依赖顺序发布(阻塞者优先),以便在“Blocked by”字段引用真实 issue 标识。

issue 正文包含:父 issue 引用(若来源为已有 issue,否则省略该部分)、What to build(该垂直切片的简要描述,描述端到端行为而非逐层实现)、Acceptance criteria(验收标准列表)、Blocked by(阻塞工单引用,若无则写 “None - can start immediately”)。

限制:不要关闭或修改任何父 issue。