ai-engineering-init 1.1.0

package/CLAUDE.md

@@ -0,0 +1,205 @@
+# CLAUDE.md - leniu-tengyun-core 云食堂项目
+
+## 语言设置
+**必须使用中文**与用户对话。
+
+## 术语约定
+
+| 术语 | 含义 | 路径 |
+|------|------|------|
+| **后端** | Java 服务 | `leniu-tengyun-core/` |
+| **前端** | PC 管理端 | `/Users/xujiajun/Developer/frontProj/web`（Vue 2） |
+| **食堂模块** | 食堂业务 | `sys-canteen/` |
+| **后场模块** | 后场厨房 | `sys-kitchen/` |
+| **供应链模块** | 供应链 | `sys-drp/` |
+| **公共模块** | 基础公共 | `core-base/`、`sys-common/` |
+
+## 前端技术栈
+
+| 技术 | 版本 | 说明 |
+|------|------|------|
+| Vue | 2.7.16 | Options API |
+| Element UI | 2.15.9 | `el-` 前缀组件 |
+| Vuex | 3.4.0 | namespaced:true |
+| Vue Router | 3.2.0 | Hash 路由 |
+| vue-i18n | 7.3.2 | `$t('key')` |
+
+**前端关键机制**：Token=`Admin-Token`（localStorage）、租户=`MERCHANT-ID`（请求头）、成功码=`10000`、金额=分（`money()` 转元）、权限=`v-hasPerm`、加密=SM4
+
+**前端 src 结构**：`api/`(65个接口) | `leniuview/`(35个业务模块) | `leniu-components/`(业务组件) | `components/`(~87) | `store/`(30个模块)
+
+> **前端技能**：`ui-pc`（组件/API/权限）、`store-pc`（Vuex）
+
+## MCP 工具触发
+
+| 触发词 | 工具 |
+|-------|------|
+| 深度分析、仔细思考、全面评估 | `sequential-thinking` |
+| 最佳实践、官方文档、标准写法 | `context7` |
+| 打开浏览器、截图、检查元素 | `chrome-devtools` |
+
+## Skills 强制评估
+
+> UserPromptSubmit Hook 会注入评估提示，**必须严格遵循**。
+
+1. **评估**：列出匹配的技能
+2. **激活**：逐个调用 `Skill(技能名)`（串行，不能并行）
+3. **实现**：所有技能激活完成后开始
+
+**Skills 位置**：`.claude/skills/[skill-name]/SKILL.md`
+
+---
+
+## 核心规范速查
+
+| 项目 | 规范 |
+|------|------|
+| **包名** | `net.xnzn.core.*` |
+| **JDK** | 21 |
+| **框架** | pigx-framework 3.4.7 + Spring Boot 3.x |
+| **架构** | Controller → Business → Service → Mapper |
+| **请求封装** | `LeRequest<T>` |
+| **分页** | `PageDTO` + `PageVO` + PageHelper |
+| **异常** | `LeException` |
+| **国际化** | `I18n.getMessage()` |
+| **对象转换** | `BeanUtil.copyProperties()`（Hutool） |
+| **权限** | `@RequiresAuthentication` |
+| **ID** | `Id.next()`（雪花ID） |
+| **验证** | `jakarta.validation.*`（JDK 21） |
+
+## 双库架构
+
+物理分离双库，**无 tenant_id 字段**：
+
+| 库 | 说明 | 切换方式 |
+|----|------|---------|
+| 系统库 | 全局数据（商户配置、字典） | `Executors.doInSystem()` |
+| 商户库 | 租户业务数据（订单、菜品） | 默认（请求头 `MERCHANT-ID`） |
+
+```java
+Executors.doInTenant(tenantId, () -> { /* 商户库 */ });
+Executors.doInSystem(() -> { /* 系统库 */ });
+Executors.doInAllTenant(tenantId -> { /* 遍历所有租户 */ });
+```
+
+## 四层架构说明
+
+| 层 | 职责 | 命名示例 |
+|----|------|---------|
+| Controller | 接收请求、参数校验、路由 | `OrderInfoWebController` |
+| **Business** | 业务编排、跨 Service 协调 | `OrderWebBusiness` |
+| Service | 单表 CRUD、事务 | `OrderInfoService` |
+| Mapper | ORM 映射（含 XML 同目录） | `OrderInfoMapper` |
+
+> Business 层是本项目核心特色，复杂逻辑在此处编排。
+
+## 标准包结构
+
+```
+net.xnzn.core.[module]/
+├── controller/         # 按端分：web/mobile/android
+├── business/impl/      # 业务编排
+├── service/impl/       # 服务层
+├── mapper/             # Mapper + XML（同目录！）
+├── model/              # Entity
+├── vo/                 # 响应对象
+├── dto/                # 请求参数
+├── constants/          # 枚举和常量
+├── mq/                 # 消息队列
+└── task/               # 定时任务
+```
+
+> **XML 与 Mapper 同目录**（非 `resources/mapper/`），需在 pom.xml 配置资源过滤。
+
+## 多端 Controller 路由
+
+| 端 | 路由前缀 |
+|----|---------|
+| Web 管理端 | `/api/v2/web/{module}` |
+| 移动端 | `/api/v2/mobile/{module}` |
+| 设备端 | `/api/v2/android/{module}` |
+| 开放接口 | `/api/v2/open/{module}` |
+
+## Entity 审计字段
+
+| leniu 字段 | 含义 | 填充时机 |
+|-----------|------|---------|
+| `crby` | 创建人 | INSERT |
+| `crtime` | 创建时间 | INSERT |
+| `upby` | 更新人 | INSERT_UPDATE |
+| `uptime` | 更新时间 | INSERT_UPDATE |
+| `delFlag` | **1=删除，2=正常** | 手动 |
+
+## 工具类速查
+
+| 工具 | 用途 |
+|------|------|
+| `BeanUtil.copyProperties()` | 对象转换 |
+| `CollUtil.isEmpty()` | 集合判空 |
+| `ObjectUtil.isNull()` | 对象判空 |
+| `StrUtil.isBlank()` | 字符串判空 |
+| `Id.next()` | 雪花ID |
+| `LeException` | 业务异常 |
+| `I18n.getMessage()` | 国际化 |
+| `TenantContextHolder.getTenantId()` | 租户上下文 |
+| `PageMethod.startPage()` | 分页拦截 |
+
+## 绝对禁止
+
+```java
+// ❌ 错误包名
+package org.dromara.xxx;           // 必须 net.xnzn.core.xxx
+
+// ❌ 旧验证包（JDK 21 必须用 jakarta）
+import javax.validation.constraints.*;
+
+// ❌ RuoYi 工具类
+MapstructUtils.convert();          // 用 BeanUtil.copyProperties()
+throw new ServiceException("msg"); // 用 throw new LeException("msg")
+
+// ❌ 错误审计字段名
+private String createBy;           // 必须 crby
+private LocalDateTime createTime;  // 必须 crtime
+
+// ❌ Entity 加 tenant_id（双库物理隔离，不需要）
+
+// ❌ del_flag: 0=正常（leniu 是 2=正常）
+
+// ❌ Map 传递业务数据（必须用 VO/DTO）
+```
+
+## 数据库规范
+
+```sql
+CREATE TABLE xxx (
+    id       BIGINT    NOT NULL COMMENT '主键（雪花ID）',
+    -- 业务字段...
+    crby     VARCHAR(64) COMMENT '创建人',
+    crtime   DATETIME    COMMENT '创建时间',
+    upby     VARCHAR(64) COMMENT '更新人',
+    uptime   DATETIME    COMMENT '更新时间',
+    del_flag INT DEFAULT 2 COMMENT '删除标识(1-删除,2-正常)',
+    PRIMARY KEY (id)
+);
+-- ⚠️ 无需 tenant_id（双库物理隔离）
+```
+
+## 参考代码位置
+
+| 类型 | 路径 |
+|------|------|
+| 订单 Controller | `sys-canteen/.../order/web/controller/OrderInfoWebController.java` |
+| 订单 Business | `sys-canteen/.../order/web/business/impl/OrderWebBusiness.java` |
+| 订单 Service | `sys-canteen/.../order/common/service/impl/OrderInfoService.java` |
+| 订单 Entity | `sys-canteen/.../order/common/model/OrderInfo.java` |
+| 订单枚举 | `sys-canteen/.../order/common/constants/OrderStateEnum.java` |
+| 排班 Controller | `sys-kitchen/.../attendance/scheduling/controller/BackAttendanceWorkShiftController.java` |
+| Bootstrap 配置 | `core-base/src/main/resources/bootstrap.yml` |
+
+## 快速命令
+
+| 命令 | 用途 |
+|------|------|
+| `/dev` | 开发新功能 |
+| `/crud` | 快速生成 CRUD |
+| `/check` | 代码规范检查 |

