prd-workflow-cli 1.1.30 → 1.1.33

package/.antigravity/rules.md

@@ -15,6 +15,7 @@
 6. ❌ 禁止跳过审视 → B2 后必须 R1，C1 后必须 R2
 7. ❌ 禁止 R1 直接输出"通过" → 必须有分析和评估矩阵
 8. ❌ 禁止创建迭代后直接创建 B1 → 必须先填写 R1 启动检查
+9. ❌ 禁止在 C0 无视 B2 的版本划分 → 如果 B2 有多批次，C0 只包含首批
 ```
 
 **R1 有两个阶段**：
@@ -56,6 +57,53 @@
 
 ---
 
+## 🔢 版本划分规则（C0 阶段必读！）
+
+**如果 PM 在 B2 决定分多个批次/小版本交付，C0 只能包含首批内容！**
+
+### AI 必须在 C0 阶段检查 B2 的版本划分
+
+```
+AI: "在填写 C0 之前，让我检查 B2 的版本划分：
+
+     [读取 B2 的开发批次部分]
+     
+     📊 B2 版本划分：
+     - 第 1 批：需求 #1, #2, #3
+     - 第 2 批：需求 #4, #5
+     - 第 3 批：需求 #6, #7, #8
+     
+     ✅ 确认：本次 C0 只包含第 1 批（#1, #2, #3）"
+```
+
+### ❌ 绝对禁止
+
+```
+PM 在 B2 说："分 3 个版本交付"
+AI 在 C0 写："本版本包含所有 B2 需求" ← 严重错误！
+```
+
+### 🔄 多批次交付的完整流程（重要！）
+
+**每个批次都是一个完整的版本，必须走完整的 C0 → C1 → R2 → C3 流程！**
+
+```
+📦 B2 规划了 3 个批次的交付：
+
+第 1 批（v1.0）：C0 → C1 → R2 → C3（冻结交付）
+        ↓
+第 2 批（v1.1）：C0 → C1 → R2 → C3（冻结交付）
+        ↓
+第 3 批（v1.2）：C0 → C1 → R2 → C3（冻结交付）
+```
+
+**规则：**
+- ✅ 每批次独立 C0/C1/R2/C3
+- ❌ 禁止跳过 R2（"小版本不需要审视"是错误的）
+- ❌ 禁止跳过 C3（"先开发之后再冻结"是错误的）
+
+---
+
 ## ⚙️ 分段写入规则（从 prd-incremental-save.md 合并）
 
 ### 铁律：确认一个，写入一个

package/.cursorrules

@@ -13,6 +13,7 @@
 6. ❌ 禁止跳过审视 → B2 后必须 R1，C1 后必须 R2
 7. ❌ 禁止 R1 直接输出"通过" → 必须有 5 维度分析和评估矩阵
 8. ❌ 禁止创建迭代后直接创建 B1 → 必须先引导 PM 填写 R1 启动检查
+9. ❌ 禁止在 C0 无视 B2 的版本划分 → 如果 B2 有多批次，C0 只包含首批
 ```
 
 **R1 有两个阶段**：
@@ -54,6 +55,94 @@
 
 ---
 
