prd-workflow-cli 1.4.0 → 2.0.0

package/commands/baseline.js

@@ -1,8 +1,11 @@
 const fs = require('fs-extra');
 const path = require('path');
 const chalk = require('chalk');
-const confirm = require('./confirm');
 
+/**
+ * 基线管理命令 (v2.0.0)
+ * 支持中文参数：产品定义、代码快照、用户反馈
+ */
 module.exports = async function (action, type, options = {}) {
     const configPath = path.join(process.cwd(), '.prd-config.json');
 
@@ -12,7 +15,13 @@ module.exports = async function (action, type, options = {}) {
     }
 
     const config = await fs.readJSON(configPath);
-    const baselineDir = path.join(process.cwd(), '01_产品基线');
+
+    // 支持新旧两种目录名
+    let baselineDir = path.join(process.cwd(), '01_基线');
+    if (!await fs.pathExists(baselineDir)) {
+        baselineDir = path.join(process.cwd(), '01_产品基线');
+    }
+    await fs.ensureDir(baselineDir);
 
     if (action === 'create') {
         await createBaselineDoc(type, baselineDir, config, configPath, options);
@@ -21,21 +30,35 @@ module.exports = async function (action, type, options = {}) {
     }
 };
 
+// 中文名称到内部类型的映射
+const typeMap = {
+    '产品定义': 'product',
+    '代码快照': 'codebase',
+    '用户反馈': 'feedback',
+    // 兼容旧版
+    'A0': 'product',
+    'A1': 'codebase',
+    'A2': 'feedback'
+};
+
+// 类型到文件名的映射
+const fileNameMap = {
+    'product': '产品定义.md',
+    'codebase': '代码快照.md',
+    'feedback': '用户反馈.md'
+};
+
 async function createBaselineDoc(type, baselineDir, config, configPath, options = {}) {
-    const templates = {
-        'A0': getA0Template(),
-        'A1': getA1Template(),
-        'A2': getA2Template(),
-        'R0': getR0Template()
-    };
-
-    if (!templates[type]) {
+    const internalType = typeMap[type];
+
+    if (!internalType) {
         console.log(chalk.red(`✗ 未知的文档类型: ${type}`));
-        console.log('可用类型: A0, A1, A2, R0');
+        console.log('可用类型: 产品定义, 代码快照, 用户反馈');
+        console.log(chalk.gray('（兼容旧版: A0, A1, A2）'));
         return;
     }
 
-    const fileName = getFileName(type);
+    const fileName = fileNameMap[internalType];
     const filePath = path.join(baselineDir, fileName);
 
     if (await fs.pathExists(filePath)) {
@@ -43,428 +66,286 @@ async function createBaselineDoc(type, baselineDir, config, configPath, options
         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'));
-        }
+    // 根据类型获取模板
+    let template;
+    switch (internalType) {
+        case 'product':
+            template = getProductTemplate();
+            break;
+        case 'codebase':
+            template = getCodebaseTemplate();
+            break;
+        case 'feedback':
+            template = getFeedbackTemplate();
+            break;
     }
 
-    await fs.writeFile(filePath, templates[type]);
+    await fs.writeFile(filePath, template);
 
     // 更新配置
-    config.stages.baseline.documents.push(type);
+    config.stages.baseline.documents.push(internalType);
     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') {
+    if (internalType === 'product') {
         console.log(chalk.bold('下一步建议:'));
-        console.log('1. 填写 A2 存量反馈与数据汇总');
-        console.log('2. 创建 R0 基线审视: prd baseline create R0');
-    } else if (type === 'R0') {
+        console.log('1. 填写产品定义（与 AI 对话完成）');
+        console.log('2. 创建代码快照: prd baseline create 代码快照');
+        console.log(chalk.yellow('\n💡 提示: 使用 /prd-代码快照 工作流让 AI 自动扫描代码生成'));
+    } else if (internalType === 'codebase') {
+        console.log(chalk.bold('⚠️ 重要提醒:'));
+        console.log(chalk.yellow('代码快照应由 AI 扫描代码自动生成，而非手动填写！'));
+        console.log('\n使用 /prd-代码快照 工作流让 AI 扫描代码。');
+        console.log('\n下一步建议:');
+        console.log('1. 创建用户反馈: prd baseline create 用户反馈');
+    } else if (internalType === 'feedback') {
         console.log(chalk.bold('下一步建议:'));
-        console.log('1. 完成 R0 基线审视（与 AI 协作填写）');
+        console.log('1. 整理用户反馈（可让 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_产品基础与范围说明
+function getProductTemplate() {
+    return `# 产品定义
 
-**文档创建时间**: ${new Date().toLocaleString('zh-CN')}
+**创建时间**: ${new Date().toLocaleString('zh-CN')}
 
 ---
 
-## 一、产品背景与定位
+## 1. 产品是什么
 
-### 产品是什么
 <!-- 用一句话描述此产品 -->
 
-### 产品定位
+
+## 2. 产品定位
+
 <!-- 在整个业务体系中的角色 -->
 
+
 ---
 
-## 二、目标用户定义
+## 3. 目标用户
 
 ### 主要用户群体
+
 <!-- 列出主要用户类型 -->
 
-### 用户画像
-<!-- 描述典型用户特征 -->
 
----
-
-## 三、核心使用场景
+### 用户画像
 
-### 场景一: 
-<!-- 场景描述 -->
+<!-- 描述典型用户特征 -->
 
-### 场景二:
-<!-- 场景描述 -->
 
 ---
 
-## 四、当前版本范围与边界
+## 4. 核心使用场景
 
-### 当前包含的能力
-<!-- 列出已有的核心功能 -->
+### 场景一: [场景名称]
 
-### 当前的技术架构
-<!-- 简要说明技术实现方式 -->
+<!-- 场景描述 -->
 
----
 
-## 五、明确不覆盖的内容
+### 场景二: [场景名称]
 
-### 当前不支持的场景
-<!-- 明确说明哪些场景不支持 -->
+<!-- 场景描述 -->
 
-### 已知限制
-<!-- 列出当前的限制条件 -->
 
 ---
 
-## 填写说明
-
-⚠️ **重要约束**:
-- 不写规划、不写愿景
-- 只描述"现在这个产品是什么样"
-- 边界要写清楚(哪些能力没有、哪些不支持)
-
-**目的**:
-- 给 AI 和人一个统一的"现状语境"
-- 防止后续规划"假设一个不存在的产品"
-- 作为所有 B 规划的前置事实引用源
-`;
-}
+## 5. 当前能力范围
 
-function getA1Template() {
-    return `# A1_已上线功能与流程清单
+### 已有的核心功能
 
-**文档创建时间**: ${new Date().toLocaleString('zh-CN')}
+<!-- 列出已有的核心功能 -->
 
----
 
-## 一、功能列表(按模块)
+### 当前技术架构
 
-### 模块一: [模块名称]
-- 功能 1.1: 
-- 功能 1.2:
+<!-- 简要说明技术实现方式 -->
 
-### 模块二: [模块名称]
-- 功能 2.1:
-- 功能 2.2:
 
 ---
 
-## 二、核心用户路径
+## 6. 明确不做的事情
 
-### 路径一: [路径名称]
-1. 步骤 1
-2. 步骤 2
-3. 步骤 3
-
-### 路径二: [路径名称]
-1. 步骤 1
-2. 步骤 2
+### 不支持的场景
 
----
+<!-- 明确说明哪些场景不支持 -->
 
-## 三、关键业务流程节点
 
-### 流程一:
-<!-- 描述业务流程的关键节点 -->
+### 已知限制
 
----
+<!-- 列出当前的限制条件 -->
 
-## 四、功能之间的依赖关系
-
-### 依赖关系图
-<!-- 描述功能间的依赖 -->
 
 ---
 
 ## 填写说明
 
 ⚠️ **重要约束**:
-- 功能是"客观存在的"，不是"设计过的"
-- 用户路径用真实使用顺序，不用理想流程
-- 不评价好坏，只陈述事实
+- 不写规划、不写愿景
+- 只描述"现在这个产品是什么样"
+- 边界要写清楚（哪些能力没有、哪些不支持）
 
 **目的**:
-- 让审视与规划基于真实系统
-- 防止 AI 反复"重建已有能力"
-- 为 R0 / R1 提供审视对象
+- 给 AI 和人一个统一的"现状语境"
+- 防止后续规划"假设一个不存在的产品"
+- 作为所有规划的前置事实引用源
 `;
 }
 
-function getA2Template() {
-    return `# A2_存量反馈与数据输入汇总
+function getCodebaseTemplate() {
+    return `# 代码快照
 
-**文档创建时间**: ${new Date().toLocaleString('zh-CN')}
+**创建时间**: ${new Date().toLocaleString('zh-CN')}
 
 ---
 
-## 一、用户反馈摘要
-
-### 反馈类型一: 
-<!-- 摘要用户反馈内容 -->
-- 来源: 
-- 时间:
-
-### 反馈类型二:
-<!-- 摘要用户反馈内容 -->
+> ⚠️ **本文件应由 AI 扫描代码自动生成，请勿手动维护！**
+> 
+> 使用 /prd-代码快照 工作流让 AI 扫描代码。
 
 ---
 
-## 二、数据异常或指标变化
+## 1. 项目概览
 
-### 异常一:
-<!-- 描述数据异常情况 -->
+**项目类型**: [前端/后端/全栈/CLI]
+**技术栈**: [React/Vue/Express/...]
+**入口文件**: [...]
 
 ---
 
-## 三、内部问题/投诉
+## 2. 功能清单
 
-### 问题一:
-<!-- 描述问题 -->
-- 来源:
-- 影响范围:
+### 2.1 [模块A]
 
----
+| 功能 | 路径/入口 | 说明 |
+|-----|----------|------|
+| 功能1 | \`src/xxx\` | ... |
+| 功能2 | \`src/yyy\` | ... |
 
-## 四、已知未解决事项
+### 2.2 [模块B]
 
-### 事项一:
-<!-- 描述未解决的问题 -->
-- 原因:
-- 优先级:
+...
 
 ---
 
-## 五、待下版事项（C 阶段产生的新需求）
-
-**用途说明**：
-当 C1/C2 讨论过程中产生了新需求，但超出当前版本（B3）的规划范围时，
-应记录在此章节，等待下一轮迭代时纳入 B1 规划。
-
-### 待下版事项 #1: [需求标题]
-
-**来源**：C1/C2 讨论过程（第 XX 轮迭代，YYYY-MM-DD）
-**原因**：超出 B3 首版范围，延后处理
+## 3. API 清单（如有）
 
-**优先级**：
-- [ ] P0 - 紧急
-- [ ] P1 - 重要  
-- [ ] P2 - 一般
+| 方法 | 路径 | 说明 |
+|-----|------|------|
+| GET | /api/xxx | ... |
+| POST | /api/yyy | ... |
 
-**详细描述**：
-<!-- 需求的详细说明 -->
+---
 
-**PM 补充说明**：
-<!-- 保留 PM 原话 -->
+## 4. 核心用户路径
 
-**关联需求**：
-<!-- 与现有需求的关联 -->
+### 路径 1: [路径名称]
 
-**记录时间**：
-**记录人**：
+1. 步骤 1
+2. 步骤 2
+3. 步骤 3
 
 ---
 
-## 填写说明
+## 5. 依赖关系
 
-⚠️ **重要约束**:
-- 不做结论、不做方案
-- 可以是原始反馈的整理
-- 标注来源即可
+### 模块间依赖
 
-**目的**:
-- 为 B 规划提供动因素材
-- 防止规划"拍脑袋"
-- 为 R 审视提供"现实校验"
-- **暂存 C 阶段产生的超范围需求（待下版处理）**
+<!-- 描述功能间的依赖 -->
 
 ---
 
-## 📋 使用流程
-
-### 何时写入本文档？
-
-| 场景 | 写入章节 |
-|------|----------|
-| 收到用户反馈 | 一、用户反馈摘要 |
-| 发现数据异常 | 二、数据异常或指标变化 |
-| 内部发现问题 | 三、内部问题/投诉 |
-| 已知但未解决的问题 | 四、已知未解决事项 |
-| **C1/C2 讨论中产生的新需求** | **五、待下版事项** |
+## 扫描日志
 
-### 何时从本文档提取？
-
-- **开始新一轮迭代时**：从第四、五章节提取问题/需求到 B1
-- **B1 规划时**：引用第一~三章节作为需求来源依据
+- 最后扫描时间: ___
+- 扫描范围: ___
+- 识别功能点: ___ 个
+- 识别 API: ___ 个
 `;
 }
 
-function getR0Template() {
-    return `# R0_基线审视报告
+function getFeedbackTemplate() {
+    return `# 用户反馈
 
-**审视时间**: ${new Date().toLocaleString('zh-CN')}
+**创建时间**: ${new Date().toLocaleString('zh-CN')}
 
 ---
 
-## 一、审视范围说明
+## 1. 用户反馈摘要
+
+### 反馈 1: [标题]
+
+- **来源**: 
+- **时间**: 
+- **内容**: 
 
-**审视对象**:
-- A0_产品基础与范围说明.md
-- A1_已上线功能与流程清单.md
-- A2_存量反馈与数据汇总.md
+### 反馈 2: [标题]
 
-**审视目标**:
-建立产品基线，为后续迭代规划提供稳定的起点。
+- **来源**: 
+- **时间**: 
+- **内容**: 
 
 ---
 
-## 二、实际用户路径审视
+## 2. 数据异常或指标变化
 
-### 主要用户路径梳理
-<!-- 从头到尾走一遍系统，描述实际使用情况 -->
+### 异常 1: [标题]
 
-### 发现的路径问题
-<!-- 列出用户路径中的断点、痛点 -->
+- **发现时间**: 
+- **具体表现**: 
+- **影响范围**: 
 
 ---
 
-## 三、主要问题与机会
+## 3. 内部问题/投诉
 
-### 问题清单
-1. 
-2.
+### 问题 1: [标题]
 
-### 机会点
-1.
-2.
+- **来源**: 
+- **描述**: 
+- **影响范围**: 
 
 ---
 
-## 四、风险与隐患
+## 4. 已知未解决事项
 
-### 技术风险
-<!-- 列出技术层面的风险 -->
+### 事项 1: [标题]
 
-### 业务风险
-<!-- 列出业务层面的风险 -->
+- **原因**: 
+- **优先级**: P0 / P1 / P2
 
 ---
 
-## 五、总体判断结论
+## 5. 待下版事项
 
-**基线稳定性评估**:
-- [ ] 可以作为稳定基线
-- [ ] 需要先解决关键问题
+> 当规划/版本讨论过程中产生了新需求，但超出当前版本范围时，
+> 记录在此章节，等待下一轮迭代时纳入规划。
 
-**下一步建议**:
-<!-- 给出后续规划建议 -->
+### 待下版 #1: [需求标题]
+
+**来源**: 第 XX 轮迭代讨论
+**原因**: 超出首版范围，延后处理
+**优先级**: P0 / P1 / P2
+**详细描述**: 
 
 ---
 
 ## 填写说明
 
 ⚠️ **重要约束**:
-- 必须"从头到尾走一遍系统"
-- 问题基于事实，不基于偏好
-- 结论是"是否适合作为稳定基线"
+- 不做结论、不做方案
+- 可以是原始反馈的整理
+- 标注来源即可
 
 **目的**:
-- 给存量系统建立一个起点基线
-- 为第一次 B 规划提供"共识事实"
-- 防止一上来就大改而不知问题在哪
+- 为规划提供动因素材
+- 防止规划"拍脑袋"
+- 暂存超范围需求（待下版处理）
 `;
 }