Skip to content
返回架构决策

PRD 版本管理

开工后如何处理 PRD 变更而不静默改规格。

为什么

工程一旦按 PRD 开工,规格任何变更都是契约变更。迭代中静默改 PRD 意味着工程师对着不再匹配所议的规格造,验收标准漂移无人察觉。版本管理——升 PRD 版本并记录改了什么、为什么——保持审计链完整。功能上线后有人问"为什么造了 X 而非 Y",版本历史回答它,而非 Slack 考古。

何时使用

干系人签字后 PRD 任何变更。每次 5 分钟。永远不要跳过——无版本变更是"这不是我要的"的根源。

如何做

1. PRD 放 git(docs/prd/NNNN-标题.md)以追踪变更
2. 签字后任何变更:
   a. 升版本头(v1 → v2)带日期
   b. 加 "## Changes" 字段:改了什么、为什么、谁批准
   c. 通知所有签字干系人
3. 若变更改了验收标准,重跑 PRD 评审清单
4. 若变更 > 范围 20%,当新 PRD 处理并重新规划迭代
5. 永不删旧版本——git 历史是审计链

示例

# PRD-003:发布说明生成器(v2,2026-03-22)
## 相对 v1 的变更
- 加需求:自动检测安全提交(安全团队要求)
  - 原因:30% 发布说明漏安全修复
  - 批准:Alice(工程)、Dan(法务)——03-22
- 移出范围:gitlab 支持(移到产品 v2)
  - 原因:为赶上线日期去范围;gitlab 占 5% 用户
  - 批准:Carla(销售)——03-22

干系人 03-22 在 #prd 频道通知。

常见问题

  • ⚠把变更埋在编辑历史里无摘要——工程师不读 PRD 的 git diff;在带日期的 Changes 字段里呈现。

最佳实践

  • ✓在迭代工单里钉死 PRD 版本,明确构建对哪个规格版本。
  • ✓去范围时记录谁同意去——"时间不够"不是批准。

相关资源