SuperAPI AI 工具集

plan-to-issues

编程与开发

查看项目

更新于 10-16 02:35

技能介绍

用途:把实现计划(本地 ./plans/*.md 文件,由 prd-to-plan 产出)拆分为可独立领取的 GitHub issue,采用垂直切片(tracer bullet)方式。计划本身是技术设计文档,其中的架构决策(数据模型、schema 形状、API 契约、模块边界)属于持久约束,用户故事与验收标准作为素材。

流程:

  1. 定位计划。若对话中已有计划文件则直接使用,否则询问路径,优先查看 ./plans/。通读并提取:技术设计决策(数据模型、schema、API 契约、模块边界、路由)、来源 PRD 链接或标识、各阶段的用户故事与验收标准。若技术设计单薄,应告知用户可能需要先跑一次 prd-to-plan。
  2. 探索代码库(可选),了解现状及技术决策与现有结构的对应关系。
  3. 起草垂直切片。每个 issue 是贯穿所有集成层、端到端的薄垂直切片,而非单一层的水平切片。可自由重新划分,不必与计划阶段一一对应。切片可为 HITL 或 AFK:HITL 需人工介入(如架构决策、设计评审),AFK 可无人工实现并合并,尽量优先 AFK。
  4. 询问用户。以编号列表展示拆分,每项含标题、类型、被谁阻塞、覆盖的计划阶段/用户故事。询问粒度是否合适、依赖关系是否正确、是否需合并或拆分、HITL/AFK 标记是否正确,迭代至用户认可。
  5. 创建 GitHub issue。对每个获批切片使用 gh issue create,按依赖顺序创建(阻塞项在前)以便引用真实编号。正文模板包含:计划文件路径、来源 PRD 链接、要构建的内容(端到端技术行为,引用计划章节而非复制)、验收标准、被谁阻塞(无则写 None - can start immediately)、涉及的用户故事编号。不要修改源计划文件。

限制:需本地存在计划文件与 gh 工具;技术设计不足时需先补充;HITL 切片依赖人工;具体命令参数与模板细节以原始资料为准。