mcpField
P
prd-to-issues

prd-to-issues

github.com/mattpocock开发229250 次安装30 周前更新
代码仓库

关于 prd-to-issues

prd-to-issues 可将 PRD 拆分为端到端、可独立实施的事项,并保存为本地 Markdown 文件。它会先协助团队审查范围与依赖关系,再创建文件,侧重纵向切片而非按层拆分。

主要功能

  1. 01将 PRD 拆成端到端纵向切片
  2. 02标记 HITL 或 AFK 类型
  3. 03与用户审查范围和依赖关系
  4. 04创建带编号的 Markdown 事项文件
  5. 05使用本地文件而非 GitHub 事项互相引用

适用场景

  1. 01根据 PRD 规划实施工作
  2. 02创建文件前检查事项依赖
  3. 03将工作整理为可独立验证的切片

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mattpocock/ai-engineer-workshop-2026-project --skill prd-to-issues

安装后在 Claude Code 中输入/prd-to-issues确认已加载。

详细介绍

将 PRD 拆分为问题

使用垂直切片(示踪弹)将 PRD 拆分为可独立领取的问题,并将其写入本地 Markdown 文件。

流程

1. 找到 PRD

请用户提供 PRD 文件路径(例如 issues/prd.md)。

如果当前上下文中没有 PRD,请从文件中读取。

2. 探索代码库(可选)

如果尚未探索代码库,请先了解当前代码状态。

3. 起草垂直切片

将 PRD 拆分为示踪弹问题。每个问题都是一个精简的垂直切片,端到端贯穿所有集成层,而不是只涉及某一层的水平切片。

切片可以是“HITL”或“AFK”。HITL 切片需要人工参与,例如做出架构决策或进行设计评审。AFK 切片可以在无需人工参与的情况下完成实现并合并。尽可能优先选择 AFK,而非 HITL。

- 每个切片都应贯穿所有层(架构、API、UI、测试),交付一条范围精简但完整的路径 - 完成的切片应可独立演示或验证 - 优先选择多个精简切片,而不是少数几个庞大切片
4. 向用户确认

以编号列表的形式展示拟议的拆分方案。对每个切片,列出:

  • 标题:简短的描述性名称
  • 类型:HITL / AFK
  • 阻塞项:必须先完成的其他切片(如有)
  • 涵盖的用户故事:该切片对应 PRD 中的哪些用户故事

询问用户:

  • 粒度是否合适?(太粗 / 太细)
  • 依赖关系是否正确?
  • 是否应合并某些切片或进一步拆分?
  • 哪些切片标记为 HITL 和 AFK 是否正确?

与用户反复迭代,直到用户批准拆分方案。

5. 创建问题文件

为每个获批的切片,在 issues/ 中创建一个 Markdown 文件,命名格式为 issues/NNN-short-title.md(例如 issues/001-add-user-auth.md)。

问题编号从下一个可用编号开始(检查 issues/ 中已有的文件)。

按照依赖顺序创建文件(先创建阻塞项),以便在“阻塞项”字段中引用实际文件名。

不要使用 gh issue create 或任何 GitHub CLI 命令。不要引用 GitHub 问题编号。所有交叉引用均使用本地文件名。

## 父 PRD

issues/prd.md(或实际使用的 PRD 文件)

构建内容

简明描述此垂直切片。描述端到端行为,而不是逐层说明实现方式。请引用父 PRD 中的具体章节,而不是重复其中的内容。

验收标准

  • 标准 1
  • 标准 2
  • 标准 3

阻塞项

  • 被 issues/NNN-title.md 阻塞(如有)

或“无——可立即开始”(如果没有阻塞项)。

涉及的用户故事

引用父 PRD 中的用户故事编号:

  • 用户故事 3
  • 用户故事 7

不要关闭或修改父 PRD 文件。

评论

支持 Markdown