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