/prd-writing

name: pm/prd-writing
description: 产品需求文档(PRD)的标准编写格式和内容要求，确保输出完整、清晰、可执行的产品文档
version: 1.0.0
agent: pm
type: guideline
user-invocable: false
agent-invocable: true
dependencies:
- pm/requirement-penetration
  triggers:
- 需求分析完成，准备输出PRD时
- 需要标准化PRD格式时
  metadata:
  internal: true

PRD 编写指南

适用场景

完成需求穿透和调研分析后，需要输出一份完整的产品需求文档(PRD)，供设计师、开发者、测试人员使用。

PRD 标准结构

1. 概述

• **功能名称**：[清晰简洁的名称]
• **版本**：1.0
• **日期**：[当前日期]
• **作者**：PM Agent

摘要

> 下游 Agent 请优先阅读本节，需要细节时再查阅完整文档。 > > **注意**：在实际 PRD 产物中，本节必须是 `## 摘要`（H2），位于文档标题之后、所有其他章节之前，与 `templates/prd.md.template` 一致。

• **核心目标**：[用一句话描述]
• **目标用户**：[主要用户群体]
• **关键功能**：[3-5 个最核心功能]
• **技术约束**：[重要约束或偏好]
• **优先级**：[MVP 范围说明]

---

2. 需求穿透分析（核心章节）

参见 `pm/requirement-penetration` skill 的输出要求。

---

3. 竞品调研

3.1 竞品分析

使用 `WebSearch` 搜索相关竞品：

| 竞品 | 核心功能 | 用户体验亮点 | 用户痛点 | 我们的机会 | | -------- | -------- | ------------ | -------- | ---------- | | [竞品 1] | [功能] | [亮点] | [痛点] | [机会] | | [竞品 2] | [功能] | [亮点] | [痛点] | [机会] | | [竞品 3] | [功能] | [亮点] | [痛点] | [机会] |

3.2 差异化策略

| 维度 | 竞品做法 | 我们的做法 | 差异化价值 | | -------- | -------- | ---------- | ---------- | | [维度 1] | [做法] | [做法] | [价值] | | [维度 2] | [做法] | [做法] | [价值] |

---

4. 目标用户

用户画像 1：[名称]

• **基本特征**：[年龄、职业、收入等]
• **行为特征**：[使用习惯、偏好等]
• **核心需求**：[最想解决的问题]
• **痛点场景**：[具体的痛苦场景描述]
• **期望体验**：[理想的体验是什么样]

用户旅程图

journey
    title 用户完成核心任务的旅程
    section 发现阶段
      了解产品: 3: 用户
      产生兴趣: 4: 用户
    section 使用阶段
      首次使用: 3: 用户
      完成任务: 5: 用户
    section 留存阶段
      持续使用: 4: 用户
      推荐他人: 5: 用户

---

5. 功能需求

FR-001：[需求标题]

• **需求描述**：[清晰的需求描述]
• **用户价值**：[这个功能给用户带来什么价值]
• **优先级**：P0/P1/P2
• **需求来源**：显性/隐性/潜在/惊喜
• **验收标准**：
• [ ] AC-1：[可测试的标准 1]
• [ ] AC-2：[可测试的标准 2]
• **边界情况**：
• [边界情况 1 及处理方式]
• [边界情况 2 及处理方式]

FR-002：[需求标题]

• **需求描述**：[描述]
• **用户价值**：[价值]
• **优先级**：P1
• **需求来源**：[来源]
• **验收标准**：
• [ ] AC-1：[标准]

---

6. 非功能需求

NFR-001：性能需求

• **页面加载**：首屏加载 < 2s，完整加载 < 3s
• **交互响应**：用户操作响应 < 100ms
• **API 响应**：接口响应 < 200ms

NFR-002：体验需求

• **易用性**：新用户无需教程即可完成核心任务
• **一致性**：交互模式和视觉风格保持一致
• **容错性**：操作可撤销，错误可恢复

NFR-003：安全需求

• **数据安全**：敏感数据加密存储和传输
• **隐私保护**：符合相关隐私法规

---

7. 用户故事

US-001：[故事标题]

• **作为** [用户类型]
• **我想要** [目标行为]
• **以便** [预期价值]
• **验收标准**：
• [ ] [标准 1]
• [ ] [标准 2]
• **优先级**：P0

US-002：[故事标题]

• **作为** [用户类型]
• **我想要** [目标行为]
• **以便** [预期价值]
• **验收标准**：
• [ ] [标准]
• **优先级**：P1

---

8. 成功指标

| 指标类型 | 指标 | 目标值 | 衡量方式 | | -------- | ------ | ------ | -------- | | 核心指标 | [指标] | [目标] | [方式] | | 体验指标 | [指标] | [目标] | [方式] | | 业务指标 | [指标] | [目标] | [方式] |

---

9. 范围定义

本期范围（In Scope）

• [功能 1]
• [功能 2]

范围外（Out of Scope）

• [排除项 1]：[排除原因]
• [排除项 2]：[排除原因]

---

10. 风险与依赖

风险登记

| 风险 | 可能性 | 影响 | 缓解措施 | | ------ | -------- | -------- | -------- | | [风险] | 高/中/低 | 高/中/低 | [措施] |

依赖项

| 依赖 | 类型 | 状态 | 负责人 | | -------- | -------------- | ----------- | -------- | | [依赖项] | 技术/业务/外部 | 已就绪/待定 | [负责人] |

---

11. 里程碑

| 里程碑 | 内容 | 目标日期 | | ------ | ---------- | -------- | | MVP | [核心功能] | - | | V1.0 | [完整功能] | - | | V1.1 | [优化迭代] | - |

---

编写原则

清晰性

• 使用简单直接的语言
• 避免模糊词汇（"可能"、"大概"、"尽量"）
• 每个需求都有明确的验收标准

完整性

• 覆盖所有必要章节
• 功能需求和非功能需求都要考虑
• 边界情况和异常处理要说明

可执行性

• 设计师能根据PRD设计界面
• 开发者能根据PRD编写代码
• 测试人员能根据PRD编写测试用例

用户导向

• 每个功能都说明用户价值
• 从用户视角描述需求
• 关注用户体验细节

输出要求

1. **文件命名**：`prd-{功能名称}-{日期}.md` 2. **文件位置**：项目根目录或 `docs/` 目录 3. **格式**：Markdown格式，使用标准的章节结构 4. **长度**：根据功能复杂度，通常5-20页

质量检查清单

在输出PRD前，检查以下项目：

• [ ] 摘要部分是否清晰，能让读者快速理解核心内容
• [ ] 需求穿透分析是否完整（显性、隐性、潜在、惊喜四层）
• [ ] 每个功能需求是否有明确的验收标准
• [ ] 非功能需求是否考虑（性能、体验、安全）
• [ ] 用户故事是否符合 "作为-我想要-以便" 格式
• [ ] 范围定义是否明确（In Scope 和 Out of Scope）
• [ ] 风险和依赖是否识别
• [ ] 文档格式是否规范，易于阅读

---

**记住**：好的PRD不是功能的堆砌，而是对用户需求的精准洞察和优雅满足。