prd-workflow-cli 1.1.25

package/commands/baseline.js

@@ -0,0 +1,470 @@
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const confirm = require('./confirm');
+
+module.exports = async function (action, type, options = {}) {
+    const configPath = path.join(process.cwd(), '.prd-config.json');
+
+    if (!await fs.pathExists(configPath)) {
+        console.log(chalk.red('✗ 当前目录不是一个 PRD 项目'));
+        return;
+    }
+
+    const config = await fs.readJSON(configPath);
+    const baselineDir = path.join(process.cwd(), '01_产品基线');
+
+    if (action === 'create') {
+        await createBaselineDoc(type, baselineDir, config, configPath, options);
+    } else {
+        console.log(chalk.red('✗ 未知操作'));
+    }
+};
+
+async function createBaselineDoc(type, baselineDir, config, configPath, options = {}) {
+    const templates = {
+        'A0': getA0Template(),
+        'A1': getA1Template(),
+        'A2': getA2Template(),
+        'R0': getR0Template()
+    };
+
+    if (!templates[type]) {
+        console.log(chalk.red(`✗ 未知的文档类型: ${type}`));
+        console.log('可用类型: A0, A1, A2, R0');
+        return;
+    }
+
+    const fileName = getFileName(type);
+    const filePath = path.join(baselineDir, fileName);
+
+    if (await fs.pathExists(filePath)) {
+        console.log(chalk.yellow(`⚠ 文件已存在: ${fileName}`));
+        return;
+    }
+
+    // ⭐ R0 创建需要特殊处理：前置条件检查 + PM 确认
+    if (type === 'R0') {
+        console.log(chalk.bold.blue('\n=== R0 基线审视创建 ===\n'));
+
+        // 1. 前置条件检查
+        const projectDir = path.join(process.cwd(), '00_项目总览');
+        const p0Path = path.join(projectDir, 'P0_项目基本信息.md');
+        const a0Path = path.join(baselineDir, 'A0_产品基础与范围说明.md');
+        const a1Path = path.join(baselineDir, 'A1_已上线功能与流程清单.md');
+        const a2Path = path.join(baselineDir, 'A2_存量反馈与数据汇总.md');
+
+        console.log(chalk.yellow('📋 前置条件检查：\n'));
+
+        const p0Exists = await fs.pathExists(p0Path);
+        const a0Exists = await fs.pathExists(a0Path);
+        const a1Exists = await fs.pathExists(a1Path);
+        const a2Exists = await fs.pathExists(a2Path);
+
+        console.log(`   ${p0Exists ? '✅' : '❌'} P0_项目基本信息.md`);
+        console.log(`   ${a0Exists ? '✅' : '❌'} A0_产品基础与范围说明.md`);
+        console.log(`   ${a1Exists ? '✅' : '❌'} A1_已上线功能与流程清单.md`);
+        console.log(`   ${a2Exists ? '✅' : '⚠️ (可选)'} A2_存量反馈与数据汇总.md`);
+        console.log('');
+
+        // P0、A0、A1 是必需的
+        if (!p0Exists || !a0Exists || !a1Exists) {
+            console.log(chalk.red('❌ 前置条件检查未通过！\n'));
+            console.log(chalk.yellow('R0 基线审视必须基于完整的 A 类基线文档。\n'));
+            console.log(chalk.bold('请先完成缺失的文档：'));
+            if (!p0Exists) console.log('  - 完善 P0（00_项目总览/P0_项目基本信息.md）');
+            if (!a0Exists) console.log('  - 创建 A0：prd baseline create A0');
+            if (!a1Exists) console.log('  - 创建 A1：prd baseline create A1');
+            console.log('');
+            console.log(chalk.gray('提示：A2 是可选的，但建议创建'));
+
+            // 在测试模式下抛出错误
+            if (process.env.PRD_TEST_MODE === 'true') {
+                throw new Error('R0 前置条件检查未通过');
+            }
+            process.exit(1);
+        }
+
+        console.log(chalk.green('✅ 前置条件检查通过！\n'));
+
+        // 2. PM 确认
+        if (options.pmConfirmed) {
+            console.log(chalk.green('✓ PM 已在对话中确认创建 R0 基线审视'));
+        } else if (process.env.PRD_TEST_MODE === 'true') {
+            // 测试模式：跳过交互式确认
+            console.log(chalk.yellow('⚠️ 测试模式：跳过交互式确认'));
+        } else {
+            // 交互式确认
+            console.log(chalk.yellow('⚠️ R0 基线审视将：'));
+            console.log('   1. 系统性审视产品基线（基于 A0/A1/A2）');
+            console.log('   2. 梳理用户路径和问题');
+            console.log('   3. 识别关键成功因素');
+            console.log('   4. 给出基线稳定性判定\n');
+
+            const confirmed = await confirm.confirmR0Creation();
+            if (!confirmed) {
+                console.log(chalk.yellow('\n已取消创建 R0'));
+                return;
+            }
+            console.log(chalk.green('\n✓ PM 确认创建 R0\n'));
+        }
+    }
+
+    await fs.writeFile(filePath, templates[type]);
+
+    // 更新配置
+    config.stages.baseline.documents.push(type);
+    await fs.writeJSON(configPath, config, { spaces: 2 });
+
+    console.log(chalk.green(`✓ 已创建: ${fileName}`));
+    console.log(chalk.cyan(`\n文件位置: ${filePath}\n`));
+
+    // 给出下一步提示
+    if (type === 'A0') {
+        console.log(chalk.bold('下一步建议:'));
+        console.log('1. 填写 A0 产品基础与范围说明');
+        console.log('2. 创建 A1: prd baseline create A1');
+    } else if (type === 'A1') {
+        console.log(chalk.bold('下一步建议:'));
+        console.log('1. 填写 A1 已上线功能与流程清单');
+        console.log('2. 创建 A2: prd baseline create A2');
+    } else if (type === 'A2') {
+        console.log(chalk.bold('下一步建议:'));
+        console.log('1. 填写 A2 存量反馈与数据汇总');
+        console.log('2. 创建 R0 基线审视: prd baseline create R0');
+    } else if (type === 'R0') {
+        console.log(chalk.bold('下一步建议:'));
+        console.log('1. 完成 R0 基线审视（与 AI 协作填写）');
+        console.log('2. 开始第一轮迭代: prd iteration new');
+        console.log('');
+        console.log(chalk.yellow('⚠️ 重要提醒：'));
+        console.log('   R0 完成后，请勿自动创建后续文档！');
+        console.log('   必须由 PM 明确指示才能进入下一阶段。');
+    }
+    console.log('');
+}
+
+function getFileName(type) {
+    const nameMap = {
+        'A0': 'A0_产品基础与范围说明.md',
+        'A1': 'A1_已上线功能与流程清单.md',
+        'A2': 'A2_存量反馈与数据汇总.md',
+        'R0': 'R0_基线审视报告.md'
+    };
+    return nameMap[type];
+}
+
+function getA0Template() {
+    return `# A0_产品基础与范围说明
+
+**文档创建时间**: ${new Date().toLocaleString('zh-CN')}
+
+---
+
+## 一、产品背景与定位
+
+### 产品是什么
+<!-- 用一句话描述此产品 -->
+
+### 产品定位
+<!-- 在整个业务体系中的角色 -->
+
+---
+
+## 二、目标用户定义
+
+### 主要用户群体
+<!-- 列出主要用户类型 -->
+
+### 用户画像
+<!-- 描述典型用户特征 -->
+
+---
+
+## 三、核心使用场景
+
+### 场景一: 
+<!-- 场景描述 -->
+
+### 场景二:
+<!-- 场景描述 -->
+
+---
+
+## 四、当前版本范围与边界
+
+### 当前包含的能力
+<!-- 列出已有的核心功能 -->
+
+### 当前的技术架构
+<!-- 简要说明技术实现方式 -->
+
+---
+
+## 五、明确不覆盖的内容
+
+### 当前不支持的场景
+<!-- 明确说明哪些场景不支持 -->
+
+### 已知限制
+<!-- 列出当前的限制条件 -->
+
+---
+
+## 填写说明
+
+⚠️ **重要约束**:
+- 不写规划、不写愿景
+- 只描述"现在这个产品是什么样"
+- 边界要写清楚(哪些能力没有、哪些不支持)
+
+**目的**:
+- 给 AI 和人一个统一的"现状语境"
+- 防止后续规划"假设一个不存在的产品"
+- 作为所有 B 规划的前置事实引用源
+`;
+}
+
+function getA1Template() {
+    return `# A1_已上线功能与流程清单
+
+**文档创建时间**: ${new Date().toLocaleString('zh-CN')}
+
+---
+
+## 一、功能列表(按模块)
+
+### 模块一: [模块名称]
+- 功能 1.1: 
+- 功能 1.2:
+
+### 模块二: [模块名称]
+- 功能 2.1:
+- 功能 2.2:
+
+---
+
+## 二、核心用户路径
+
+### 路径一: [路径名称]
+1. 步骤 1
+2. 步骤 2
+3. 步骤 3
+
+### 路径二: [路径名称]
+1. 步骤 1
+2. 步骤 2
+
+---
+
+## 三、关键业务流程节点
+
+### 流程一:
+<!-- 描述业务流程的关键节点 -->
+
+---
+
+## 四、功能之间的依赖关系
+
+### 依赖关系图
+<!-- 描述功能间的依赖 -->
+
+---
+
+## 填写说明
+
+⚠️ **重要约束**:
+- 功能是"客观存在的"，不是"设计过的"
+- 用户路径用真实使用顺序，不用理想流程
+- 不评价好坏，只陈述事实
+
+**目的**:
+- 让审视与规划基于真实系统
+- 防止 AI 反复"重建已有能力"
+- 为 R0 / R1 提供审视对象
+`;
+}
+
+function getA2Template() {
+    return `# A2_存量反馈与数据输入汇总
+
+**文档创建时间**: ${new Date().toLocaleString('zh-CN')}
+
+---
+
+## 一、用户反馈摘要
+
+### 反馈类型一: 
+<!-- 摘要用户反馈内容 -->
+- 来源: 
+- 时间:
+
+### 反馈类型二:
+<!-- 摘要用户反馈内容 -->
+
+---
+
+## 二、数据异常或指标变化
+
+### 异常一:
+<!-- 描述数据异常情况 -->
+
+---
+
+## 三、内部问题/投诉
+
+### 问题一:
+<!-- 描述问题 -->
+- 来源:
+- 影响范围:
+
+---
+
+## 四、已知未解决事项
+
+### 事项一:
+<!-- 描述未解决的问题 -->
+- 原因:
+- 优先级:
+
+---
+
+## 五、待下版事项（C 阶段产生的新需求）
+
+**用途说明**：
+当 C1/C2 讨论过程中产生了新需求，但超出当前版本（B3）的规划范围时，
+应记录在此章节，等待下一轮迭代时纳入 B1 规划。
+
+### 待下版事项 #1: [需求标题]
+
+**来源**：C1/C2 讨论过程（第 XX 轮迭代，YYYY-MM-DD）
+**原因**：超出 B3 首版范围，延后处理
+
+**优先级**：
+- [ ] P0 - 紧急
+- [ ] P1 - 重要  
+- [ ] P2 - 一般
+
+**详细描述**：
+<!-- 需求的详细说明 -->
+
+**PM 补充说明**：
+<!-- 保留 PM 原话 -->
+
+**关联需求**：
+<!-- 与现有需求的关联 -->
+
+**记录时间**：
+**记录人**：
+
+---
+
+## 填写说明
+
+⚠️ **重要约束**:
+- 不做结论、不做方案
+- 可以是原始反馈的整理
+- 标注来源即可
+
+**目的**:
+- 为 B 规划提供动因素材
+- 防止规划"拍脑袋"
+- 为 R 审视提供"现实校验"
+- **暂存 C 阶段产生的超范围需求（待下版处理）**
+
+---
+
+## 📋 使用流程
+
+### 何时写入本文档？
+
+| 场景 | 写入章节 |
+|------|----------|
+| 收到用户反馈 | 一、用户反馈摘要 |
+| 发现数据异常 | 二、数据异常或指标变化 |
+| 内部发现问题 | 三、内部问题/投诉 |
+| 已知但未解决的问题 | 四、已知未解决事项 |
+| **C1/C2 讨论中产生的新需求** | **五、待下版事项** |
+
+### 何时从本文档提取？
+
+- **开始新一轮迭代时**：从第四、五章节提取问题/需求到 B1
+- **B1 规划时**：引用第一~三章节作为需求来源依据
+`;
+}
+
+function getR0Template() {
+    return `# R0_基线审视报告
+
+**审视时间**: ${new Date().toLocaleString('zh-CN')}
+
+---
+
+## 一、审视范围说明
+
+**审视对象**:
+- A0_产品基础与范围说明.md
+- A1_已上线功能与流程清单.md
+- A2_存量反馈与数据汇总.md
+
+**审视目标**:
+建立产品基线，为后续迭代规划提供稳定的起点。
+
+---
+
+## 二、实际用户路径审视
+
+### 主要用户路径梳理
+<!-- 从头到尾走一遍系统，描述实际使用情况 -->
+
+### 发现的路径问题
+<!-- 列出用户路径中的断点、痛点 -->
+
+---
+
+## 三、主要问题与机会
+
+### 问题清单
+1. 
+2.
+
+### 机会点
+1.
+2.
+
+---
+
+## 四、风险与隐患
+
+### 技术风险
+<!-- 列出技术层面的风险 -->
+
+### 业务风险
+<!-- 列出业务层面的风险 -->
+
+---
+
+## 五、总体判断结论
+
+**基线稳定性评估**:
+- [ ] 可以作为稳定基线
+- [ ] 需要先解决关键问题
+
+**下一步建议**:
+<!-- 给出后续规划建议 -->
+
+---
+
+## 填写说明
+
+⚠️ **重要约束**:
+- 必须"从头到尾走一遍系统"
+- 问题基于事实，不基于偏好
+- 结论是"是否适合作为稳定基线"
+
+**目的**:
+- 给存量系统建立一个起点基线
+- 为第一次 B 规划提供"共识事实"
+- 防止一上来就大改而不知问题在哪
+`;
+}