+## 🔢 版本划分规则（C0 阶段必读！）
+
+### ⚠️ 核心原则：尊重 B2 的批次划分
+
+**如果 PM 在 B2 决定分多个批次/小版本交付，C0 只能包含首批内容！**
+
+### AI 必须在 C0 阶段执行的检查
+
+```
+AI: "在填写 C0 之前，让我检查 B2 的版本划分：
+
+     [读取 B2 的开发批次部分]
+     
+     📊 B2 版本划分：
+     - 第 1 批：需求 #1, #2, #3
+     - 第 2 批：需求 #4, #5
+     - 第 3 批：需求 #6, #7, #8
+     
+     ✅ 确认：本次 C0 只包含第 1 批（#1, #2, #3）
+     
+     第 2、3 批将在后续版本的 C0 中处理。
+     
+     是否确认？"
+```
+
+### ❌ 错误行为（绝对禁止！）
+
+```
+PM 在 B2 说："分 3 个版本交付"
+AI 在 C0 写："本版本包含所有 B2 需求" ← 严重错误！
+```
+
+### ✅ 正确行为
+
+```
+PM 在 B2 说："分 3 个版本交付"
+AI 在 C0 写："本版本只包含第 1 批：需求 #1, #2, #3"
+           "第 2、3 批在后续版本处理"
+```
+
+### 🔄 多批次交付的完整流程（重要！）
+
+**每个批次都是一个完整的版本，必须走完整的 C0 → C1 → R2 → C3 流程！**
+
+```
+📦 B2 规划了 3 个批次的交付：
+
+┌─────────────────────────────────────────────────────────┐
+│ 第 1 批（v1.0）                                          │
+│   C0_v1.0 → C1_v1.0 → R2_v1.0 → C3_v1.0（冻结交付）     │
+└─────────────────────────────────────────────────────────┘
+                          ↓
+┌─────────────────────────────────────────────────────────┐
+│ 第 2 批（v1.1）                                          │
+│   C0_v1.1 → C1_v1.1 → R2_v1.1 → C3_v1.1（冻结交付）     │
+└─────────────────────────────────────────────────────────┘
+                          ↓
+┌─────────────────────────────────────────────────────────┐
+│ 第 3 批（v1.2）                                          │
+│   C0_v1.2 → C1_v1.2 → R2_v1.2 → C3_v1.2（冻结交付）     │
+└─────────────────────────────────────────────────────────┘
+```
+
+**AI 必须遵守：**
+
+| 规则 | 说明 |
+|-----|------|
+| ✅ 每批次独立 C0 | 每个批次有自己的版本范围声明 |
+| ✅ 每批次独立 C1 | 每个批次有自己的需求清单 |
+| ✅ 每批次独立 R2 | 每个批次必须经过版本审视 |
+| ✅ 每批次独立 C3 | 每个批次必须冻结后才能交付 |
+| ❌ 禁止跳过 R2 | 不能说"小版本不需要审视" |
+| ❌ 禁止跳过 C3 | 不能说"先开发，之后再冻结" |
+
+**当第 1 批 C3 冻结后，AI 应提示：**
+
+```
+AI: "✅ 第 1 批（v1.0）已完成 C3 冻结，可以交付开发。
+
+     📋 下一步：开始第 2 批（v1.1）的版本流程
+     
+     运行：prd version create C0
+     
+     第 2 批将包含：需求 #4, #5（来自 B2 规划）"
+```
+
+---
+
 ## ⚙️ 分段写入规则（从 prd-incremental-save.md 合并）
 
 ### 铁律：确认一个，写入一个

package/README.md

@@ -55,45 +55,62 @@ C3(版本冻结)
 
 ## 🚀 安装
 
-### 方式1：从 GitHub 安装（推荐）
+### 方式1：一键初始化（推荐）✨
+
+只需一个命令，**自动完成初始化并配置 AI 规则文件**：
 
 ```bash
-# 全局安装
-npm install -g github:houtonghoutong/PRD-CLI#main
+# 1. 创建并进入项目目录
+mkdir 我的项目 && cd 我的项目
 
-# 或使用 yarn
-yarn global add github:houtonghoutong/PRD-CLI#main
+# 2. 一键初始化（自动配置一切！）
+npx prd-workflow-cli
 ```
 
-### 方式2：从源码安装
-
-```bash
-# 1. 克隆仓库
-git clone https://github.com/houtonghoutong/PRD-CLI.git
-cd PRD-CLI/prd-cli
+就这样！运行后你会看到：
+- ✅ `.agent/workflows/` - PRD 工作流指引
+- ✅ `.cursorrules` - Cursor AI 规则
+- ✅ `.antigravity/` - Antigravity AI 规则
 
-# 2. 安装依赖
-npm install
+> 💡 **现在你的 AI 助手已经知道如何协助你完成 PRD 流程了！**
+> 例如：直接告诉 AI "我要创建一个新项目的需求文档"
 
-# 3. 全局链接
-npm link
-```
+### 方式2：全局安装
 
-### 方式3：npm 安装（即将上线）
+如果你经常使用，可以全局安装：
 
 ```bash
-# 稍后可用
 npm install -g prd-workflow-cli
+
+# 然后使用
+prd init 我的项目
+cd 我的项目
+npm install   # 重要！这一步会安装 AI 规则文件
 ```
 
