ai-engineering-init 1.2.0 → 1.2.2

package/.claude/settings.json

@@ -37,5 +37,11 @@
       }
     ]
   },
-  "mcpServers": {}
+  "mcpServers": {
+    "codex": {
+      "command": "/Users/xujiajun/.nvm/versions/node/v20.19.6/bin/codex",
+      "args": ["mcp-server"],
+      "description": "OpenAI Codex CLI - 代码分析/算法实现/代码审查"
+    }
+  }
 }

package/README.md

@@ -2,6 +2,9 @@
 
 > 一键初始化 AI 工程化配置，支持 Claude Code、Cursor、OpenAI Codex 等主流 AI 开发工具。
 
+[![npm version](https://img.shields.io/npm/v/ai-engineering-init)](https://www.npmjs.com/package/ai-engineering-init)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+
 ## 快速开始
 
 ### 方式一：npx（推荐，无需克隆）
@@ -84,12 +87,21 @@ cd ai-engineering-init
 | `skills/` | Codex 技能配置 |
 | `AGENTS.md` | AI Agent 项目规范说明 |
 
-## Skills 列表（68个）
+> **MCP Server 支持**：Codex CLI 可通过 `codex mcp-server` 作为 MCP Server 暴露给 Claude Code，
+> 配置写入 `.claude/settings.json` 的 `mcpServers` 后，Claude 可直接调用 `codex` / `codex-reply` 工具进行代码审查。
+>
+> **Windows 用户注意**：初始化后需将 `.claude/settings.json` 中 `mcpServers.codex.command` 的路径改为 Windows 上的实际路径，例如：
+> ```json
+> "command": "C:\\Users\\YourName\\AppData\\Roaming\\npm\\codex.cmd"
+> ```
+> 可通过 `where codex` 命令查询实际路径。
+
+## Skills 列表（69个）
 
 <details>
 <summary>展开查看完整列表</summary>
 
-**通用后端技能（33个）**
+**通用后端技能（34个）**
 
 | 技能 | 触发场景 |
 |------|---------|
@@ -120,7 +132,7 @@ cd ai-engineering-init
 | `tech-decision` | 技术选型、方案对比 |
 | `task-tracker` | 任务进度跟踪 |
 | `project-navigator` | 项目结构导航、文件定位 |
-| `collaborating-with-codex` | 与 Codex 协同开发 |
+| `collaborating-with-codex` | 与 Codex 协同开发（支持 MCP Server 直调） |
 | `collaborating-with-gemini` | 与 Gemini 协同开发 |
 | `banana-image` | AI 图片生成、海报、缩略图 |
 | `add-skill` | 创建新技能 |
@@ -139,6 +151,7 @@ cd ai-engineering-init
 | `leniu-backend-annotations` | `@RequiresAuthentication`、分组校验 |
 | `leniu-utils-toolkit` | BeanUtil、CollUtil、StrUtil、RedisUtil |
 | `leniu-code-patterns` | net.xnzn 包名规范、禁止事项 |
+| `leniu-brainstorm` | 云食堂方案头脑风暴 |
 | `leniu-data-permission` | 云食堂数据权限控制 |
 | `leniu-java-entity` | Entity/VO/DTO/Param 数据类规范 |
 | `leniu-java-mybatis` | MyBatis Plus、LambdaQueryWrapper、XML 映射 |
@@ -184,39 +197,14 @@ cd ai-engineering-init
 
 1. 修改 `AGENTS.md` 中的项目说明
 2. 使用 `.codex/skills/` 下的技能辅助开发
+3. （可选）以 MCP Server 接入 Claude Code：`.claude/settings.json` → `mcpServers.codex`，重启后 Claude 可直接调用 `codex` / `codex-reply` 工具
+   - **Windows 用户**：将 `command` 路径改为 `where codex` 查询到的实际路径（如 `C:\Users\YourName\AppData\Roaming\npm\codex.cmd`）
 
 ## 更新日志
 
-### v1.2.0（2026-03-01）
-
-- 新增 **Cursor Hooks 支持**（`.cursor/hooks.json` + `.cursor/hooks/`）
-  - `beforeSubmitPrompt`：检测用户意图，自动注入相关技能文档路径引导 Agent 阅读（对应 Claude 的 `UserPromptSubmit`）
-  - `preToolUse`：拦截危险 Shell 命令（`rm -rf /`、`drop database` 等），兼容 Cursor `Shell` 工具名
-  - `stop`：复用 Claude 的 `stop.js`，支持 nul 文件清理和完成音效
-- 修复 **leniu-java-export** 技能示例代码：移除错误的 `Executors.readInSystem()` 包装（业务查询默认在商户库执行）
-- 修复 **leniu-java-total-line** 技能：同步修正双库架构说明，`Executors.doInSystem()` 仅用于访问系统库
-
-### v1.1.1（2026-02-24）
-
-- 优化 **npm 发布流程**
-  - 预发布版本（含 `-`）自动发布到 `test` 标签
-  - 正式版本自动发布到 `latest` 标签
-  - GitHub Release 自动标记预发布版本（`prerelease: true`）
-
-### v1.1.0（2026-02-24）
-
-- 新增 **Cursor** 工具支持（`.cursor/` 目录）
-  - 同步 68 个 Skills 到 `.cursor/skills/`
-  - 新增 Subagents 配置（`code-reviewer`、`project-manager`）
-  - 新增 MCP 服务器配置（`sequential-thinking`、`context7`、`github`）
-- 新增 **25 个 leniu 云食堂专项技能**
-  - 覆盖金额处理、并发、MQ、定时任务、报表、餐次、营销规则等场景
-
-### v1.0.0
+查看完整更新历史：[CHANGELOG.md](./CHANGELOG.md)
 
-- 初始版本，支持 Claude Code 和 OpenAI Codex
-- 内置通用后端技能、OpenSpec 工作流技能
-- 自动化 Hooks（技能强制评估、代码规范检查）
+**v1.2.2 新增**：README 补充 Windows MCP Server 路径配置说明；Windows 兼容性分析与说明。
 
 ## License
 

package/bin/index.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 /**
- * AI Engineering 初始化 CLI
+ * AI Engineering 初始化 / 更新 CLI
  * 用法:
- *   npx ai-engineering-init              # 交互式
+ *   npx ai-engineering-init              # 交互式初始化
  *   npx ai-engineering-init --tool claude
- *   npx ai-engineering-init --tool codex
  *   npx ai-engineering-init --tool all
+ *   npx ai-engineering-init update       # 自动检测已安装工具并更新
+ *   npx ai-engineering-init update --tool claude
  */
 'use strict';
 
@@ -13,47 +14,96 @@ const fs       = require('fs');
 const path     = require('path');
 const readline = require('readline');
 
-// ── ANSI 颜色 ──────────────────────────────────────────────────────────────
-const c = {
+// ── ANSI 颜色（Windows CMD/PowerShell 兼容）────────────────────────────────
+// Windows Terminal 设置 WT_SESSION，ConEmu/Cmder 设置 COLORTERM，VSCode 设置 TERM_PROGRAM
+const supportsColor = !!process.stdout.isTTY && (
+  process.platform !== 'win32' ||
+  !!process.env.WT_SESSION ||
+  !!process.env.COLORTERM ||
+  process.env.TERM_PROGRAM === 'vscode'
+);
+const ESC = supportsColor ? {
   reset: '\x1b[0m', bold: '\x1b[1m',
   red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m',
-  blue: '\x1b[34m', cyan: '\x1b[36m',
-};
-const fmt = (color, text) => `${c[color]}${text}${c.reset}`;
+  blue: '\x1b[34m', cyan: '\x1b[36m', magenta: '\x1b[35m',
+} : Object.fromEntries(
+  ['reset','bold','red','green','yellow','blue','cyan','magenta'].map(k => [k, ''])
+);
+const fmt = (color, text) => `${ESC[color]}${text}${ESC.reset}`;
+
+// ── 版本 ───────────────────────────────────────────────────────────────────
+const PKG_VERSION = require('../package.json').version;
 
 // ── Banner ─────────────────────────────────────────────────────────────────
 console.log('');
 console.log(fmt('blue', fmt('bold', '┌─────────────────────────────────────────┐')));
-console.log(fmt('blue', fmt('bold', '│      AI Engineering 初始化工具  v1.1      │')));
+console.log(fmt('blue', fmt('bold', `│      AI Engineering 工具  v${PKG_VERSION}        │`)));
 console.log(fmt('blue', fmt('bold', '└─────────────────────────────────────────┘')));
 console.log('');
 
 // ── 参数解析 ───────────────────────────────────────────────────────────────
 const args = process.argv.slice(2);
+let command   = '';   // 'update' | ''
 let tool      = '';
 let targetDir = process.cwd();
 let force     = false;
 
 for (let i = 0; i < args.length; i++) {
-  switch (args[i]) {
-    case '--tool': case '-t': tool      = args[++i]; break;
-    case '--dir':  case '-d': targetDir = path.resolve(args[++i]); break;
-    case '--force':case '-f': force     = true; break;
+  const arg = args[i];
+  switch (arg) {
+    case 'update':
+      command = 'update';
+      break;
+    case '--tool': case '-t':
+      if (i + 1 >= args.length || args[i + 1].startsWith('-')) {
+        console.error(fmt('red', `错误：${arg} 需要一个值（claude | cursor | codex | all）`));
+        process.exit(1);
+      }
+      tool = args[++i];
+      break;
+    case '--dir': case '-d':
+      if (i + 1 >= args.length || args[i + 1].startsWith('-')) {
+        console.error(fmt('red', `错误：${arg} 需要一个目录路径`));
+        process.exit(1);
+      }
+      targetDir = path.resolve(args[++i]);
+      break;
+    case '--force': case '-f':
+      force = true;
+      break;
     case '--help': case '-h':
-      console.log(`用法: ${fmt('bold', 'npx ai-engineering-init')} [选项]\n`);
-      console.log('选项:');
-      console.log('  --tool, -t <工具>   指定工具: claude | cursor | codex | all');
-      console.log('  --dir,  -d <目录>   目标目录（默认：当前目录）');
-      console.log('  --force,-f          强制覆盖已有文件');
-      console.log('  --help, -h          显示此帮助\n');
-      console.log('示例:');
-      console.log('  npx ai-engineering-init --tool claude');
-      console.log('  npx ai-engineering-init --tool all --dir /path/to/project\n');
+      printHelp();
       process.exit(0);
+      break;
+    default:
+      // 拒绝未知选项，避免静默忽略导致行为不符预期
+      if (arg.startsWith('-')) {
+        console.error(fmt('red', `错误：未知选项 "${arg}"，运行 --help 查看用法`));
+        process.exit(1);
+      }
+      break;
   }
 }
 
-// ── 工具定义 ───────────────────────────────────────────────────────────────
+function printHelp() {
+  console.log(`用法: ${fmt('bold', 'npx ai-engineering-init')} [命令] [选项]\n`);
+  console.log('命令:');
+  console.log(`  ${fmt('bold', '(无)')}            交互式初始化`);
+  console.log(`  ${fmt('bold', 'update')}           更新已安装的框架文件（跳过用户自定义文件）\n`);
+  console.log('选项:');
+  console.log('  --tool, -t <工具>   指定工具: claude | cursor | codex | all');
+  console.log('  --dir,  -d <目录>   目标目录（默认：当前目录）');
+  console.log('  --force,-f          强制覆盖（init 时覆盖已有文件；update 时同时更新保留文件）');
+  console.log('  --help, -h          显示此帮助\n');
+  console.log('示例:');
+  console.log('  npx ai-engineering-init --tool claude');
+  console.log('  npx ai-engineering-init --tool all --dir /path/to/project');
+  console.log('  npx ai-engineering-init update               # 自动检测已安装工具');
+  console.log('  npx ai-engineering-init update --tool claude # 只更新 Claude');
+  console.log('  npx ai-engineering-init update --force       # 强制更新，包括保留文件\n');
+}
+
+// ── 工具定义（init 用）────────────────────────────────────────────────────
 const TOOLS = {
   claude: {
     label: 'Claude Code',
@@ -77,19 +127,95 @@ const TOOLS = {
   },
 };
 
-// ── 工具函数 ───────────────────────────────────────────────────────────────
+// ── 更新规则（update 用）──────────────────────────────────────────────────
+// update:   框架文件，从本机安装版本覆盖
+// preserve: 用户自定义文件，默认跳过（--force 时强制覆盖）
+const UPDATE_RULES = {
+  claude: {
+    label: 'Claude Code',
+    detect: '.claude',
+    update: [
+      { src: '.claude/skills',                dest: '.claude/skills',                label: 'Skills（技能库）',    isDir: true },
+      { src: '.claude/commands',              dest: '.claude/commands',              label: 'Commands（快捷命令）', isDir: true },
+      { src: '.claude/agents',               dest: '.claude/agents',               label: 'Agents（子代理）',    isDir: true },
+      { src: '.claude/hooks',                dest: '.claude/hooks',                label: 'Hooks（钩子脚本）',   isDir: true },
+      { src: '.claude/templates',            dest: '.claude/templates',            label: 'Templates',          isDir: true },
+      { src: '.claude/framework-config.json', dest: '.claude/framework-config.json', label: 'framework-config.json' },
+    ],
+    preserve: [
+      { dest: '.claude/settings.json', reason: '包含用户 MCP 配置和权限设置' },
+      { dest: 'CLAUDE.md',             reason: '包含项目自定义规范' },
+    ],
+  },
+  cursor: {
+    label: 'Cursor',
+    detect: '.cursor',
+    update: [
+      { src: '.cursor/skills',     dest: '.cursor/skills',     label: 'Skills（技能库）',  isDir: true },
+      { src: '.cursor/agents',     dest: '.cursor/agents',     label: 'Agents（子代理）',  isDir: true },
+      { src: '.cursor/hooks',      dest: '.cursor/hooks',      label: 'Hooks（钩子脚本）', isDir: true },
+      { src: '.cursor/hooks.json', dest: '.cursor/hooks.json', label: 'hooks.json（Hooks 配置）' },
+    ],
+    preserve: [
+      { dest: '.cursor/mcp.json', reason: '包含用户 MCP 服务器配置' },
+    ],
+  },
+  codex: {
+    label: 'OpenAI Codex',
+    detect: '.codex',
+    update: [
+      { src: '.codex/skills', dest: '.codex/skills', label: 'Skills（技能库）', isDir: true },
+    ],
+    preserve: [
+      { dest: 'AGENTS.md', reason: '包含项目自定义 Agent 规范' },
+    ],
+  },
+};
+
+// ── 公共工具函数 ──────────────────────────────────────────────────────────
 const SOURCE_DIR = path.join(__dirname, '..');
 
+/** 安全判断路径是否为真实目录（避免 existsSync 将文件误判为已安装目录） */
+function isRealDir(p) {
+  try { return fs.statSync(p).isDirectory(); } catch { return false; }
+}
+
+/** 递归复制目录，返回实际写入的文件数；单文件失败不中断整体 */
 function copyDir(src, dest) {
-  if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src)) {
+  let written = 0;
+  try {
+    if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
+  } catch (e) {
+    console.log(`  ${fmt('red', '✗')}  无法创建目录 ${dest}: ${e.message}`);
+    return written;
+  }
+  let entries;
+  try {
+    entries = fs.readdirSync(src);
+  } catch (e) {
+    console.log(`  ${fmt('red', '✗')}  无法读取源目录 ${src}: ${e.message}`);
+    return written;
+  }
+  for (const entry of entries) {
     const s = path.join(src, entry);
     const d = path.join(dest, entry);
-    fs.statSync(s).isDirectory() ? copyDir(s, d) : fs.copyFileSync(s, d);
+    try {
+      fs.statSync(s).isDirectory() ? (written += copyDir(s, d)) : (fs.copyFileSync(s, d), written++);
+    } catch (e) {
+      console.log(`  ${fmt('yellow', '⚠')}  跳过文件 ${d}: ${e.message}`);
+    }
   }
+  return written;
 }
 
-function copyItem({ src, dest, label, isDir }) {
+/** 构建包含 --dir 上下文的提示命令（方便用户直接复制执行） */
+function hintCmd(subCmd) {
+  const dirPart = targetDir !== process.cwd() ? ` --dir "${targetDir}"` : '';
+  return `npx ai-engineering-init${dirPart} ${subCmd}`;
+}
+
+// ── INIT 逻辑 ─────────────────────────────────────────────────────────────
+function copyItem({ src, dest, label, isDir: srcIsDir }) {
   const srcPath  = path.join(SOURCE_DIR, src);
   const destPath = path.join(targetDir, dest);
 
@@ -101,13 +227,25 @@ function copyItem({ src, dest, label, isDir }) {
     console.log(`  ${fmt('yellow', '⚠')}  ${label} 已存在，跳过（--force 可强制覆盖）`);
     return;
   }
-  isDir ? copyDir(srcPath, destPath) : fs.copyFileSync(srcPath, destPath);
-  console.log(`  ${fmt('green', '✓')}  ${label}`);
+  try {
+    if (srcIsDir) {
+      const n = copyDir(srcPath, destPath);
+      console.log(`  ${fmt('green', '✓')}  ${label} ${fmt('magenta', `(${n} 个文件)`)}`);
+    } else {
+      fs.mkdirSync(path.dirname(destPath), { recursive: true });
+      fs.copyFileSync(srcPath, destPath);
+      console.log(`  ${fmt('green', '✓')}  ${label}`);
+    }
+  } catch (e) {
+    console.log(`  ${fmt('red', '✗')}  ${label} 复制失败: ${e.message}`);
+  }
 }
 
 function initTool(toolKey) {
   const t = TOOLS[toolKey];
   console.log(fmt('cyan', `[${t.label}]`));
+  // 确保目标根目录存在（兼容 --dir 指向尚不存在的路径）
+  try { fs.mkdirSync(targetDir, { recursive: true }); } catch { /* 已存在忽略 */ }
   for (const f of t.files) copyItem(f);
 }
 
@@ -137,10 +275,9 @@ function showDoneHint(toolKey) {
   }
 }
 
-// ── 主逻辑 ────────────────────────────────────────────────────────────────
 function run(selectedTool) {
-  if (!['claude', 'cursor', 'codex', 'all'].includes(selectedTool)) {
-    console.error(fmt('red', `无效工具: ${selectedTool}。有效选项: claude | cursor | codex | all`));
+  if (!Object.keys(TOOLS).concat('all').includes(selectedTool)) {
+    console.error(fmt('red', `无效工具: "${selectedTool}"。有效选项: claude | cursor | codex | all`));
     process.exit(1);
   }
   console.log(`  目标目录: ${fmt('bold', targetDir)}`);
@@ -150,23 +287,177 @@ function run(selectedTool) {
   console.log('');
 
   if (selectedTool === 'all') {
-    initTool('claude'); console.log(''); initTool('cursor'); console.log(''); initTool('codex');
+    Object.keys(TOOLS).forEach((k, i) => { if (i) console.log(''); initTool(k); });
   } else {
     initTool(selectedTool);
   }
   showDoneHint(selectedTool);
 }
 
-if (tool) {
+// ── UPDATE 逻辑 ───────────────────────────────────────────────────────────
+
+/** 检测当前目录已安装了哪些工具（用 isRealDir 排除误判） */
+function detectInstalledTools() {
+  return Object.keys(UPDATE_RULES).filter(key =>
+    isRealDir(path.join(targetDir, UPDATE_RULES[key].detect))
+  );
+}
+
+/** 更新单个工具，返回 { updated, failed, preserved } 文件数 */
+function updateTool(toolKey) {
+  const rule = UPDATE_RULES[toolKey];
+  console.log(fmt('cyan', `[${rule.label}]`));
+
+  let updated = 0, failed = 0, preserved = 0;
+
+  // 更新框架文件
+  for (const item of rule.update) {
+    const srcPath  = path.join(SOURCE_DIR, item.src);
+    const destPath = path.join(targetDir, item.dest);
+
+    if (!fs.existsSync(srcPath)) {
+      console.log(`  ${fmt('yellow', '⚠')}  ${item.label} 源文件不存在，跳过`);
+      continue;
+    }
+    try {
+      if (item.isDir) {
+        const n = copyDir(srcPath, destPath);
+        console.log(`  ${fmt('green', '✓')}  ${item.label} ${fmt('magenta', `(${n} 个文件)`)}`);
+        updated += n;
+      } else {
+        fs.mkdirSync(path.dirname(destPath), { recursive: true });
+        fs.copyFileSync(srcPath, destPath);
+        console.log(`  ${fmt('green', '✓')}  ${item.label}`);
+        updated++;
+      }
+    } catch (e) {
+      console.log(`  ${fmt('red', '✗')}  ${item.label} 失败: ${e.message}`);
+      failed++;
+    }
+  }
+
+  // 处理保留文件
+  for (const item of rule.preserve) {
+    const destPath = path.join(targetDir, item.dest);
+    const srcPath  = path.join(SOURCE_DIR, item.dest);
+
+    if (force) {
+      if (fs.existsSync(srcPath)) {
+        try {
+          if (isRealDir(srcPath)) {
+            const n = copyDir(srcPath, destPath);
+            updated += n;
+          } else {
+            fs.mkdirSync(path.dirname(destPath), { recursive: true });
+            fs.copyFileSync(srcPath, destPath);
+            updated++;
+          }
+          console.log(`  ${fmt('green', '✓')}  ${item.dest} ${fmt('yellow', '(强制更新)')}`);
+        } catch (e) {
+          console.log(`  ${fmt('red', '✗')}  ${item.dest} 强制更新失败: ${e.message}`);
+          failed++;
+        }
+      }
+    } else {
+      const exists = fs.existsSync(destPath);
+      const mark   = exists ? fmt('yellow', '已保留') : fmt('yellow', '不存在，跳过');
+      console.log(`  ${fmt('yellow', '⊘')}  ${item.dest} ${mark} — ${item.reason}`);
+      if (exists) preserved++;
+    }
+  }
+
+  return { updated, failed, preserved };
+}
+
+/** update 命令主流程 */
+function runUpdate(selectedTool) {
+  console.log(`  目标目录: ${fmt('bold', targetDir)}`);
+  console.log(`  本机版本: ${fmt('bold', `v${PKG_VERSION}`)}`);
+  if (force) console.log(`  ${fmt('yellow', '⚠  --force 模式：将同时更新保留文件')}`);
+  console.log('');
+
+  let toolsToUpdate = [];
+
+  if (!selectedTool || selectedTool === 'all') {
+    // 无参数 或 all：只更新已检测到的工具（不主动创建新目录）
+    toolsToUpdate = detectInstalledTools();
+    if (toolsToUpdate.length === 0) {
+      console.log(fmt('yellow', '⚠  当前目录未检测到已安装的 AI 工具配置。'));
+      console.log(`   请先运行: ${fmt('bold', hintCmd('--tool claude'))}\n`);
+      process.exit(1);
+    }
+    console.log(`  检测到已安装: ${fmt('bold', toolsToUpdate.join(', '))}`);
+    if (selectedTool === 'all') {
+      console.log(`  ${fmt('yellow', '提示')}：--tool all 只更新已安装工具，如需初始化新工具请用 --tool <name>`);
+    }
+  } else {
+    // 指定单个工具
+    if (!UPDATE_RULES[selectedTool]) {
+      console.error(fmt('red', `无效工具: "${selectedTool}"。有效选项: claude | cursor | codex | all`));
+      process.exit(1);
+    }
+    if (!isRealDir(path.join(targetDir, UPDATE_RULES[selectedTool].detect))) {
+      console.log(fmt('yellow', `⚠  ${selectedTool} 未在当前目录初始化，请先运行：`));
+      console.log(`   ${fmt('bold', hintCmd(`--tool ${selectedTool}`))}\n`);
+      process.exit(1);
+    }
+    toolsToUpdate = [selectedTool];
+  }
+
+  console.log('');
+  console.log(fmt('bold', '正在更新框架文件...'));
+  console.log('');
+
+  let totalUpdated = 0, totalFailed = 0, totalPreserved = 0;
+  for (let i = 0; i < toolsToUpdate.length; i++) {
+    const { updated, failed, preserved } = updateTool(toolsToUpdate[i]);
+    totalUpdated   += updated;
+    totalFailed    += failed;
+    totalPreserved += preserved;
+    if (i < toolsToUpdate.length - 1) console.log('');
+  }
+
+  console.log('');
+  console.log(fmt('green', fmt('bold', '✅ 更新完成！')));
+  console.log('');
+  console.log(`  ${fmt('green', `✓ 更新文件: ${totalUpdated} 个`)}`);
+  if (totalFailed > 0) {
+    console.log(`  ${fmt('red', `✗ 失败文件: ${totalFailed} 个`)}（请检查目录权限）`);
+  }
+  if (totalPreserved > 0) {
+    console.log(`  ${fmt('yellow', `⊘ 已保留文件: ${totalPreserved} 个`)}（--force 可强制更新）`);
+  }
+  console.log('');
+  console.log(fmt('cyan', '提示：'));
+  console.log('  重启 Claude Code / Cursor 使新技能生效');
+  console.log(`  ${fmt('yellow', '注意')}：update 只新增/覆盖文件，不删除旧版本已移除的文件`);
+  if (!force && totalPreserved > 0) {
+    console.log(`  强制更新保留文件: ${fmt('bold', hintCmd('update --force'))}`);
+  }
+  console.log('');
+
+  if (totalFailed > 0) process.exitCode = 1;
+}
+
+// ── 主入口 ────────────────────────────────────────────────────────────────
+if (command === 'update') {
+  runUpdate(tool);
+} else if (tool) {
   run(tool);
 } else {
+  // 非 TTY 环境（CI/管道）无法交互，强制要求显式指定 --tool
+  if (!process.stdin.isTTY) {
+    console.error(fmt('red', '错误：非交互环境下必须指定 --tool 参数'));
+    console.error(`  示例: ${fmt('bold', hintCmd('--tool claude'))}`);
+    process.exit(1);
+  }
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   console.log(fmt('cyan', '请选择要初始化的 AI 工具：'));
   console.log('');
-  console.log(`  ${fmt('bold', '1')}) ${fmt('green',  'Claude Code')}   — 初始化 .claude/ + CLAUDE.md`);
-  console.log(`  ${fmt('bold', '2')}) ${fmt('cyan',   'Cursor')}        — 初始化 .cursor/（Skills + Agents + MCP）`);
-  console.log(`  ${fmt('bold', '3')}) ${fmt('yellow', 'OpenAI Codex')}  — 初始化 .codex/ + AGENTS.md`);
-  console.log(`  ${fmt('bold', '4')}) ${fmt('blue',   '全部工具')}       — 同时初始化 Claude + Cursor + Codex`);
+  console.log(`  ${fmt('bold', '1')}) ${fmt('green',   'Claude Code')}   — 初始化 .claude/ + CLAUDE.md`);
+  console.log(`  ${fmt('bold', '2')}) ${fmt('cyan',    'Cursor')}        — 初始化 .cursor/（Skills + Agents + MCP）`);
+  console.log(`  ${fmt('bold', '3')}) ${fmt('yellow',  'OpenAI Codex')}  — 初始化 .codex/ + AGENTS.md`);
+  console.log(`  ${fmt('bold', '4')}) ${fmt('blue',    '全部工具')}       — 同时初始化 Claude + Cursor + Codex`);
   console.log('');
   rl.question(fmt('bold', '请输入选项 [1-4]: '), (answer) => {
     rl.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-engineering-init",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "AI 工程化配置初始化工具 — 一键为 Claude Code、OpenAI Codex 等 AI 工具初始化 Skills 和项目规范",
   "keywords": [
     "claude-code",