prd-workflow-cli 1.1.25

package/.agent/workflows/prd-c2-change-tracking.md

@@ -0,0 +1,320 @@
+# C2 版本变更工作流
+
+本工作流用于记录版本冻结后发生的变更，确保变更可追溯、可审计。
+
+---
+
+## 🎯 C2 的本质：变更记录与影响追溯
+
+C2 不是随意修改需求的"后门"，而是**严格记录变更的审计文档**。
+
+### 核心原则：
+
+```
+1. 变更必须记录
+2. 影响必须评估
+3. PM 必须确认
+```
+
+---
+
+## 📋 C2 的触发时机
+
+### 什么时候创建 C2？
+
+| 情况 | 是否需要 C2 |
+|-----|-----------|
+| C3 冻结后，需求完全不变 | ❌ 不需要 |
+| C3 冻结后，修改了某个需求 | ✅ 需要 |
+| C3 冻结后，删除了某个需求 | ✅ 需要 |
+| C3 冻结后，新增了需求 | ✅ 需要（且可能需要重新 R2）|
+| C3 冻结后，调整了优先级 | ✅ 需要 |
+
+**命令**：`prd change` → 选择"创建 C2" 或 `prd version create C2`
+
+---
+
+## 🔍 AI 的职责：自动对比与提醒
+
+### Step 1: 自动生成差异对比清单
+
+**AI 必须做的（自动化）**：
+
+```
+AI: "我检测到 C1 或 C3 可能发生了变更。
+     
+     让我生成差异对比清单：
+     
+     1. 对比冻结版本（C3）与当前状态
+     2. 识别所有差异点
+     3. 分类差异类型
+     
+     正在分析..."
+```
+
+**AI 输出：差异对比矩阵**
+
+| 需求 | 冻结版（C3）| 当前状态 | 差异类型 | 影响评估 |
+|-----|-----------|---------|---------|---------|
+| REQ-001 | P0 | P1 | 优先级降级 | ⚠️ 影响交付 |
+| REQ-002 | 存在 | 删除 | 需求删除 | ⚠️ 影响范围 |
+| REQ-005 | 不存在 | 新增 | 新增需求 | ❌ 违反规范 |
+
+---
+
+### Step 2: 映射到来源（可追溯性）
+
+**AI 必须追溯每个变更的来源：**
+
+```
+AI: "差异项 #1：REQ-001 优先级从 P0 降为 P1
+     
+     追溯分析：
+     - 来源：B2 需求项 #1（优先级 P0）
+     - B3 冻结时：确认为 P0（CSF）
+     - C1 中：标记为 P0
+     - C3 冻结时：P0
+     - 当前状态：P1 ← 发生变更
+     
+     ⚠️ 这是 CSF（关键成功因素）的降级，影响重大！"
+```
+
+---
+
+### Step 3: 触发重新审视提醒
+
+**AI 必须检查是否需要重新审视：**
+
+```
+AI: "变更影响评估：
+     
+     轻微变更（无需重新审视）：
+     - 细化验收标准
+     - 补充边界说明
+     
+     重大变更（需要重新 R2 审视）：
+     - ❌ 新增需求（REQ-005）
+     - ⚠️ CSF 降级（REQ-001）
+     - ⚠️ 删除需求（REQ-002）
+     
+     建议：需要重新执行 R2 审视。
+     
+     是否触发重新审视？（由 PM 决定）"
+```
+
+---
+
+## 💬 PM 的职责：确认与决策
+
+### PM 必须做的（不可替代）：
+
+#### 1. 确认变更事实
+
+```
+AI: "检测到以下变更，请确认：
+     
+     1. REQ-001 优先级降级（P0 → P1）
+        - 是否属实？
+        - 变更原因是什么？
+     
+     2. REQ-005 新增
+        - 是否属实？
+        - 为什么新增（需求变更/遗漏/策略调整）？
+     
+     请逐项确认。"
+
+PM: [确认并说明原因]
+```
+
+#### 2. 确认变更原因归因
+
+**AI 提供选项，PM 选择**：
+
+```
+AI: "REQ-005 新增的原因归因：
+     
+     - [ ] 需求变更（业务方新增需求）
+     - [ ] 外部依赖变化（第三方接口调整）
+     - [ ] 策略调整（公司战略变化）
+     - [ ] 前期遗漏（B3/C1 时遗漏了）
+     - [ ] 其他（请说明）
+     
+     请选择归因类型。"
+```
+
+#### 3. 评估变更影响
+
+**AI 提供影响矩阵，PM 决策**：
+
+```
+AI: "变更影响评估：
+     
+     | 维度 | 影响评估 |
+     |-----|---------|
+     | 范围 | 扩大了 10%（新增 1 个需求）|
+     | 承诺 | 违反了 C3 的版本承诺 |
+     | 节奏 | 可能延期 2 周 |
+     | 资源 | 需要额外 30 人天 |
+     
+     请问这个变更影响是否可接受？"
+
+PM: [决策：接受 / 拒绝 / 调整]
+```
+
+---
+
+## 📊 C2 输出格式
+
+**AI 必须生成完整的 C2 变更记录：**
+
+```markdown
+# C2_版本变更说明
+
+**创建时间**: 2025-12-19
+**变更批次**: #1
+
+---
+
+## 1. 变更概述
+
+**变更类型统计**:
+- 新增需求：1 项
+- 删除需求：1 项
+- 优先级调整：1 项
+- 细节修改：0 项
+
+**总变更率**: 15%（3 项 / 20 项总需求）
+
+---
+
+## 2. 变更明细
+
+### 变更 #1：REQ-001 优先级降级
+
+**变更时间**: 2025-12-19 10:00
+**变更人**: PM 侯桐
+
+**变更内容**:
+- 冻结版：P0（CSF）
+- 当前版：P1
+
+**变更原因**（PM 确认）:
+- 归因类型：策略调整
+- 具体原因：公司决定先上线核心流程，进度指示延后
+
+**来源追溯**:
+- B2 需求项 #1
+- B3 冻结时确认为 CSF
+- C1 中标记为 P0
+- C3 冻结时为 P0
+
+**影响评估**（PM 确认）:
+- 范围影响：无（仍在版本内）
+- 承诺影响：⚠️ 违反 CSF 承诺
+- 节奏影响：可能影响用户体验
+- 资源影响：节省 15 人天
+
+**PM 决策**: ✅ 接受变更
+
+---
+
+### 变更 #2：REQ-005 新增需求
+
+**变更时间**: 2025-12-19 10:30
+**变更人**: PM 侯桐
+
+**变更内容**:
+- 冻结版：不存在
+- 当前版：新增（批量启动功能）
+
+**变更原因**（PM 确认）:
+- 归因类型：需求变更
+- 具体原因：业务方紧急需求，CEO 特批
+
+**来源追溯**:
+- ❌ B2 中不存在
+- ❌ B3 范围外
+- ❌ C1 中不存在
+
+**影响评估**（PM 确认）:
+- 范围影响：🔴 扩大 10%
+- 承诺影响：🔴 违反版本承诺
+- 节奏影响：🔴 延期 2 周
+- 资源影响：🔴 额外 30 人天
+
+**PM 决策**: ⚠️ 接受但需重新 R2 审视
+
+---
+
+## 3. 差异对比清单
+
+| 需求 | 冻结版 | 当前 | 差异类型 | PM决策 |
+|-----|-------|-----|---------|-------|
+| REQ-001 | P0 | P1 | 优先级降级 | ✅ 接受 |
+| REQ-002 | 存在 | 删除 | 需求删除 | ✅ 接受 |
+| REQ-005 | 不存在 | 新增 | 新增需求 | ⚠️ 重审 |
+
+---
+
+## 4. 重新审视要求
+
+**是否需要重新 R2 审视**: ✅ 需要
+
+**理由**:
+- 新增了规划外需求（REQ-005）
+- CSF 被降级（REQ-001）
+
+**R2 审视状态**: 
+- [ ] 未执行
+- [ ] 执行中
+- [ ] 已通过
+
+---
+
+## 5. PM 最终确认
+
+**PM 签字**: 侯桐
+**确认日期**: 2025-12-19
+**确认声明**: 
+
+我确认上述变更的原因、影响评估和决策，并对变更后果负责。
+
+---
+
+## 6. 审计追溯
+
+**变更记录索引**: C2-001
+**关联文档**:
+- B3_规划冻结归档.md
+- C1_版本需求清单.md
+- C3_版本冻结归档.md
+
+**下一步**:
+- [ ] 执行 R2 重新审视
+- [ ] 更新 C3
+- [ ] 通知相关方
+```
+
+---
+
+## ⚠️ AI 行为红线
+
+### AI 绝对禁止：
+
+1. ❌ 在 C2 中"顺手新增需求"（只记录，不决策）
+2. ❌ 以记录差异为名扩大范围
+3. ❌ 替 PM 宣布"变更可接受"
+4. ❌ 自动修改 C1 或 C3（必须通过正规流程）
+5. ❌ 隐藏重大变更（必须明确标注）
+
+### AI 必须做到：
+
+1. ✅ 自动生成差异对比清单
+2. ✅ 追溯每个变更的来源
+3. ✅ 提醒是否需要重新审视
+4. ✅ 提供影响评估矩阵（由 PM 决策）
+5. ✅ 完整记录 PM 的确认和决策
+
+---
+
+**本工作流确保版本变更可追溯、可审计，防止"偷偷改需求"！**

