/to-prd

name: to-prd
description: 生成产品需求文档(PRD)— 含用户故事、功能需求、非功能需求、验收标准。需将产品需求正式化、向设计与开发团队交接时调用本 skill,输出三格式产物(源 / HTML / DOCX)。
disable-model-invocation: true
version: 4.0.0
requires: [no-field-guessing, doc-numbering, stage-gate]

To-PRD — 产品需求文档生成

Contract

• 输入: 已签字的 BRD、合规评审、测试用例、字段对齐分析
• 输出: `05-产品需求文档 PRD.md`、可选 `05-PRD.html`、可选 `05-PRD.docx`、可选 Figma 设计文档
• 门控: PRD 必备章节齐全;验收标准已签字;字段映射与知识库核对
• Required rules: `stage-gate`, `no-field-guessing`, `doc-numbering`, `goal-boundary`
• Required paths: `knowledge-path`, `doc-naming-path`
• 下一步: `/dev-design`

适用场景

• BRD + 合规评审 + 测试用例已通过
• 需要把业务需求翻译成产品视角
• 设计/开发团队需要可执行的需求输入

流程步骤

1. 加载模板

• `templates/PRD.md`(8 节必备章节)

2. 三格式输出

| 格式 | 用途 | 生成方式 | |---|---|---| | Markdown | 源文件、版本管理 | 手工编写 | | HTML | 浏览器阅读、分享 | pandoc + `scripts/postprocess_prd_html.py` | | DOCX | Word 阅读、批注 | pandoc |

3. 填充内容

按 PRD 模板逐节生成:

| 章节 | 内容来源 | |---|---| | 一、产品概述 | BRD §1 | | 二、用户故事 | BRD §2 角色 + 业务场景 | | 三、功能需求 | BRD §4 + 测试用例(用作验收) | | 四、非功能需求 | BRD §7 | | 五、数据需求 | BRD §5 + 字段对齐分析 | | 六、合规要求 | 04-合规评审.md | | 七、验收标准 | 07-测试用例设计.md | | 八、风险与依赖 | BRD §8 |

4. 关键纪律

• **字段名必须与知识库定义一致**
• 业务同义不同名需在 PRD 注释中**显式标注**("业务上称为 X = 知识库定义的 Y")
• 严禁自行发明字段
• 用户故事格式:`As an <actor>, I want a <feature>, so that <benefit>`

5. Figma 设计文档引用(如适用)

• 简单需求(加字段/调规则)→ 跳过
• 中等需求(新增功能/页面改造)→ 需要 Figma 文档
• 复杂需求(跨模块/多角色/算法介入)→ 必须 Figma 文档

输出

• `05-PRD.md`(Markdown 源)
• `05-PRD.html`(可选,后处理)
• `05-PRD.docx`(可选)
• `Figma设计文档_{功能名}_{端}.md`(可选,不受编号约束)

调用的 rule

• `rules/no-field-guessing` — 字段名必须查知识库
• `rules/doc-numbering` — 文档编号 05

结束条件

• [ ] PRD 8 个必备章节齐
• [ ] §七 验收标准签字
• [ ] 字段映射表通过 `field-alignment-check.py`
• [ ] 三格式产物存在(可选 HTML/DOCX)
• [ ] 用户签字进入 `/dev-design`

反模式

• ❌ PRD 8 章节缺一 — `prd-check.py --strict` 直接 fail(一~八必须齐)
• ❌ §七 验收标准未被白名单签字 — 必须 4 句之一(我已全部确认,可以进入下一步 / 确认通过,进入 dev-design / 全部完成,继续 / approved, proceed to next stage)
• ❌ §二 用户故事只列 P0 — P0/P1/P2 三档必须都有,否则后续排期无法决策
• ❌ §五 数据需求不引用 03-数据模型设计 — 必须明确"参考 03-数据模型设计.md §X"
• ❌ §六 合规要求不引用 04-合规评审 — 必须明确"参考 04-合规评审.md §X"
• ❌ §三 功能需求跳过异常处理 — 3.1.X 异常处理表格必填(异常/提示/处理 三列)
• ❌ §八 风险与依赖无缓解措施 — 每条风险必须配缓解 + 责任方