/version-prd

PRD版本管理命令

命令说明

管理PRD文档的版本历史，支持创建版本、查看历史、比较差异、恢复版本等操作。

使用方法

/prd-generator:version-prd [子命令] [选项]

子命令

1. list - 列出所有版本

/prd-generator:version-prd list [PRD名称]

显示指定PRD的所有版本：

📚 PRD版本历史: 移动端生物识别认证

版本    时间                  作者          说明              标签
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
v5      2026-02-13 16:00     张三          添加安全考虑      [release]
v4      2026-02-13 14:30     张三          更新成功指标
v3      2026-02-12 10:15     李四          修改用户故事      [review]
v2      2026-02-11 16:45     张三          补充技术细节
v1      2026-02-11 09:00     张三          初始版本          [draft]

当前版本: v5
总版本数: 5

2. diff - 比较版本差异

/prd-generator:version-prd diff [PRD名称] [版本1] [版本2]

比较两个版本的差异：

📊 版本比较: v3 vs v5

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
变更摘要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

新增: 15行
删除: 8行
修改: 23行

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
主要变更
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

+ 新增章节: 8. 技术考虑 - 安全性
+ 新增用户故事: 故事 #6 - 生物识别设置
~ 修改成功指标: 采用率目标从50%提升到60%
- 删除: 过时的技术方案

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
详细差异
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 6. 成功指标

- 采用率: 目标50% → 目标60%
+ 登录成功率: 目标95%
+ 用户满意度: 目标4.5/5

+ ## 8. 技术考虑
+
+ ### 8.3 安全性
+ - 生物识别数据本地存储
+ - 使用系统安全存储（Keychain）
+ - 不上传生物识别数据到服务器

3. restore - 恢复到指定版本

/prd-generator:version-prd restore [PRD名称] [版本号]

恢复PRD到指定版本：

⚠️ 确认恢复操作

将恢复 "移动端生物识别认证" 到版本 v3

当前版本: v5 (2026-02-13 16:00)
目标版本: v3 (2026-02-12 10:15)

这将创建一个新版本 v6，内容为 v3 的内容。
原有版本不会被删除。

确认恢复？(y/n)

确认后：

✅ 已恢复到版本 v3

新版本: v6
文件: outputs/移动端生物识别认证-prd.md
说明: 恢复到版本 v3

4. tag - 为版本添加标签

/prd-generator:version-prd tag [PRD名称] [版本号] [标签]

为版本添加标签：

/prd-generator:version-prd tag 移动端生物识别认证 v5 release

✅ 已为版本 v5 添加标签: release

常用标签：

• draft - 草稿
• review - 待审核
• approved - 已批准
• release - 已发布
• archived - 已归档

5. show - 查看版本详情

/prd-generator:version-prd show [PRD名称] [版本号]

显示版本的详细信息：

📄 版本详情: v5

PRD名称: 移动端生物识别认证
版本号: v5
创建时间: 2026-02-13 16:00:00
作者: 张三 ([email protected])
变更说明: 添加安全考虑章节
标签: [release]

文件大小: 15.2 KB
行数: 342

变更统计:
- 新增: 45行
- 删除: 12行
- 修改: 18行

查看完整内容？(y/n)

6. create - 手动创建版本

/prd-generator:version-prd create [PRD名称] [说明]

手动为当前PRD创建版本快照：

/prd-generator:version-prd create 移动端生物识别认证 "添加性能要求"

✅ 已创建新版本

版本号: v6
时间: 2026-02-13 17:00:00
说明: 添加性能要求
文件: outputs/.versions/移动端生物识别认证/v6_20260213_170000.md

版本存储结构

outputs/.versions/
├── 移动端生物识别认证/
│   ├── v1_20260211_090000.md
│   ├── v2_20260211_164500.md
│   ├── v3_20260212_101500.md
│   ├── v4_20260213_143000.md
│   ├── v5_20260213_160000.md
│   └── metadata.json
└── 数据分析仪表板/
    ├── v1_20260210_140000.md
    ├── v2_20260211_093000.md
    └── metadata.json

metadata.json 结构

{
  "prd_name": "移动端生物识别认证",
  "current_version": "v5",
  "versions": [
    {
      "version": "v1",
      "timestamp": "2026-02-11T09:00:00",
      "author": "张三",
      "email": "[email protected]",
      "message": "初始版本",
      "tags": ["draft"],
      "file_path": "v1_20260211_090000.md",
      "file_size": 12800,
      "line_count": 285
    },
    {
      "version": "v5",
      "timestamp": "2026-02-13T16:00:00",
      "author": "张三",
      "email": "[email protected]",
      "message": "添加安全考虑",
      "tags": ["release"],
      "file_path": "v5_20260213_160000.md",
      "file_size": 15600,
      "line_count": 342,
      "changes": {
        "added": 45,
        "deleted": 12,
        "modified": 18
      }
    }
  ]
}

自动版本创建

以下操作会自动创建版本：

1. 生成新PRD

   • 自动创建 v1 版本
   • 标签: draft

2. 保存PRD修改

   • 检测到文件变更时自动创建版本
   • 提示用户输入变更说明

3. 验证后保存

   • 验证通过后保存会创建版本
   • 标签: validated

版本管理最佳实践

1. 版本命名

• 使用语义化版本号
• 重大变更：v1 → v2
• 小改进：v1.1 → v1.2
• 修复：v1.1.1 → v1.1.2

2. 变更说明

好的变更说明：

• ✅ "添加生物识别安全考虑章节"
• ✅ "更新成功指标目标值"
• ✅ "修复用户故事格式问题"

不好的变更说明：

• ❌ "更新"
• ❌ "修改"
• ❌ "fix"

3. 标签使用

• draft - 初稿，内部讨论
• review - 提交审核
• approved - 审核通过
• release - 正式发布
• archived - 已归档

4. 版本清理

定期清理旧版本：

• 保留重要里程碑版本
• 删除中间临时版本
• 归档历史版本

示例工作流

场景1：PRD迭代

# 1. 生成初始PRD
/prd-generator:generate-prd
# 自动创建 v1 [draft]

# 2. 团队审核后修改
# 手动编辑文件
/prd-generator:version-prd create "根据审核意见修改"
# 创建 v2

# 3. 添加审核标签
/prd-generator:version-prd tag v2 review

# 4. 审核通过
/prd-generator:version-prd tag v2 approved

# 5. 正式发布
/prd-generator:version-prd create "正式发布版本"
/prd-generator:version-prd tag v3 release

场景2：版本回滚

# 1. 查看版本历史
/prd-generator:version-prd list

# 2. 比较当前版本和之前版本
/prd-generator:version-prd diff v3 v5

# 3. 发现问题，恢复到v3
/prd-generator:version-prd restore v3

# 4. 创建新版本继续工作
/prd-generator:version-prd create "修复问题后的版本"

相关命令

• /prd-generator:generate-prd - 生成PRD（自动创建v1）
• /prd-generator:validate-prd - 验证PRD

技术实现

版本管理使用Python实现：

• lib/version_manager.py - 版本管理核心逻辑
• 使用Git diff算法比较版本
• JSON存储版本元数据
• 文件系统存储版本快照