+### 方式3：从源码安装
+
+```bash
+git clone https://github.com/houtonghoutong/PRD-CLI.git
+cd PRD-CLI/prd-cli
+npm install
+npm link
+```
 
 ## 📝 快速开始
 
 ### 1. 初始化项目
 
 ```bash
+# 使用 npx（推荐）
+npx prd-workflow-cli init my-product
+cd my-product
+npm install
+
+# 或者全局安装后使用
 prd init my-product
 cd my-product
+npm install
 ```
 
 这将创建标准的目录结构:

package/bin/prd-cli.js

@@ -126,9 +126,28 @@ program.on('--help', () => {
   console.log('');
 });
 
-program.parse(process.argv);
-
-// 如果没有参数，显示帮助
-if (!process.argv.slice(2).length) {
-  program.outputHelp();
+// 智能处理：无参数时自动初始化
+if (process.argv.length === 2) {
+  const fs = require('fs');
+  const path = require('path');
+  const configPath = path.join(process.cwd(), '.prd-config.json');
+
+  if (!fs.existsSync(configPath)) {
+    // 不是 PRD 项目，自动初始化
+    console.log(chalk.blue('📦 检测到当前目录尚未初始化 PRD 项目'));
+    console.log(chalk.blue('🚀 正在自动初始化...'));
+    console.log('');
+    require('../commands/init')('.').then(() => {
+      process.exit(0);
+    }).catch((err) => {
+      console.error(chalk.red('初始化失败:'), err.message);
+      process.exit(1);
+    });
+  } else {
+    // 已经是 PRD 项目，显示帮助
+    program.parse(process.argv);
+    program.outputHelp();
+  }
+} else {
+  program.parse(process.argv);
 }

package/commands/init.js

@@ -346,6 +346,17 @@ prd plan freeze
 
         console.log(chalk.green('✓ 项目创建成功!'));
         console.log('');
+
+        // 显示 AI 集成信息
+        console.log(chalk.bold('🤖 AI 集成已配置:'));
+        console.log(chalk.gray('   ✓ .agent/workflows/  - PRD 工作流指引（包含所有阶段的详细步骤）'));
+        console.log(chalk.gray('   ✓ .cursorrules       - Cursor AI 规则'));
+        console.log(chalk.gray('   ✓ .antigravity/      - Antigravity AI 规则'));
+        console.log('');
+        console.log(chalk.yellow('   💡 现在你可以直接与 AI 助手对话，AI 已经知道如何协助你完成 PRD 流程！'));
+        console.log(chalk.gray('   例如：告诉 AI "我要创建一个新项目的需求文档"'));
+        console.log('');
+
         console.log(chalk.bold('📋 下一步操作（请按顺序执行）:'));
         console.log('');
         if (!isCurrentDir) {

package/package.json

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

package/scripts/postinstall.js

@@ -117,7 +117,35 @@ function main() {
 
         // 检查是否是全局安装
         if (isGlobalInstall(packagePath)) {
-            debug('检测到全局安装，跳过文件复制');
+            debug('检测到全局安装，显示使用说明');
+
+            // 全局安装时输出使用说明
+            console.log('');
+            console.log('╔════════════════════════════════════════════════════════════════╗');
+            console.log('║           🎉 prd-workflow-cli 安装成功！                       ║');
+            console.log('╠════════════════════════════════════════════════════════════════╣');
+            console.log('║                                                                ║');
+            console.log('║  📋 快速开始：                                                  ║');
+            console.log('║                                                                ║');
+            console.log('║     1. 创建新项目:                                             ║');
+            console.log('║        prd init 我的项目                                       ║');
+            console.log('║        cd 我的项目                                             ║');
+            console.log('║                                                                ║');
+            console.log('║     2. 或在现有目录初始化:                                      ║');
+            console.log('║        cd 现有目录                                             ║');
+            console.log('║        prd init .                                              ║');
+            console.log('║                                                                ║');
+            console.log('║  📖 查看帮助: prd --help                                       ║');
+            console.log('║                                                                ║');
+            console.log('║  🤖 AI 集成说明:                                               ║');
+            console.log('║     初始化后会自动创建 AI 规则文件:                             ║');
+            console.log('║     - .agent/workflows/  PRD 工作流指引                        ║');
+            console.log('║     - .cursorrules       Cursor AI 规则                        ║');
+            console.log('║     - .antigravity/      Antigravity AI 规则                   ║');
+            console.log('║                                                                ║');
+            console.log('╚════════════════════════════════════════════════════════════════╝');
+            console.log('');
+
             return;
         }