# To Prd

> 生成产品需求文档(PRD)— 含用户故事、功能需求、非功能需求、验收标准。需将产品需求正式化、向设计与开发团队交接时调用本 skill,输出三格式产物(源 / HTML / DOCX)。

- Skill: `blueprintos/to-prd` (Agent Skill)
- Install (CLI): `npx skillmds@latest add blueprintos/to-prd`
- Raw SKILL.md: https://api.skillmd.com/api/skills/blueprintos/to-prd/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: BlueprintOS (https://skillmd.com/u/blueprintos)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/blueprintos/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 异常处理表格必填(异常/提示/处理 三列)
- ❌ §八 风险与依赖无缓解措施 — 每条风险必须配缓解 + 责任方