prd-workflow-cli 1.1.29 → 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

@@ -3,16 +3,25 @@ const path = require('path');
 const chalk = require('chalk');
 
 module.exports = async function (projectName) {
-    const projectPath = path.join(process.cwd(), projectName);
+    // 支持 "." 表示在当前目录初始化
+    const isCurrentDir = projectName === '.';
+    const projectPath = isCurrentDir ? process.cwd() : path.join(process.cwd(), projectName);
+    const displayName = isCurrentDir ? path.basename(process.cwd()) : projectName;
 
     try {
-        // 检查目录是否已存在
-        if (await fs.pathExists(projectPath)) {
+        // 检查目录是否已存在（仅当创建新目录时）
+        if (!isCurrentDir && await fs.pathExists(projectPath)) {
             console.log(chalk.red(`✗ 目录 ${projectName} 已存在`));
             return;
         }
 
-        console.log(chalk.blue(`正在创建项目: ${projectName}...`));
+        // 检查当前目录是否已经是 PRD 项目
+        if (isCurrentDir && await fs.pathExists(path.join(projectPath, '.prd-config.json'))) {
+            console.log(chalk.red('✗ 当前目录已经是 PRD 项目'));
+            return;
+        }
+
+        console.log(chalk.blue(`正在${isCurrentDir ? '在当前目录' : '创建项目: ' + projectName}初始化...`));
 
         // 创建项目目录结构
         const directories = [
@@ -30,7 +39,7 @@ module.exports = async function (projectName) {
 
         // 创建项目配置文件
         const config = {
-            projectName,
+            projectName: displayName,
             createdAt: new Date().toISOString(),
             currentIteration: 0,
             workflow: 'A → R → B → C',
@@ -49,9 +58,9 @@ module.exports = async function (projectName) {
 
         // 创建 package.json（让其他用户可以通过 npm install 安装 CLI）
         const packageJson = {
-            name: projectName.toLowerCase().replace(/[^a-z0-9]/g, '-'),
+            name: displayName.toLowerCase().replace(/[^a-z0-9]/g, '-'),
             version: '1.0.0',
-            description: `${projectName} - PRD 需求管理项目`,
+            description: `${displayName} - PRD 需求管理项目`,
             private: true,
             scripts: {
                 prd: 'prd',
@@ -59,7 +68,7 @@ module.exports = async function (projectName) {
                 help: 'prd --help'
             },
             dependencies: {
-                'prd-workflow-cli': '^1.1.12'
+                'prd-workflow-cli': '^1.1.29'
             }
         };
 
@@ -73,7 +82,7 @@ module.exports = async function (projectName) {
         const p0Template = `# P0_项目基本信息
 
 **创建时间**: ${new Date().toLocaleString('zh-CN')}
-**项目名称**: ${projectName}
+**项目名称**: ${displayName}
 **文档状态**: 草案
 
 ---
@@ -96,7 +105,7 @@ module.exports = async function (projectName) {
 
 ### 1.1 项目定位
 
-**项目全称**: ${projectName}
+**项目全称**: ${displayName}
 
 **项目简述**:
 <!-- 一句话说明这个项目是什么 -->
@@ -259,14 +268,14 @@ module.exports = async function (projectName) {
         }
 
         // 创建 README
-        const readme = `# ${projectName}
+        const readme = `# ${displayName}
 
 本项目采用规范化的产品需求管理流程
 
 ## 📁 目录结构
 
 \`\`\`
-${projectName}/
+${displayName}/
 ├── 00_项目总览/          # 项目基本信息
 ├── 01_产品基线/          # A 类文档：现状基线
 ├── 02_迭代记录/          # 各轮迭代的 B、C 类文档
@@ -337,17 +346,32 @@ prd plan freeze
 
         console.log(chalk.green('✓ 项目创建成功!'));
         console.log('');
-        console.log(chalk.bold('📋 下一步操作（请按顺序执行）:'));
+
+        // 显示 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.cyan('第 1 步: 进入项目目录'));
-        console.log(`  cd ${projectName}`);
+        console.log(chalk.yellow('   💡 现在你可以直接与 AI 助手对话，AI 已经知道如何协助你完成 PRD 流程！'));
+        console.log(chalk.gray('   例如：告诉 AI "我要创建一个新项目的需求文档"'));
         console.log('');
-        console.log(chalk.cyan('第 2 步: 完善 P0_项目基本信息.md'));
+
+        console.log(chalk.bold('📋 下一步操作（请按顺序执行）:'));
+        console.log('');
+        if (!isCurrentDir) {
+            console.log(chalk.cyan('第 1 步: 进入项目目录'));
+            console.log(`  cd ${displayName}`);
+            console.log('');
+            console.log(chalk.cyan('第 2 步: 完善 P0_项目基本信息.md'));
+        } else {
+            console.log(chalk.cyan('第 1 步: 完善 P0_项目基本信息.md'));
+        }
         console.log(chalk.gray('  文件位置: 00_项目总览/P0_项目基本信息.md'));
         console.log(chalk.gray('  填写内容: 项目目标、干系人、约束条件等'));
         console.log(chalk.yellow('  ⚠️  必须完成 P0 填写后才能开始创建 A 类基线文档'));
         console.log('');
-        console.log(chalk.cyan('第 3 步: 创建 A0 基线文档'));
+        console.log(chalk.cyan(`第 ${isCurrentDir ? '2' : '3'} 步: 创建 A0 基线文档`));
         console.log('  prd baseline create A0  # P0 填写完成后执行');
         console.log('');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prd-workflow-cli",
-  "version": "1.1.29",
+  "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;
         }