产品需求文档 (PRD)

概述

设计全面、可投入生产的产品需求文档 (PRD)，弥合业务愿景与技术实现之间的鸿沟。本技能适用于现代软件系统，确保需求的明确定义。

何时使用

在以下情况使用本技能：

• 开始一个新的产品或功能开发周期
• 将一个模糊的想法转化为具体的技术规范
• 为基于人工智能的功能定义需求
• 利益相关者需要为项目范围建立统一的”唯一真实来源”
• 用户要求”写一个 PRD”、”记录需求”或”规划一个功能”

操作流程

阶段 1：探索（访谈）

在撰写 PRD 的任何一个字之前，你必须询问用户以填补知识空白。不要假设上下文。

询问内容：

• 核心问题：我们现在为什么要构建这个？
• 成功指标：我们如何知道它成功了？
• 限制条件：预算、技术栈或截止日期？

阶段 2：分析与范围界定

综合用户的输入。识别依赖关系和隐藏的复杂性。

• 绘制用户流程图。
• 定义非目标以保护项目时间线。

阶段 3：技术文档起草

使用下面的严格 PRD 模式生成文档。

PRD 质量标准

需求质量

使用具体、可衡量的标准。避免使用”快速”、”容易”或”直观”等词。

# 模糊（不好的例子）
- 搜索应该很快，并返回相关结果。
- 用户界面必须看起来现代且易于使用。

# 具体（好的例子）
+ 对于 1 万条记录的数据集，搜索必须在 200 毫秒内返回结果。
+ 搜索算法在基准评估中必须达到 >= 85% 的 Precision@10。
+ 用户界面必须遵循 'Vercel/Next.js' 设计系统，并达到 100% 的 Lighthouse 可访问性得分。

严格 PRD 模式

你必须为输出遵循以下精确结构：

1. 执行摘要

• 问题陈述：用 1-2 句话描述痛点。
• 提议解决方案：用 1-2 句话描述解决方案。
• 成功标准：3-5 个可衡量的关键绩效指标。

2. 用户体验与功能

• 用户角色：这是为谁设计的？
• 用户故事：作为[用户]，我想要[执行操作]，以便[获得好处]。
• 验收标准：每个故事的”完成”定义的要点列表。
• 非目标：我们不构建什么？

3. 人工智能系统需求（如适用）

• 工具需求：需要哪些工具和应用程序编程接口？
• 评估策略：如何衡量输出质量和准确性。

4. 技术规范

• 架构概述：数据流和组件交互。
• 集成点：应用程序编程接口、数据库和身份验证。
• 安全与隐私：数据处理和合规性。

5. 风险与路线图

• 分阶段发布：最小可行产品 -> v1.1 -> v2.0。
• 技术风险：延迟、成本或依赖项故障。

实施指南

要做的（始终）

• 定义测试：对于人工智能系统，具体说明如何测试和验证输出质量。
• 迭代：提交草案并就特定部分征求反馈。

不要做的（避免）

• 跳过探索阶段：在未先提出至少 2 个澄清问题之前，绝不编写 PRD。
• 凭空捏造限制条件：如果用户未指定技术栈，询问或将其标记为 待定。

示例：智能搜索系统

1. 执行摘要

问题：用户在庞大的代码仓库中难以找到特定的文档片段。
解决方案：一个智能搜索系统，能提供带有来源引用的直接答案。
成功标准：

• 将搜索时间减少 50%。
• 引用准确率 >= 95%。

2. 用户故事

• 故事：作为一名开发者，我想要用自然语言提问，这样我就不必猜测关键词了。
• 验收标准：
  • 支持多轮澄清。
  • 返回带有”复制”按钮的代码块。

3. 人工智能系统架构

• 所需工具：codesearch， grep， webfetch。

4. 评估

• 基准测试：用 50 个常见的开发者问题进行测试。
• 通过率：90% 的问题必须匹配预期的引用。