1.7 KiB
1.7 KiB
PRD 编写规范
1. 定位
PRD 是每个业务功能的产品需求事实来源,回答“为谁解决什么问题、为什么做、做到什么程度算完成”。技术设计回答“如何实现”,不能替代 PRD。
治理、重构和纯技术任务也需要简化 PRD,用于说明使用者、治理问题、目标和完成标准。
2. 必备章节
每份 prd.md 至少包含:
- 文档信息:功能编号、版本、状态、作者、日期。
- 背景与问题:当前状态、具体问题和证据。
- 目标用户与场景:谁在什么时点使用。
- 产品目标:用户能够完成什么,产品改善什么。
- 非目标:本期明确不解决什么。
- 用户流程:入口、关键步骤、结果和异常路径。
- 功能需求:编号、优先级、行为与可观察结果。
- 数据与口径:来源、时效、单位、缺失和过期处理。
- 状态与异常:加载、空、部分数据、错误和降级。
- 权限与合规:访问边界、隐私、声明和安全限制。
- 成功指标:可以观测和验证的产品指标。
- 验收标准:使用 Given/When/Then 或等价可测试描述。
- 风险与依赖:外部数据、技术、成本和上线依赖。
- 发布范围:本次、后续和回退触发条件。
3. 编写规则
- 需求使用
FR-001等稳定编号,测试和 Review引用该编号。 - 禁止用“体验更好”“速度较快”等不可验证表达。
- UI 布局不是需求本身;应先写用户需要识别和完成的行为。
- PRD 发生实质变化时更新版本和变更记录,并重新确认设计与测试影响。
- 已发布 PRD 不删除旧结论,废弃需求标记
superseded并说明替代项。