prd-workflow-cli 1.4.0 → 2.0.0

package/commands/version.js

@@ -3,6 +3,7 @@ const path = require('path');
 const chalk = require('chalk');
 const confirm = require('./confirm');
 const dialog = require('./dialog');
+const { runVersionFreezeChecks } = require('./freeze-checks');
 
 module.exports = async function (action, type, options = {}) {
     const configPath = path.join(process.cwd(), '.prd-config.json');
@@ -36,6 +37,17 @@ async function createVersionDoc(type, config, configPath) {
         `第${String(config.currentIteration).padStart(2, '0')}轮迭代`
     );
 
+    // 拦截废弃的文档类型
+    if (type === 'C0') {
+        console.log(chalk.red('❌ C0 已废弃。请直接创建 IT 用户故事。'));
+        return;
+    }
+    if (type === 'C1') {
+        console.log(chalk.red('❌ C1 已废弃。请使用 "prd it create" 替代。'));
+        console.log(chalk.cyan('运行: prd it create "需求名称"'));
+        return;
+    }
+
     // C 类文档必须先有 B3
     const b3Path = path.join(iterationDir, 'B3_规划冻结归档.md');
     if (!await fs.pathExists(b3Path)) {
@@ -64,13 +76,13 @@ async function createVersionDoc(type, config, configPath) {
         return;
     }
 
-    // C1 需要先有 C0
+    // C1 现在已包含版本范围声明（原 C0 内容），不再强制要求先创建 C0
+    // 但检查 C0 是否存在，如果存在则提示已有
     if (type === 'C1') {
         const c0Path = path.join(iterationDir, 'C0_版本范围声明.md');
-        if (!await fs.pathExists(c0Path)) {
-            console.log(chalk.red('✗ 请先创建 C0'));
-            console.log('运行: prd version create C0');
-            return;
+        if (await fs.pathExists(c0Path)) {
+            console.log(chalk.cyan('ℹ️  检测到 C0 已存在，C1 已包含版本范围声明部分'));
+            console.log(chalk.gray('   提示：新版 C1 已合并 C0 内容，你可以直接在 C1 中填写版本范围\n'));
         }
     }
 
@@ -101,35 +113,31 @@ async function createVersionDoc(type, config, configPath) {
         console.log('2. 创建 C1: prd version create C1');
     } else if (type === 'C1') {
         console.log(chalk.bold('⚠️  重要提醒:\n'));
+        console.log(chalk.green('📋 新版 C1 已包含版本范围声明（原 C0 内容）'));
+        console.log(chalk.gray('   无需单独创建 C0，直接在 C1 中填写版本范围和详细需求\n'));
+
         console.log(chalk.yellow('【PM 职责】'));
-        console.log('- 确认需求是否准确');
-        console.log('- 确认需求是否完整\n');
+        console.log('- 填写版本范围声明（第 1 章节）');
+        console.log('- 确认需求是否准确完整');
+        console.log('- 定义验收标准\n');
 
         console.log(chalk.cyan('【AI 职责】'));
-        console.log('- 拆分为清单');
-        console.log('- 校验可验证性');
+        console.log('- 基于 B2 拆分需求清单');
+        console.log('- 校验需求可验证性');
         console.log('- 标注来源关系\n');
 
         console.log(chalk.red('【AI 禁止】'));
-        console.log('- ❌ 引入规划外需求\n');
+        console.log('- ❌ 引入 B3 规划外需求\n');
 
         console.log(chalk.bold('下一步:'));
-        console.log('1. PM 填写 C1_版本需求清单.md');
-        console.log('2. 执行 R2 审视: prd review r2');
+        console.log('1. PM 填写 C1_版本需求清单.md（包含版本范围 + 详细需求）');
+        console.log('2. 完成后执行冻结: prd version freeze');
         console.log('');
-        console.log(chalk.bold.red('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-        console.log(chalk.bold.red('🚨 关键步骤：C1 填写完成后必须执行 R2 审视'));
-        console.log(chalk.bold.red('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+        console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+        console.log(chalk.bold.green('✨ 简化流程：C1 填写完成后直接运行 prd version freeze'));
+        console.log(chalk.bold.green('   程序会自动执行 R2 审视，通过后完成冻结'));
+        console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
         console.log('');
-        console.log(chalk.yellow('  R2 审视将检查：'));
-        console.log('  1. ✅ 一致性检查：C1 是否忠实于 B3/B2/C0');
-        console.log('  2. ✅ 范围检查：是否有超出当前版本的需求');
-        console.log('  3. ✅ 用户视角审查：站在用户角度评估需求');
-        console.log('     - 用户感知是否良好？');
-        console.log('     - 是否解决了用户真正的问题？');
-        console.log('     - 用户使用时会满意吗？');
-        console.log('');
-        console.log(chalk.gray('提示：没有 R2 审视报告，无法执行 prd version freeze'));
     } else if (type === 'C2') {
         console.log(chalk.bold('⚠️  重要提醒：\n'));
         console.log(chalk.yellow('【C2 用途】'));
@@ -159,40 +167,44 @@ async function freezeVersion(config, configPath, options = {}) {
         `第${String(config.currentIteration).padStart(2, '0')}轮迭代`
     );
 
-    // 检查 B3, C0, C1 是否存在
-    const b3Path = path.join(iterationDir, 'B3_规划冻结归档.md');
-    const c0Path = path.join(iterationDir, 'C0_版本范围声明.md');
-    const c1Path = path.join(iterationDir, 'C1_版本需求清单.md');
+    // ===== 新流程：自动执行前置检查 =====
 
-    if (!await fs.pathExists(b3Path)) {
-        console.log(chalk.red('✗ 请先完成规划冻结 (B3)'));
-        return;
+    // 支持 --force 跳过检查
+    if (options.force) {
+        console.log(chalk.yellow('\n⚠️  使用 --force 跳过前置检查\n'));
+    } else {
+        // 执行自动检查（包含 R2 审视）
+        const checkResult = await runVersionFreezeChecks(iterationDir);
+
+        if (!checkResult.pass) {
+            console.log(chalk.yellow('💡 提示：解决以上问题后重新运行 prd version freeze'));
+            console.log(chalk.gray('   或使用 prd version freeze --force 强制跳过检查（不推荐）\n'));
+            return;
+        }
     }
 
-    if (!await fs.pathExists(c0Path) || !await fs.pathExists(c1Path)) {
-        console.log(chalk.red('✗ 请先完成 C0 和 C1'));
-        return;
+    // ===== 检查通过，继续冻结流程 =====
+
+    // 检查规划冻结是否存在（支持新旧文件名）
+    let freezePath = path.join(iterationDir, '规划冻结.md');
+    if (!await fs.pathExists(freezePath)) {
+        freezePath = path.join(iterationDir, 'B3_规划冻结归档.md');
     }
 
-    // 检查 R2 审视是否通过
-    const r2ReviewPath = path.join(iterationDir, 'R2_版本审视报告.md');
-    if (!await fs.pathExists(r2ReviewPath)) {
-        console.log(chalk.red('✗ 请先完成 R2 版本审视'));
-        console.log('运行: prd review r2');
+    if (!await fs.pathExists(freezePath)) {
+        console.log(chalk.red('✗ 请先完成规划冻结'));
+        console.log('运行: prd plan freeze');
         return;
     }
 
-    // 读取 R2 审视结论
-    const r2Content = await fs.readFile(r2ReviewPath, 'utf-8');
-    const hasPassed = r2Content.includes('- [x] ✅ 通过') || r2Content.includes('[x] 通过');
-
-    if (!hasPassed) {
-        console.log(chalk.red('✗ R2 审视未通过，不能冻结版本'));
-        console.log(chalk.yellow('请修改 C0/C1 后重新执行 R2 审视'));
+    // 检查 IT 是否存在
+    const itDirCheck = path.join(iterationDir, 'IT');
+    if (!await fs.pathExists(itDirCheck)) {
+        console.log(chalk.red('✗ 请先创建 IT 用户故事'));
         return;
     }
 
-    // ⭐ 支持预确认模式：PM 已在对话中确认并提供签名
+    // PM 确认冻结
     let pmSignature = null;
     if (options.pmConfirmed && options.pmSignature) {
         console.log(chalk.green(`✓ PM 已在对话中确认版本冻结，签名: ${options.pmSignature}`));
@@ -207,65 +219,82 @@ async function freezeVersion(config, configPath, options = {}) {
         return;
     }
 
-    // ⭐ 读取 C0、C1、R2 内容，提取关键信息
-    console.log(chalk.gray('正在从 C0/C1/R2 提取关键信息...'));
-
-    const c0Content = await fs.readFile(c0Path, 'utf-8');
-    const c1Content = await fs.readFile(c1Path, 'utf-8');
-
-    // 提取 C0 版本目标
-    let c0VersionGoal = extractSection(c0Content, '版本目标') ||
-        extractSection(c0Content, '核心问题') ||
-        '（请手动填写，未能自动提取）';
-
-    // 提取 C0 版本范围
-    let c0Scope = extractSection(c0Content, '包含范围') ||
-        extractSection(c0Content, '版本包含') ||
-        '（请手动填写，未能自动提取）';
-
-    // 统计 C1 需求数量
-    const p0Count = (c1Content.match(/优先级[:\s]*P0/gi) || []).length;
-    const p1Count = (c1Content.match(/优先级[:\s]*P1/gi) || []).length;
-    const p2Count = (c1Content.match(/优先级[:\s]*P2/gi) || []).length;
-    const reqCount = (c1Content.match(/需求\s*#\d+|REQ-\d+/gi) || []).length || (p0Count + p1Count + p2Count);
-
-    // 提取 R2 审视摘要
-    let r2Summary = '';
-    const r2Sections = ['版本目标一致性', '版本范围偏移检查', '规划覆盖完整性', '需求粒度成熟度', '进入执行准备度'];
-    for (const section of r2Sections) {
-        const sectionContent = extractSection(r2Content, section);
-        if (sectionContent && sectionContent.length > 10) {
-            r2Summary += `- ${section}: ${sectionContent.substring(0, 80)}...\n`;
+    // ⭐ 读取 IT 内容，提取关键信息
+    console.log(chalk.gray('正在从 IT 文档提取关键信息...'));
+
+    const itDir = path.join(iterationDir, 'IT');
+    const itFolders = (await fs.readdir(itDir)).filter(name => name.startsWith('IT-'));
+
+    let itSummaries = '';
+    let totalReqCount = itFolders.length;
+    let p0Count = 0;
+    let p1Count = 0;
+    let p2Count = 0;
+    let versionGoal = '';
+
+    for (const folder of itFolders) {
+        const itPath = path.join(itDir, folder);
+        const itId = folder.split('-').slice(0, 2).join('-');
+
+        // 读取业务需求文档（支持新旧文件名）
+        let bizPath = path.join(itPath, '业务需求.md');
+        if (!await fs.pathExists(bizPath)) {
+            bizPath = path.join(itPath, `${itId}-BIZ.md`);
         }
+        let bizContent = '';
+        if (await fs.pathExists(bizPath)) {
+            bizContent = await fs.readFile(bizPath, 'utf-8');
+        }
+
+        // 提取 IT 标题
+        const titleMatch = bizContent.match(/^# (IT-\d+ .*?) -/);
+        const title = titleMatch ? titleMatch[1] : folder;
+
+        // 提取优先级
+        if (/P0/i.test(bizContent)) p0Count++;
+        else if (/P1/i.test(bizContent)) p1Count++;
+        else p2Count++; // 默认为 P2
+
+        // 提取用户故事摘要
+        const storyMatch = bizContent.match(/### 1. 用户故事\s*\n([\s\S]*?)(?=\n##|$)/);
+        const story = storyMatch ? storyMatch[1].trim().split('\n')[0] : '（无在 BIZ 中找到用户故事）';
+
+        itSummaries += `### ${title}\n\n`;
+        itSummaries += `**用户故事**: ${story}\n\n`;
+        itSummaries += `**文档位置**: IT/${folder}/\n\n`;
     }
-    if (!r2Summary) {
-        r2Summary = '（请参考 R2_版本审视报告.md）';
-    }
 
-    // 生成 C3（传入提取的内容）
-    const c3Template = getC3Template(pmSignature, {
-        c0VersionGoal,
-        c0Scope,
-        reqCount,
+    // 从规划冻结提取版本目标
+    const freezeContent = await fs.readFile(freezePath, 'utf-8');
+    versionGoal = extractSection(freezeContent, '核心问题') || '请参考规划冻结文档';
+
+    // 审视归档说明
+    const reviewSummary = '本次冻结执行了自动化版本审视，检查了所有 IT 文档的完整性与一致性。';
+
+    // 生成版本发布文档
+    const releaseTemplate = getReleaseTemplate(pmSignature, {
+        versionGoal,
+        totalReqCount,
         p0Count,
         p1Count,
         p2Count,
-        r2Summary
+        itSummaries,
+        reviewSummary
     });
-    const c3Path = path.join(iterationDir, 'C3_版本冻结归档.md');
-    await fs.writeFile(c3Path, c3Template);
+    const releasePath = path.join(iterationDir, '版本发布.md');
+    await fs.writeFile(releasePath, releaseTemplate);
 
     // 记录 PM 决策和文档创建
-    await dialog.logPMConfirmation('version', 'freeze_c3', 'approved',
+    await dialog.logPMConfirmation('version', 'freeze', 'approved',
         `PM签名: ${pmSignature}, 版本冻结`
     );
-    await dialog.logDocumentCreation('version', 'C3', c3Path);
+    await dialog.logDocumentCreation('version', '版本发布', releasePath);
 
-    console.log(chalk.green('\n✓ C3_版本冻结归档.md 创建成功!'));
-    console.log(chalk.cyan(`文件位置: ${c3Path}\n`));
+    console.log(chalk.green('\n✓ 版本发布.md 创建成功!'));
+    console.log(chalk.cyan(`文件位置: ${releasePath}\n`));
 
-    console.log(chalk.bold.green('🎉 版本已冻结!产品需求阶段完成!\n'));
-    console.log(chalk.bold('✅ 本轮迭代已完成,可以：'));
+    console.log(chalk.bold.green('🎉 版本已冻结！产品需求阶段完成！\n'));
+    console.log(chalk.bold('✅ 本轮迭代已完成，可以：'));
     console.log('1. 将冻结的需求交付给研发团队');
     console.log('2. 开始下一轮迭代: prd iteration new');
     console.log('3. 查看项目状态: prd status');
@@ -419,31 +448,66 @@ function getC1Template() {
 ## 文档说明
 
 **目的**: 
+- 声明本版本的范围边界
 - 详细列出所有版本需求
 - 定义验收标准
 - 作为研发的输入
 
 **填写要求**:
-- 每个需求必须可在 B2/C0 中找到来源
+- 版本范围必须基于 B3 冻结的规划
+- 每个需求必须可在 B2 中找到来源
 - 必须有明确的验收条件
 - 禁止引入规划外的需求
 
 ---
 
-## 1. 需求列表
+## 1. 版本范围声明
+
+### 1.1 版本定位
+
+**版本编号**: v______
+**计划发布时间**: ______
+
+**本版本解决的核心问题**:
+<!-- 引用 B1/B3 中的规划目标 -->
+
+### 1.2 版本范围
+
+**本版本包含的功能**:
+1. 
+2. 
+3. 
+
+**对应 B2 中的需求项**:
+- 需求项 #__: ______
+- 需求项 #__: ______
+
+**本版本明确不包含**:
+1. 
+2. 
+3. 
+
+**不包含的原因**:
+- 延后到后续版本
+- 不在 B3 规划范围
+- 资源/时间限制
+
+---
+
+## 2. 详细需求清单
 
-### 需求 #1
+### REQ-001 需求标题
 
-**需求标题**: 
 **需求编号**: REQ-001
-**来源**: B2 需求项 #__ / C0 功能__
+**来源**: B2 需求项 #__
+**优先级**: P0 / P1 / P2
+
+**需求背景**:
+<!-- 用户痛点/业务目标 -->
 
 **需求描述**:
 <!-- 详细描述需求 -->
 
-**业务目标**:
-<!-- 该需求解决什么业务问题 -->
-
 **核心规则**:
 1. 
 2. 
@@ -454,76 +518,65 @@ function getC1Template() {
 - [ ] 标准2
 - [ ] 标准3
 
-**优先级**: P0 / P1 / P2
+**边界情况**:
+<!-- 异常处理、特殊情况 -->
 
 ---
 
-### 需求 #2
+### REQ-002 需求标题
 
-<!-- 继续列举其他需求 -->
+<!-- 继续列举其他需求，使用相同格式 -->
 
 ---
 
-## 2. 需求关系
+## 3. 需求关系
 
-### 2.1 依赖关系
+### 3.1 依赖关系
 
-**需求 #1 依赖**:
+**需求 REQ-001 依赖**:
 - 依赖需求: REQ-___
-- 依赖功能: (引用 A1)
+- 依赖现有功能: (引用 A1)
 
-### 2.2 互斥关系
+### 3.2 互斥关系
 
 **互斥需求**:
 <!-- 如果某些需求不能同时满足，说明原因 -->
 
 ---
 
-## 3. 非功能需求
+## 4. 非功能需求
 
-### 3.1 性能要求
+### 4.1 性能要求
 
 **响应时间**: 
 **并发量**: 
 
-### 3.2 安全要求
+### 4.2 安全要求
 
 **权限控制**: 
 **数据安全**: 
 
 ---
 
-## 4. 边界情况
-
-### 4.1 异常处理
-
-**异常场景1**: 
-- 触发条件: 
-- 期望行为: 
-
-### 4.2 边界值
-
-**边界条件**: 
-<!-- 列出关键的边界值和处理方式 -->
-
----
-
 ## 5. 验收总览
 
-### 5.1 需求完整性
+### 5.1 需求完整性检查
 
-- [ ] 所有需求均来自 B2/C0
+- [ ] 版本范围已明确，不超出 B3
+- [ ] 所有需求均来自 B2
 - [ ] 每个需求都有验收标准
 - [ ] 依赖关系已标注
 - [ ] 边界情况已说明
 
-### 5.2 PM 确认
+### 5.2 版本统计
 
 **总需求数**: ______
 **P0 需求数**: ______
 **P1 需求数**: ______
 **P2 需求数**: ______
 
+### 5.3 PM 确认
+
 **PM 签字**: _____________
 **日期**: _____________
 
@@ -639,28 +692,28 @@ function extractSection(content, sectionTitle) {
     return null;
 }
 
-function getC3Template(pmSignature, extractedContent = {}) {
+function getReleaseTemplate(pmSignature, extractedContent = {}) {
     const {
-        c0VersionGoal = '（未提供）',
-        c0Scope = '（未提供）',
-        reqCount = 0,
+        versionGoal = '（未提供）',
+        totalReqCount = 0,
         p0Count = 0,
         p1Count = 0,
         p2Count = 0,
-        r2Summary = '（未提供）'
+        itSummaries = '（无用户故事）',
+        reviewSummary = '（未提供）'
     } = extractedContent;
 
-    return `# C3_版本冻结归档
+    return `# 版本发布
 
 **冻结时间**: ${new Date().toLocaleString('zh-CN')}
 **PM 签名**: ${pmSignature}
-**文档状态**: 已冻结 ✅
+**状态**: 已冻结 ✅
 
 ---
 
 ## 冻结声明
 
-本版本需求已通过 R2 审视，正式冻结。
+本版本需求已通过自动化审视，正式冻结。
 
 **冻结承诺**:
 - 产品需求阶段完成
@@ -673,79 +726,52 @@ function getC3Template(pmSignature, extractedContent = {}) {
 
 ### 1.1 版本目标
 
-**来自 C0 的版本目标**:
-
-${c0VersionGoal}
+${versionGoal}
 
-### 1.2 版本范围
+### 1.2 需求概览
 
-**来自 C0 的范围说明**:
+**IT 用户故事统计**:
+- 总故事数: ${totalReqCount}
+- P0 故事: ${p0Count}
+- P1 故事: ${p1Count}
+- P2 故事: ${p2Count}
 
-${c0Scope}
+---
 
-### 1.3 需求清单
+## 2. 需求清单
 
-**来自 C1 的需求统计**:
-- 总需求数: ${reqCount || '（请手动统计）'}
-- P0 需求: ${p0Count}
-- P1 需求: ${p1Count}
-- P2 需求: ${p2Count}
+${itSummaries}
 
 ---
 
-## 2. R2 审视结论
-
-### 2.1 审视结果
-
-**R2 审视状态**: ✅ 通过
+## 3. 审视结论
 
+**审视状态**: ✅ 通过
 **通过时间**: ${new Date().toLocaleString('zh-CN')}
 
 **审视摘要**:
+${reviewSummary}
 
-${r2Summary}
-
-### 2.2 一致性确认
-
-**与 B3 规划的一致性**:
+**与规划的一致性**:
 - ✅ 未背叛规划
-- ✅ 未超出 B3 范围
-- ✅ 需求可追溯到 B2
+- ✅ 未超出规划范围
+- ✅ 需求可追溯
 
 ---
 
-## 3. 交付清单
+## 4. 交付清单
 
-### 3.1 关键文档
+**用户故事文档**:
+- 包含 ${totalReqCount} 个独立的用户故事文档（业务需求.md）
 
-**基线文档**:
-- A0: 产品基础与范围说明
-- A1: 已上线功能清单
-- A2: 存量反馈汇总
-
-**规划文档**:
-- B1: 需求规划草案
-- B2: 规划拆解与范围界定
-- B3: 规划冻结归档
-- R1: 规划审视报告
-
-**版本文档**:
-- C0: 版本范围声明
-- C1: 版本需求清单
-- R2: 版本审视报告
-
-### 3.2 交付物
-
-**可交付给研发的文档**:
-- ✅ C1_版本需求清单.md (主要依据)
-- ✅ C0_版本范围声明.md (边界参考)
-- ✅ B3_规划冻结归档.md (背景理解)
+**技术规格文档**:
+- 包含 ${totalReqCount} 个对应的技术规格文档（技术规格.md）
 
 ---
 
-## 4. 冻结管理
+## 5. 冻结管理
 
-### 4.1 修改规则
+### 5.1 修改规则
 
 **冻结后禁止**:
 - ❌ 修改需求内容
@@ -757,38 +783,34 @@ ${r2Summary}
 - ✅ UI/UX 设计细节
 - ✅ 测试用例
 
-### 4.2 变更流程
+### 5.2 变更流程
 
 **如需变更需求**:
-1. 运行 prd change 记录变更
-2. 创建 C2_版本变更说明.md
-3. 评估是否需要重新执行 R2 审视
-4. PM 重新签字确认
+1. 评估变更影响
+2. PM 重新签字确认
+3. 更新版本发布文档
 
 ---
 
-## 5. 下一步
+## 6. 下一步
 
-### 5.1 研发阶段
+### 6.1 研发阶段
 
 **可以启动**:
 - 技术方案设计
 - 架构评审
 - 开发排期
 
-### 5.2 后续迭代
+### 6.2 后续迭代
 
 **如需新的迭代**:
 1. 运行: prd iteration new
-2. 重新执行 A → R → B → C 流程
-3. 基于本次迭代的经验优化
+2. 重新执行 基线 → 规划 → IT → 版本 流程
 
 ---
 
 **PM 最终确认**: ${pmSignature}
 **冻结日期**: ${new Date().toLocaleDateString('zh-CN')}
-**状态**: 🔒 已冻结
 **产品需求阶段**: ✅ 完成
 `;
 }
-

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "prd-workflow-cli",
-  "version": "1.4.0",
-  "description": "产品需求管理规范 CLI 工具 - 基于 A→R→B→C 流程，集成 PM 确认机制和对话归档的需求管理命令行工具",
+  "version": "2.0.0",
+  "description": "产品需求管理规范 CLI 工具 - 基于 基线→规划→IT→版本 流程的需求管理命令行工具",
   "main": "index.js",
   "bin": {
     "prd": "./bin/prd-cli.js"