package/README.md

@@ -0,0 +1,205 @@
+# AI Engineering Init
+
+> 一键初始化 AI 工程化配置，支持 Claude Code、Cursor、OpenAI Codex 等主流 AI 开发工具。
+
+## 快速开始
+
+### 方式一：npx（推荐，无需克隆）
+
+```bash
+# 交互式选择
+npx ai-engineering-init
+
+# 直接指定工具
+npx ai-engineering-init --tool claude   # 初始化 Claude Code
+npx ai-engineering-init --tool cursor   # 初始化 Cursor
+npx ai-engineering-init --tool codex    # 初始化 OpenAI Codex
+npx ai-engineering-init --tool all      # 初始化全部
+```
+
+### 方式二：Shell 脚本（远程执行）
+
+```bash
+# 交互式
+bash <(curl -fsSL https://raw.githubusercontent.com/xu-cell/ai-engineering-init/main/init.sh)
+
+# 直接指定工具
+bash <(curl -fsSL https://raw.githubusercontent.com/xu-cell/ai-engineering-init/main/init.sh) --tool claude
+bash <(curl -fsSL https://raw.githubusercontent.com/xu-cell/ai-engineering-init/main/init.sh) --tool cursor
+```
+
+### 方式三：克隆后初始化
+
+```bash
+git clone https://github.com/xu-cell/ai-engineering-init
+cd ai-engineering-init
+./init.sh --tool claude
+./init.sh --tool cursor
+```
+
+## 支持的工具
+
+| 工具 | 参数 | 初始化内容 |
+|------|------|-----------|
+| Claude Code | `--tool claude` | `.claude/` 目录 + `CLAUDE.md` |
+| Cursor | `--tool cursor` | `.cursor/` 目录（Skills + Agents + MCP） |
+| OpenAI Codex | `--tool codex` | `.codex/` 目录 + `AGENTS.md` |
+| 全部 | `--tool all` | 以上全部 |
+
+## 选项
+
+```
+--tool, -t <工具>   指定工具: claude | cursor | codex | all
+--dir,  -d <目录>   目标目录（默认：当前目录）
+--force,-f          强制覆盖已有文件
+--help, -h          显示帮助
+```
+
+## 包含内容
+
+### Claude Code（`.claude/`）
+
+| 目录/文件 | 说明 |
+|-----------|------|
+| `skills/`（68个） | 业务技能：CRUD、API、数据库、安全、性能、leniu 云食堂专项等 |
+| `commands/`（10个） | 快捷命令：`/dev`、`/crud`、`/check`、`/start`、`/progress` 等 |
+| `agents/`（2个） | 子代理：`code-reviewer`（代码审查）、`project-manager`（项目管理） |
+| `hooks/` | 自动化钩子：技能强制评估（UserPromptSubmit）、代码规范检查（PreToolUse） |
+| `CLAUDE.md` | 项目规范说明（包名、架构、工具类、禁止事项等） |
+
+### Cursor（`.cursor/`）
+
+| 目录/文件 | 说明 |
+|-----------|------|
+| `skills/`（68个） | 与 `.claude/skills/` 完全同步，支持 `@技能名` 手动调用或 Agent 自动委托 |
+| `agents/`（2个） | Subagents：`code-reviewer`（`readonly: true`）、`project-manager` |
+| `mcp.json` | MCP 服务器配置：`sequential-thinking`、`context7`、`github` |
+
+### OpenAI Codex（`.codex/`）
+
+| 目录/文件 | 说明 |
+|-----------|------|
+| `skills/` | Codex 技能配置 |
+| `AGENTS.md` | AI Agent 项目规范说明 |
+
+## Skills 列表（68个）
+
+<details>
+<summary>展开查看完整列表</summary>
+
+**通用后端技能（33个）**
+
+| 技能 | 触发场景 |
+|------|---------|
+| `crud-development` | CRUD 开发、业务模块、Entity/Service/Controller |
+| `api-development` | RESTful API 设计、接口规范 |
+| `database-ops` | 建表、SQL、字典、菜单配置 |
+| `backend-annotations` | `@RateLimiter`、`@RepeatSubmit`、`@DataPermission` |
+| `utils-toolkit` | StringUtils、MapstructUtils、StreamUtils 等工具类 |
+| `architecture-design` | 系统架构、模块划分、代码重构 |
+| `code-patterns` | 编码规范、命名规范、禁止事项 |
+| `error-handler` | 异常处理、ServiceException、全局错误码 |
+| `security-guard` | Sa-Token 认证授权、数据脱敏、加密 |
+| `data-permission` | 行级数据权限、部门隔离 |
+| `performance-doctor` | 慢查询优化、缓存策略、N+1 问题 |
+| `redis-cache` | Redis 缓存、分布式锁、`@Cacheable` |
+| `json-serialization` | JSON 序列化、BigDecimal 精度、日期格式 |
+| `scheduled-jobs` | 定时任务、SnailJob、`@Scheduled` |
+| `websocket-sse` | WebSocket、SSE 实时推送、消息通知 |
+| `workflow-engine` | 工作流、审批流、WarmFlow |
+| `file-oss-management` | 文件上传、OSS、MinIO |
+| `sms-mail` | 短信、邮件、SMS4j |
+| `social-login` | 第三方登录、OAuth2、JustAuth |
+| `tenant-management` | 多租户隔离、TenantEntity |
+| `test-development` | 单元测试、JUnit5、Mockito |
+| `git-workflow` | Git 提交规范、分支策略 |
+| `bug-detective` | Bug 排查、异常定位 |
+| `brainstorm` | 方案设计、头脑风暴 |
+| `tech-decision` | 技术选型、方案对比 |
+| `task-tracker` | 任务进度跟踪 |
+| `project-navigator` | 项目结构导航、文件定位 |
+| `collaborating-with-codex` | 与 Codex 协同开发 |
+| `collaborating-with-gemini` | 与 Gemini 协同开发 |
+| `banana-image` | AI 图片生成、海报、缩略图 |
+| `add-skill` | 创建新技能 |
+| `ui-pc` | 前端 PC 端组件库 |
+| `store-pc` | 前端 Vuex 状态管理 |
+
+**leniu 云食堂专项技能（25个）**
+
+| 技能 | 说明 |
+|------|------|
+| `leniu-crud-development` | 云食堂四层架构 CRUD（Controller→Business→Service→Mapper） |
+| `leniu-api-development` | 云食堂 API 规范（LeResult、LeRequest、LeException） |
+| `leniu-architecture-design` | 双库架构（商户库/系统库）、pigx-framework |
+| `leniu-database-ops` | 云食堂建表规范（审计字段、逻辑删除、雪花ID） |
+| `leniu-error-handler` | LeException、I18n 国际化异常处理 |
+| `leniu-backend-annotations` | `@RequiresAuthentication`、分组校验 |
+| `leniu-utils-toolkit` | BeanUtil、CollUtil、StrUtil、RedisUtil |
+| `leniu-code-patterns` | net.xnzn 包名规范、禁止事项 |
+| `leniu-data-permission` | 云食堂数据权限控制 |
+| `leniu-java-entity` | Entity/VO/DTO/Param 数据类规范 |
+| `leniu-java-mybatis` | MyBatis Plus、LambdaQueryWrapper、XML 映射 |
+| `leniu-java-amount-handling` | 金额分/元转换（Long 类型存储） |
+| `leniu-java-code-style` | 命名规范、注解风格 |
+| `leniu-java-concurrent` | CompletableFuture、线程池、分布式锁 |
+| `leniu-java-export` | Excel 异步导出 |
+| `leniu-java-logging` | `@Slf4j`、日志级别规范 |
+| `leniu-java-mq` | MqUtil、`@MqConsumer`、延迟消息 |
+| `leniu-java-report-query-param` | 报表查询入参 Param 类规范 |
+| `leniu-java-task` | XXL-Job 定时任务 |
+| `leniu-java-total-line` | 报表分页合计行 |
+| `leniu-mealtime` | 餐次（早/午/下午茶/晚/夜宵）处理 |
+| `leniu-redis-cache` | 云食堂 Redis 缓存规范 |
+| `leniu-security-guard` | SQL 注入防护、XSS 防护、限流 |
+| `leniu-marketing-price-rule-customizer` | 营销计费规则定制 |
+| `leniu-marketing-recharge-rule-customizer` | 营销充值规则定制 |
+
+**OpenSpec 工作流技能（10个）**
+
+`openspec-new-change`、`openspec-ff-change`、`openspec-apply-change`、`openspec-continue-change`、`openspec-archive-change`、`openspec-bulk-archive-change`、`openspec-explore`、`openspec-onboard`、`openspec-sync-specs`、`openspec-verify-change`
+
+</details>
+
+## 初始化后使用
+
+### Claude Code
+
+1. 修改 `CLAUDE.md` 中的项目信息（包名、模块名、架构说明等）
+2. 输入 `/start` 快速了解项目
+3. 输入 `/dev` 开始开发新功能
+4. 输入 `/crud` 快速生成 CRUD 代码
+5. 输入 `/check` 检查代码规范
+
+### Cursor
+
+1. 在 Chat 中输入 `/` 查看所有可用 Skills
+2. 输入 `@技能名` 手动调用指定技能（如 `@leniu-crud-development`）
+3. Subagents 会根据任务自动委托：`/code-reviewer`、`/project-manager`
+4. 在 Settings → MCP 中确认 MCP 服务器已连接
+
+### OpenAI Codex
+
+1. 修改 `AGENTS.md` 中的项目说明
+2. 使用 `.codex/skills/` 下的技能辅助开发
+
+## 更新日志
+
+### 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
+
+- 初始版本，支持 Claude Code 和 OpenAI Codex
+- 内置通用后端技能、OpenSpec 工作流技能
+- 自动化 Hooks（技能强制评估、代码规范检查）
+
+## License
+
+MIT

