pm-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格式时"]

PRD 编写指南

适用场景

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

PRD 标准结构

1. 概述

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

摘要

下游 Agent 请优先阅读本节，需要细节时再查阅完整文档。

• 核心目标：[用一句话描述]
• 目标用户：[主要用户群体]
• 关键功能：[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不是功能的堆砌，而是对用户需求的精准洞察和优雅满足。