To prd

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 异常处理表格必填(异常/提示/处理 三列)
• ❌ §八 风险与依赖无缓解措施 — 每条风险必须配缓解 + 责任方