package/bin/index.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+/**
+ * AI Engineering 初始化 CLI
+ * 用法:
+ *   npx ai-engineering-init              # 交互式
+ *   npx ai-engineering-init --tool claude
+ *   npx ai-engineering-init --tool codex
+ *   npx ai-engineering-init --tool all
+ */
+'use strict';
+
+const fs       = require('fs');
+const path     = require('path');
+const readline = require('readline');
+
+// ── ANSI 颜色 ──────────────────────────────────────────────────────────────
+const c = {
+  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}`;
+
+// ── 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', '└─────────────────────────────────────────┘')));
+console.log('');
+
+// ── 参数解析 ───────────────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+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;
+    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');
+      process.exit(0);
+  }
+}
+
+// ── 工具定义 ───────────────────────────────────────────────────────────────
+const TOOLS = {
+  claude: {
+    label: 'Claude Code',
+    files: [
+      { src: '.claude',   dest: '.claude',   label: '.claude/ 目录', isDir: true },
+      { src: 'CLAUDE.md', dest: 'CLAUDE.md', label: 'CLAUDE.md'                 },
+    ],
+  },
+  cursor: {
+    label: 'Cursor',
+    files: [
+      { src: '.cursor',   dest: '.cursor',   label: '.cursor/ 目录', isDir: true },
+    ],
+  },
+  codex: {
+    label: 'OpenAI Codex',
+    files: [
+      { src: '.codex',    dest: '.codex',    label: '.codex/ 目录',  isDir: true },
+      { src: 'AGENTS.md', dest: 'AGENTS.md', label: 'AGENTS.md'                 },
+    ],
+  },
+};
+
+// ── 工具函数 ───────────────────────────────────────────────────────────────
+const SOURCE_DIR = path.join(__dirname, '..');
+
+function copyDir(src, dest) {
+  if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src)) {
+    const s = path.join(src, entry);
+    const d = path.join(dest, entry);
+    fs.statSync(s).isDirectory() ? copyDir(s, d) : fs.copyFileSync(s, d);
+  }
+}
+
+function copyItem({ src, dest, label, isDir }) {
+  const srcPath  = path.join(SOURCE_DIR, src);
+  const destPath = path.join(targetDir, dest);
+
+  if (!fs.existsSync(srcPath)) {
+    console.log(`  ${fmt('yellow', '⚠')}  ${label} 在源目录中不存在，跳过`);
+    return;
+  }
+  if (fs.existsSync(destPath) && !force) {
+    console.log(`  ${fmt('yellow', '⚠')}  ${label} 已存在，跳过（--force 可强制覆盖）`);
+    return;
+  }
+  isDir ? copyDir(srcPath, destPath) : fs.copyFileSync(srcPath, destPath);
+  console.log(`  ${fmt('green', '✓')}  ${label}`);
+}
+
+function initTool(toolKey) {
+  const t = TOOLS[toolKey];
+  console.log(fmt('cyan', `[${t.label}]`));
+  for (const f of t.files) copyItem(f);
+}
+
+function showDoneHint(toolKey) {
+  console.log('');
+  console.log(fmt('green', fmt('bold', '✅ 初始化完成！')));
+  console.log('');
+  if (toolKey === 'claude' || toolKey === 'all') {
+    console.log(fmt('cyan', 'Claude Code 使用：'));
+    console.log(`  1. 按需修改 ${fmt('bold', 'CLAUDE.md')} 中的项目信息`);
+    console.log(`  2. 在 Claude Code 中输入 ${fmt('bold', '/start')} 快速了解项目`);
+    console.log(`  3. 输入 ${fmt('bold', '/dev')} 开始开发新功能`);
+    console.log('');
+  }
+  if (toolKey === 'cursor' || toolKey === 'all') {
+    console.log(fmt('cyan', 'Cursor 使用：'));
+    console.log(`  1. 在 Cursor Chat 中输入 ${fmt('bold', '/')} 查看所有可用 Skills`);
+    console.log(`  2. 输入 ${fmt('bold', '@技能名')} 手动调用指定技能`);
+    console.log(`  3. 在 Settings → MCP 中确认 MCP 服务器已连接`);
+    console.log('');
+  }
+  if (toolKey === 'codex' || toolKey === 'all') {
+    console.log(fmt('cyan', 'Codex 使用：'));
+    console.log(`  1. 按需修改 ${fmt('bold', 'AGENTS.md')} 中的项目说明`);
+    console.log(`  2. 在 Codex 中使用 .codex/skills/ 下的技能`);
+    console.log('');
+  }
+}
+
+// ── 主逻辑 ────────────────────────────────────────────────────────────────
+function run(selectedTool) {
+  if (!['claude', 'cursor', 'codex', 'all'].includes(selectedTool)) {
+    console.error(fmt('red', `无效工具: ${selectedTool}。有效选项: claude | cursor | codex | all`));
+    process.exit(1);
+  }
+  console.log(`  目标目录: ${fmt('bold', targetDir)}`);
+  console.log(`  初始化工具: ${fmt('bold', selectedTool)}`);
+  console.log('');
+  console.log(fmt('bold', '正在复制文件...'));
+  console.log('');
+
+  if (selectedTool === 'all') {
+    initTool('claude'); console.log(''); initTool('cursor'); console.log(''); initTool('codex');
+  } else {
+    initTool(selectedTool);
+  }
+  showDoneHint(selectedTool);
+}
+
+if (tool) {
+  run(tool);
+} else {
+  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('');
+  rl.question(fmt('bold', '请输入选项 [1-4]: '), (answer) => {
+    rl.close();
+    const map = { '1': 'claude', '2': 'cursor', '3': 'codex', '4': 'all' };
+    const selected = map[answer.trim()];
+    if (!selected) { console.error(fmt('red', '无效选项，退出。')); process.exit(1); }
+    console.log('');
+    run(selected);
+  });
+}