用途:把一份父级 PRD 拆成一组扁平、按执行顺序排列的原生 GitHub 子议题。每个子议题是一个 tracer-bullet 垂直切片,供 PRD 模式的 agent:implement 工作流逐个拾取实现。
主要能力与流程:
- 获取 PRD:gh issue view <PRD_NUMBER> --comments,把 PRD 当作规格,不擅自扩大范围或重新设计;有歧义先向用户澄清。
- 确认无既有子议题:gh api repos/$GH_REPO/issues/<PRD_NUMBER>/sub_issues --jq 'length',非零则停下询问是中止、追加还是先关闭/删除,不静默重复。
- 可选探索代码库,使用项目术语表 GLOSSARY.md 并遵守 docs/adr/ 下的 ADR,寻找预重构机会。
- 起草垂直切片:每个切片贯穿 schema→API→UI→测试各层,而非单层水平切片;需能在单个会话内独立完成,不依赖前一会话的状态。
- 向用户确认:以编号列表展示标题、构建内容、依赖项,询问粒度、顺序、是否合并/拆分/删除,迭代至批准。
- 发布:按顺序 gh issue create 创建议题,用 gh api repos/$GH_REPO/issues/<sub_issue_number> --jq '.id' 取整数 ID,再 gh api -X POST "repos/$GH_REPO/issues/<PRD_NUMBER>/sub_issues" -f sub_issue_id=<sub_issue_id> 挂为子议题。不要给子议题打 agent:implement 标签。
- 子议题正文模板含 What to build、Acceptance criteria、Depends on,不含 Closes 指令。
适用场景:已有 PRD 议题、希望由智能体按顺序实现的项目。
限制:依赖 gh CLI 与 GitHub 原生子议题 API;子议题顺序决定执行顺序,可在 UI 拖动或调用 PATCH /repos/{owner}/{repo}/issues/{issue_number}/sub_issues/priority 调整;具体收费、平台支持等资料暂未提供。