prd-workflow-cli 1.1.30 → 1.1.31

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.31",
   "description": "产品需求管理规范 CLI 工具 - 基于 A→R→B→C 流程，集成 PM 确认机制和对话归档的需求管理命令行工具",
   "main": "index.js",
   "bin": {
@@ -70,4 +70,4 @@
       "/tests/"
     ]
   }
-}
+}

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;
         }