package/.agent/workflows/prd-dialog-archive.md

@@ -0,0 +1,215 @@
+# PRD 对话归档工作流
+
+**核心原则**：所有对话必须可追溯！
+
+---
+
+## 🛡️ 归档规则
+
+### AI 必须在以下时机记录对话：
+
+1. **每次 PM 确认决策时**
+2. **每次讨论需求项时**
+3. **每次确定优先级时**
+4. **每次界定范围时**
+5. **每次 AI 给出建议时**
+
+---
+
+## 📝 需要记录的内容
+
+### 1. 对话轮次记录
+
+每轮对话都应记录：
+- **讨论主题**: 在讨论什么
+- **PM 说的话**: PM 的原话或要点
+- **AI 的回复**: AI 的总结或建议
+- **PM 的决策**: PM 最终的决定
+- **背景信息**: 相关上下文
+
+### 2. 需求讨论记录
+
+讨论需求项时应记录：
+- 需求项编号
+- PM 描述的需求内容
+- AI 的理解和总结
+- PM 是否确认
+
+### 3. 优先级决策记录
+
+确定优先级时应记录：
+- P0/P1/P2 各包含哪些需求
+- PM 的决策理由
+- 最终确认的排序
+
+### 4. 范围决策记录
+
+界定范围时应记录：
+- 首版包含哪些
+- 延后哪些
+- PM 的决策理由
+
+---
+
+## 🔧 归档方法
+
+### 方法 1：通过 Node.js 直接调用
+
+AI 可以在项目目录下创建一个临时脚本来记录对话：
+
+```javascript
+// 在项目目录下执行
+const dialog = require('./prd-cli/commands/dialog');
+
+// 记录一轮对话
+dialog.logConversationRound(
+    'planning',                           // 阶段
+    '讨论核心问题',                        // 主题
+    'BP创建流程用户体验差',                // PM 说的
+    '理解，要解决的核心问题是用户体验',    // AI 回复
+    'PM 确认这是核心问题',                 // PM 决策
+    '来自用户反馈会议'                     // 背景
+);
+
+// 记录需求讨论
+dialog.logRequirementDiscussion(
+    'planning',
+    'REQ-001',
+    '需要进度指示器',
+    '理解：添加进度条显示当前步骤',
+    true  // 确认
+);
+
+// 记录优先级决策
+dialog.logPriorityDecision(
+    'planning',
+    { P0: ['REQ-001', 'REQ-002'], P1: ['REQ-003'], P2: ['REQ-004'] },
+    '流程引导是核心体验，必须先做'
+);
+
+// 记录范围决策
+dialog.logScopeDecision(
+    'planning',
+    ['REQ-001', 'REQ-002', 'REQ-003'],  // 首版包含
+    ['REQ-004', 'REQ-005'],              // 延后
+    '时间有限，先保证核心闭环'
+);
+```
+
+### 方法 2：直接写入对话记录文件
+
+AI 也可以直接在 `98_对话归档/` 目录下追加内容到 markdown 文件：
+
+```markdown
+## 2025/12/18 22:00:00
+
+**阶段**: planning
+**动作**: conversation_round
+**迭代轮次**: 1
+
+### 💬 对话内容
+
+**讨论主题**: 讨论核心问题
+
+**🧑 PM**: BP创建流程太复杂了，用户反馈不知道到哪一步了
+
+**🤖 AI**: 理解，您描述的核心问题是"创建流程缺乏清晰的进度指示"。这个问题在 A2 用户反馈中有体现吗？
+
+**✅ PM 决策**: 是的，确认核心问题是流程引导不足
+
+**📋 背景**: 来自交付会议的用户反馈
+
+---
+```
+
+---
+
+## ✅ 归档效果示例
+
+好的对话归档应该像这样：
+
+```markdown
+# 对话记录
+
+**文件**: planning_对话记录.md
+**记录数**: 5
+
+---
+
+## 2025/12/18 19:03:54
+
+**阶段**: planning
+**动作**: conversation_round
+
+### 💬 对话内容
+
+**讨论主题**: 确认核心问题
+
+**🧑 PM**: 用户反馈说创建BP的时候不知道到哪一步了，也不知道该填什么
+
+**🤖 AI**: 理解。您描述的问题可以总结为"创建流程缺乏清晰指引"。这包括：
+1. 进度不可见
+2. 填写指引缺失
+3. 操作反馈不足
+对吗？
+
+**✅ PM 决策**: 对，就是这三个问题
+
+---
+
+## 2025/12/18 19:10:30
+
+**阶段**: planning
+**动作**: requirement_discussion
+
+### 💬 对话内容
+
+**讨论主题**: 需求项 REQ-001 讨论
+
+**🧑 PM**: 需要一个进度条，让用户知道当前在哪一步
+
+**🤖 AI**: 好的，需求项 #1：创建进度指示器，显示当前步骤和总步骤。是这个意思吗？
+
+**✅ PM 决策**: 确认
+
+---
+
+## 2025/12/18 19:20:00
+
+**阶段**: planning
+**动作**: priority_decision
+
+### 💬 对话内容
+
+**讨论主题**: 优先级排序决策
+
+**🧑 PM**: 进度指示器和保存确认必须做，操作日志可以后面做
+
+**🤖 AI**: 已记录优先级：P0=2项, P1=1项, P2=1项
+
+**✅ PM 决策**: {"P0":["REQ-001","REQ-002"],"P1":["REQ-003"],"P2":["REQ-004"]}
+
+---
+```
+
+---
+
+## ⚠️ AI 行为约束
+
+### AI 必须：
+
+1. **及时记录** - 每轮对话结束后立即记录
+2. **完整记录** - 包含 PM 的原话、AI 的回复、最终决策
+3. **准确记录** - 不能歪曲 PM 的意思
+4. **主动记录** - 不需要 PM 提醒
+
+### AI 禁止：
+
+- ❌ 只记录结论，不记录过程
+- ❌ 讨论完忘记归档
+- ❌ 合并多轮对话为一条记录
+- ❌ 省略 PM 的关键决策
+
+---
+
+**本工作流确保所有对话过程可追溯！**