prd-to-issues

SKILL.md

PRD 转 Issues

使用 tracer-bullet(示踪子弹/纵向切片)方法,把 PRD 拆分成彼此独立、可以直接认领的 GitHub issues。

过程

1. 定位 PRD

请向用户索要 PRD 的 GitHub issue 编号(或 URL)。

如果 PRD 还不在你的上下文窗口中,可以用 gh issue view <number> 获取(带 comments)。

2. 探索代码库(可选)

如果你还没有探索代码库,为了理解现状,你可以先探索代码库。

3. 起草竖向切片

把 PRD 拆成 tracer bullet issues。每个 issue 都是一条足够薄的“贯穿式竖向切片(vertical slice)”:它要切穿所有集成层(schema、API、UI、tests),而不是只对某一层做横向拆分。

切片可能是:

  • HITL:需要人类参与(例如需要做出架构决策或设计评审)
  • AFK:无需人类参与,可以直接实现并合并

优先使用 AFK,尽可能减少 HITL

4. 让用户“投票确认”

把你建议的拆分结果以“编号列表”的形式呈现。对每个切片,展示:

  • Title:短而有描述性的标题
  • Type:HITL / AFK
  • Blocked by:哪些切片需要先完成(如有)
  • User stories covered:覆盖了 PRD 中哪些用户故事

然后提问让用户确认:

  • 切片的粒度是否合适?(太粗 / 太细)
  • 依赖关系是否正确?
  • 是否正确标注了 HITL 和 AFK?

根据用户反馈,反复迭代直到用户认可拆分结果。

5. 创建 GitHub issues

对于每个已批准的切片,使用 gh issue create 创建 GitHub issue。并使用如下 issue body 模板。

按依赖顺序创建 issues(先创建 blockers),这样你在 “Blocked by” 字段里就能引用到真实的 issue 编号。

#

要构建什么(What to build)

对该竖向切片的简洁描述。描述端到端的最终行为,而不是按层逐一解释实现方式。应引用父级 PRD 的具体章节,而不是重复父级 PRD 的内容。

验收标准(Acceptance criteria)

  • Criterion 1
  • Criterion 2
  • Criterion 3

被哪些项阻塞(Blocked by)

  • Blocked by #(如有)

若无阻塞,则写:None - can start immediately

涉及哪些用户故事(User stories addressed)

按父级 PRD 中的编号引用:

  • User story 3
  • User story 7

不要关闭或修改父级 PRD issue。

Weekly Installs
2
GitHub Stars
135
First Seen
10 days ago
Installed on
amp2
cline2
opencode2
cursor2
kimi-cli2
warp2