package/commands/change.js

@@ -0,0 +1,151 @@
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const inquirer = require('inquirer');
+const dialog = require('./dialog');
+
+/**
+ * 需求变更命令
+ * 自动判断当前项目状态，引导用户正确记录变更
+ */
+module.exports = async function () {
+    const configPath = path.join(process.cwd(), '.prd-config.json');
+
+    if (!await fs.pathExists(configPath)) {
+        console.log(chalk.red('✗ 当前目录不是一个 PRD 项目'));
+        console.log('请先运行: prd init <项目名>');
+        return;
+    }
+
+    const config = await fs.readJSON(configPath);
+
+    if (config.currentIteration === 0) {
+        console.log(chalk.red('✗ 还没有开始任何迭代'));
+        console.log('请先运行: prd iteration new');
+        return;
+    }
+
+    console.log(chalk.bold.blue('\n━━━ 需求变更检查 ━━━\n'));
+
+    // 检查当前迭代的文档状态
+    const iterationDir = path.join(
+        process.cwd(),
+        '02_迭代记录',
+        `第${String(config.currentIteration).padStart(2, '0')}轮迭代`
+    );
+
+    const c3Path = path.join(iterationDir, 'C3_版本冻结归档.md');
+    const c1Path = path.join(iterationDir, 'C1_版本需求清单.md');
+    const c0Path = path.join(iterationDir, 'C0_版本范围声明.md');
+    const b3Path = path.join(iterationDir, 'B3_规划冻结归档.md');
+    const b2Path = path.join(iterationDir, 'B2_规划拆解与范围界定.md');
+    const b1Path = path.join(iterationDir, 'B1_需求规划草案.md');
+
+    const hasC3 = await fs.pathExists(c3Path);
+    const hasC1 = await fs.pathExists(c1Path);
+    const hasC0 = await fs.pathExists(c0Path);
+    const hasB3 = await fs.pathExists(b3Path);
+    const hasB2 = await fs.pathExists(b2Path);
+    const hasB1 = await fs.pathExists(b1Path);
+
+    console.log(chalk.gray('当前文档状态:'));
+    console.log(`  B1: ${hasB1 ? '✅' : '❌'}  B2: ${hasB2 ? '✅' : '❌'}  B3: ${hasB3 ? '✅' : '❌'}`);
+    console.log(`  C0: ${hasC0 ? '✅' : '❌'}  C1: ${hasC1 ? '✅' : '❌'}  C3: ${hasC3 ? '✅' : '❌'}`);
+    console.log('');
+
+    // 根据状态给出不同的引导
+    if (hasC3) {
+        // 版本已冻结，需要创建 C2 记录变更
+        console.log(chalk.yellow('⚠️  版本已冻结 (C3 已存在)'));
+        console.log(chalk.bold('\n这种情况下的变更需要：'));
+        console.log('1. 创建 C2_版本变更说明.md 记录变更');
+        console.log('2. 评估变更对版本目标的影响');
+        console.log('3. 如果变更较大，可能需要重新执行 R2 审视\n');
+
+        const answer = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'createC2',
+                message: '是否创建 C2 记录此次变更？',
+                default: true
+            }
+        ]);
+
+        if (answer.createC2) {
+            // 调用 version 模块创建 C2
+            const version = require('./version');
+            await version('create', 'C2', {});
+
+            // 记录到对话归档
+            await dialog.logDialog('change', 'create_c2', {
+                type: 'change_request',
+                stage: 'after_c3_freeze',
+                action: '创建 C2 记录变更'
+            });
+        }
+
+    } else if (hasC1 || hasC0) {
+        // 在 C 阶段但未冻结
+        console.log(chalk.yellow('⚠️  当前在 C 阶段（版本需求阶段）'));
+        console.log(chalk.bold('\n根据规范，C 阶段禁止新增规划外的需求。\n'));
+
+        const answer = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'changeType',
+                message: '您的变更属于哪种类型？',
+                choices: [
+                    { name: '细化现有需求（补充验收标准/边界情况）- 允许', value: 'refine' },
+                    { name: '新增规划外需求 - 禁止，需解冻 B3', value: 'new_requirement' },
+                    { name: '调整需求优先级 - 需记录并评估', value: 'priority' },
+                    { name: '删除/裁剪需求 - 需记录并评估', value: 'remove' }
+                ]
+            }
+        ]);
+
+        if (answer.changeType === 'refine') {
+            console.log(chalk.green('\n✓ 细化现有需求是允许的'));
+            console.log('请直接修改 C1_版本需求清单.md');
+            console.log('修改后建议重新执行 R2 审视: prd review r2\n');
+        } else if (answer.changeType === 'new_requirement') {
+            console.log(chalk.red('\n✗ C 阶段禁止新增规划外需求！\n'));
+            console.log('您有两个选择：');
+            console.log('1. 将新需求放入下一轮迭代的 B1 规划');
+            console.log('2. 解冻当前 B3，重新走 R1 审视流程\n');
+            console.log(chalk.yellow('建议：如果不是紧急需求，推荐放入下一轮迭代。'));
+        } else {
+            console.log(chalk.yellow('\n⚠️  此类变更需要记录'));
+            console.log('1. 先在 C1 中做相应修改');
+            console.log('2. 重新执行 R2 审视: prd review r2');
+            console.log('3. 如果已有 C3，需要创建 C2 记录变更\n');
+        }
+
+        // 记录到对话归档
+        await dialog.logDialog('change', 'change_request', {
+            type: 'change_request',
+            stage: 'c_phase',
+            changeType: answer.changeType
+        });
+
+    } else if (hasB3) {
+        // B3 已冻结，正准备进入 C 阶段
+        console.log(chalk.yellow('⚠️  规划已冻结 (B3 已存在)，尚未开始版本需求'));
+        console.log(chalk.bold('\n如果需要变更规划，您需要：'));
+        console.log('1. 解冻 B3（删除 B3 文件）');
+        console.log('2. 修改 B1/B2');
+        console.log('3. 重新执行 R1 审视');
+        console.log('4. 重新冻结 B3\n');
+        console.log(chalk.yellow('建议：除非必要，不建议解冻已冻结的规划。'));
+
+    } else if (hasB1 || hasB2) {
+        // 还在规划阶段
+        console.log(chalk.green('✓ 当前在规划阶段（B1/B2），可以自由调整'));
+        console.log('\n直接修改 B1 或 B2 即可，无需特殊流程。');
+        console.log('修改后需要重新执行 R1 审视: prd review r1\n');
+
+    } else {
+        // 还没开始
+        console.log(chalk.green('✓ 当前迭代刚开始，可以自由规划'));
+        console.log('\n请先创建 B1: prd plan create B1\n');
+    }
+};