dev-playbooks-cn 1.5.4 → 1.5.6

package/README.md

@@ -97,6 +97,20 @@ dev-playbooks-cn init --tools claude --scope project  # 项目级
 dev-playbooks-cn init --tools claude --scope global   # 全局
 ```
 
+### 更新
+
+使用 `update` 命令同时更新 CLI 和项目中的 Skills：
+
+```bash
+dev-playbooks-cn update
+```
+
+更新命令会：
+1. **检查 CLI 新版本**：自动检测 npm 上是否有新版本，交互式询问是否更新
+2. **更新项目文件**：更新 Skills、规则文件、指令文件等
+
+> **提示**：不再需要手动运行 `npm install -g dev-playbooks-cn`，`update` 命令会自动处理。
+
 ### 快速集成
 
 DevBooks 使用两个目录根：
@@ -196,7 +210,6 @@ DevBooks 使用两个目录根：
 | Skill | 说明 |
 |-------|------|
 | `devbooks-archiver` | 规格维护与去重 |
-| `devbooks-delivery-workflow` | 完整交付闭环 |
 
 ### 独立技能
 
@@ -206,6 +219,14 @@ DevBooks 使用两个目录根：
 | `devbooks-brownfield-bootstrap` | 存量项目初始化 |
 | `devbooks-convergence-audit` | 收敛性审计（反迷惑设计） |
 
+### 编排层（支持子 Agent 的工具专用）
+
+| Skill | 说明 |
+|-------|------|
+| `devbooks-delivery-workflow` | 完整闭环编排器，自动编排 Proposal→Design→Spec→Plan→Test→Code→Review→Archive 全流程 |
+
+> **注意**：`devbooks-delivery-workflow` 是编排层 Skill，专为支持子 Agent 的 AI 编程工具（如 Claude Code with Task tool）设计。它会调用子 Agent 执行各阶段 Skill，完成完整的变更闭环。
+
 ---
 
 ## DevBooks 对比

package/bin/devbooks.js

@@ -7,7 +7,7 @@
  *
  * 用法：
  *   dev-playbooks-cn init [path] [options]
- *   dev-playbooks-cn update [path]
+ *   dev-playbooks-cn update [path]           # 更新 CLI 和已配置的工具
  *   dev-playbooks-cn migrate --from <framework> [options]
  *
  * 选项：
@@ -316,6 +316,70 @@ function getCliVersion() {
   }
 }
 
+/**
+ * 检查 npm 上是否有新版本
+ * @returns {Promise<{hasUpdate: boolean, latestVersion: string|null, currentVersion: string}>}
+ */
+async function checkNpmUpdate() {
+  const currentVersion = getCliVersion();
+  try {
+    const { execSync } = await import('child_process');
+    const latestVersion = execSync(`npm view ${CLI_COMMAND} version`, {
+      encoding: 'utf-8',
+      timeout: 10000,
+      stdio: ['pipe', 'pipe', 'pipe']
+    }).trim();
+
+    if (latestVersion && latestVersion !== currentVersion) {
+      // 简单版本比较（假设语义化版本）
+      const current = currentVersion.split('.').map(Number);
+      const latest = latestVersion.split('.').map(Number);
+      const hasUpdate = latest[0] > current[0] ||
+        (latest[0] === current[0] && latest[1] > current[1]) ||
+        (latest[0] === current[0] && latest[1] === current[1] && latest[2] > current[2]);
+      return { hasUpdate, latestVersion, currentVersion };
+    }
+    return { hasUpdate: false, latestVersion, currentVersion };
+  } catch {
+    // 网络错误或超时，静默忽略
+    return { hasUpdate: false, latestVersion: null, currentVersion };
+  }
+}
+
+/**
+ * 执行 npm 全局更新
+ * @returns {Promise<boolean>} 更新是否成功
+ */
+async function performNpmUpdate() {
+  return new Promise((resolve) => {
+    const spinner = ora(`正在更新 ${CLI_COMMAND}...`).start();
+    const child = spawn('npm', ['install', '-g', CLI_COMMAND], {
+      stdio: ['pipe', 'pipe', 'pipe'],
+      shell: true
+    });
+
+    let stderr = '';
+    child.stderr.on('data', (data) => {
+      stderr += data.toString();
+    });
+
+    child.on('close', (code) => {
+      if (code === 0) {
+        spinner.succeed(`${CLI_COMMAND} 已更新到最新版本`);
+        resolve(true);
+      } else {
+        spinner.fail(`更新失败: ${stderr || '未知错误'}`);
+        resolve(false);
+      }
+    });
+
+    child.on('error', (err) => {
+      spinner.fail(`更新失败: ${err.message}`);
+      resolve(false);
+    });
+  });
+}
+
 // ============================================================================
 // 自动更新 .gitignore 和 .npmignore
 // ============================================================================
@@ -1301,7 +1365,32 @@ async function updateCommand(projectDir) {
   console.log(chalk.bold('DevBooks 更新'));
   console.log();
 
-  // 检查是否已初始化
+  // 1. 检查 CLI 自身是否有新版本
+  const spinner = ora('检查 CLI 更新...').start();
+  const { hasUpdate, latestVersion, currentVersion } = await checkNpmUpdate();
+
+  if (hasUpdate) {
+    spinner.info(`发现新版本: ${currentVersion} → ${latestVersion}`);
+    const shouldUpdate = await confirm({
+      message: `是否更新 ${CLI_COMMAND} 到 ${latestVersion}?`,
+      default: true
+    });
+
+    if (shouldUpdate) {
+      const success = await performNpmUpdate();
+      if (success) {
+        console.log(chalk.blue('ℹ') + ` 请重新运行 \`${CLI_COMMAND} update\` 以更新项目文件。`);
+        return;
+      }
+      // 更新失败，继续更新本地文件
+    }
+  } else {
+    spinner.succeed(`CLI 已是最新版本 (v${currentVersion})`);
+  }
+
+  console.log();
+
+  // 2. 检查是否已初始化（更新项目文件）
   const configPath = path.join(projectDir, '.devbooks', 'config.yaml');
   if (!fs.existsSync(configPath)) {
     console.log(chalk.red('✗') + ` 未找到 DevBooks 配置。请先运行 \`${CLI_COMMAND} init\`。`);
@@ -1468,7 +1557,7 @@ function showHelp() {
   console.log();
   console.log(chalk.cyan('用法:'));
   console.log(`  ${CLI_COMMAND} init [path] [options]              初始化 DevBooks`);
-  console.log(`  ${CLI_COMMAND} update [path]                      更新已配置的工具`);
+  console.log(`  ${CLI_COMMAND} update [path]                      更新 CLI 和已配置的工具`);
   console.log(`  ${CLI_COMMAND} migrate --from <framework> [opts]  从其他框架迁移`);
   console.log();
   console.log(chalk.cyan('选项:'));
@@ -1522,7 +1611,7 @@ function showHelp() {
   console.log(`  ${CLI_COMMAND} init my-project             # 在 my-project 目录初始化`);
   console.log(`  ${CLI_COMMAND} init --tools claude,cursor  # 非交互式（默认项目级安装）`);
   console.log(`  ${CLI_COMMAND} init --tools claude --scope global  # 非交互式（全局安装）`);
-  console.log(`  ${CLI_COMMAND} update                      # 更新已配置的工具`);
+  console.log(`  ${CLI_COMMAND} update                      # 更新 CLI 和 Skills`);
   console.log(`  ${CLI_COMMAND} migrate --from openspec     # 从 OpenSpec 迁移`);
   console.log(`  ${CLI_COMMAND} migrate --from speckit      # 从 spec-kit 迁移`);
   console.log(`  ${CLI_COMMAND} migrate --from openspec --dry-run  # 模拟迁移`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-playbooks-cn",
-  "version": "1.5.4",
+  "version": "1.5.6",
   "description": "AI-driven spec-based development workflow",
   "keywords": [
     "devbooks",