ai-engineering-init 1.5.0 → 1.6.0

package/README.md

@@ -7,267 +7,51 @@
 
 ## 快速开始
 
-### 方式一：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
+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      # 全部
 ```
 
-## 支持的工具
-
-| 工具 | 参数 | 初始化内容 |
-|------|------|-----------|
-| Claude Code | `--tool claude` | `.claude/` 目录 + `CLAUDE.md` |
-| Cursor | `--tool cursor` | `.cursor/` 目录（Skills + Agents + MCP） |
-| OpenAI Codex | `--tool codex` | `.codex/` 目录 + `AGENTS.md` |
-| 全部 | `--tool all` | 以上全部 |
-
-## 命令与选项
-
-```bash
-# 命令
-npx ai-engineering-init                 # 交互式初始化（安装到当前项目）
-npx ai-engineering-init update          # 更新已安装的框架文件
-npx ai-engineering-init global          # 全局安装到 ~/.claude 等，对所有项目生效
-
-# 选项
---tool, -t <工具>   指定工具: claude | cursor | codex | all
---dir,  -d <目录>   目标目录（默认：当前目录，仅 init/update 有效）
---force,-f          强制覆盖（init 覆盖已有文件；update/global 同时更新保留文件）
---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` |
-| `hooks.json` | Hooks 配置：技能文档引导（beforeSubmitPrompt）、危险命令拦截（preToolUse）、完成音效（stop） |
-| `hooks/` | Hooks 脚本：`cursor-skill-eval.js`、`cursor-pre-tool-use.js` |
-
-### OpenAI Codex（`.codex/`）
-
-| 目录/文件 | 说明 |
-|-----------|------|
-| `skills/` | Codex 技能配置 |
-| `AGENTS.md` | AI Agent 项目规范说明 |
-
-> **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>
-
-**通用后端技能（34个）**
-
-| 技能 | 触发场景 |
-|------|---------|
-| `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 协同开发（支持 MCP Server 直调） |
-| `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-brainstorm` | 云食堂方案头脑风暴 |
-| `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`
+| `npx ai-engineering-init` | 交互式初始化到当前项目 |
+| `npx ai-engineering-init@latest update` | 更新已安装的框架文件 |
+| `npx ai-engineering-init@latest global` | 全局安装到 `~/.claude` 等，所有项目生效 |
+| `npx ai-engineering-init sync-back` | 对比本地技能修改，反馈回源仓库 |
 
-</details>
+> 所有命令均支持 `--tool <claude|cursor|codex|all>` 指定工具。运行 `--help` 查看全部选项。
 
 ## 初始化后使用
 
 ### Claude Code
 
-1. 修改 `CLAUDE.md` 中的项目信息（包名、模块名、架构说明等）
-2. 输入 `/start` 快速了解项目
-3. 输入 `/dev` 开始开发新功能
-4. 输入 `/crud` 快速生成 CRUD 代码
-5. 输入 `/check` 检查代码规范
+1. 按需修改 `CLAUDE.md` 中的项目信息
+2. 输入 `/start` 快速了解项目，`/dev` 开发新功能，`/crud` 生成 CRUD，`/check` 检查规范
 
 ### Cursor
 
-1. 在 Chat 中输入 `/` 查看所有可用 Skills
-2. 输入 `@技能名` 手动调用指定技能（如 `@leniu-crud-development`）
-3. Subagents 会根据任务自动委托：`/code-reviewer`、`/project-manager`
-4. 在 Settings → MCP 中确认 MCP 服务器已连接
-
-#### OpenSpec 规格驱动开发（opsx 命令）
-
-基于 [OpenSpec](https://github.com/Fission-AI/OpenSpec) 的规格驱动开发工作流，在 Cursor Chat 中通过 `/opsx-*` 命令使用：
-
-| 命令 | 用途 |
-|------|------|
-| `/opsx-new` | 新建变更，描述需求并创建规格文档 |
-| `/opsx-ff` | 快速推进，一次性生成所有制品（规格+任务） |
-| `/opsx-apply` | 开始实现，按任务清单编码 |
-| `/opsx-continue` | 继续变更，创建下一个制品 |
-| `/opsx-verify` | 验证实现是否与规格匹配 |
-| `/opsx-sync` | 将 delta 规格同步到主规格 |
-| `/opsx-archive` | 归档已完成的变更 |
-| `/opsx-bulk-archive` | 批量归档多个变更 |
-| `/opsx-explore` | 探索模式，思维伙伴式问题分析 |
-| `/opsx-onboard` | 新手引导，完整工作流演示 |
-
-**标准开发流程**：`/opsx-new` → `/opsx-ff` → `/opsx-apply` → `/opsx-verify` → `/opsx-archive`
+1. 在 Chat 中输入 `/` 查看可用 Skills，或 `@技能名` 手动调用
+2. 在 Settings → MCP 中确认 MCP 服务器已连接
 
 ### OpenAI Codex
 
-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`）
-
-## 更新已安装的项目
-
-当有新版本发布时，在已安装的项目根目录执行：
-
-```bash
-# 必须加 @latest，确保使用最新源文件
-npx ai-engineering-init@latest update
-
-# 只更新指定工具
-npx ai-engineering-init@latest update --tool cursor
-npx ai-engineering-init@latest update --tool claude
-
-# 强制更新，包括 settings.json / CLAUDE.md 等保留文件
-npx ai-engineering-init@latest update --force
-```
-
-> **注意**：不加 `@latest` 会使用 npx 本地缓存的旧版本，源文件不是最新的。
-
-## 全局安装（v1.3.0+）
-
-一次安装，所有项目自动生效：
-
-```bash
-# 全局安装所有工具（~/.claude + ~/.cursor + ~/.codex）
-npx ai-engineering-init@latest global
-
-# 只全局安装指定工具
-npx ai-engineering-init@latest global --tool claude
-npx ai-engineering-init@latest global --tool cursor
-
-# 强制覆盖已有全局文件
-npx ai-engineering-init@latest global --force
-```
-
-> **说明**：全局安装将 Skills/Commands/Hooks 安装到 `~/.claude` / `~/.cursor` / `~/.codex`。`settings.json`、`mcp.json` 采用合并策略，不覆盖用户已有配置。项目级配置优先级高于全局配置，两者可共存。
+1. 按需修改 `AGENTS.md`，使用 `.codex/skills/` 下的技能辅助开发
 
-## 更新日志
+## 更多信息
 
-查看完整更新历史：[CHANGELOG.md](./CHANGELOG.md)
+[参考文档](./docs/reference.md) — Skills 列表（69个）、包含内容、命令详情、其他安装方式、全部选项
 
-**v1.3.0 新增**：`global` 命令，支持系统级全局安装，一次安装对所有项目生效。
-**v1.2.7 修复**：Cursor `beforeSubmitPrompt` hook 输出格式改为 JSON，修复技能注入失效。
-**v1.2.6 修复**：Cursor stop hook 自包含，不再依赖 Claude Code 安装。
+[更新日志](./CHANGELOG.md) — 完整版本变更记录
 
 ## License
 

package/bin/index.js

@@ -46,10 +46,12 @@ console.log('');
 
 // ── 参数解析 ───────────────────────────────────────────────────────────────
 const args = process.argv.slice(2);
-let command   = '';   // 'update' | 'global' | ''
+let command   = '';   // 'update' | 'global' | 'sync-back' | ''
 let tool      = '';
 let targetDir = process.cwd();
 let force     = false;
+let skillFilter = '';  // sync-back --skill <名称>
+let submitIssue = false; // sync-back --submit
 
 for (let i = 0; i < args.length; i++) {
   const arg = args[i];
@@ -60,6 +62,9 @@ for (let i = 0; i < args.length; i++) {
     case 'global':
       command = 'global';
       break;
+    case 'sync-back':
+      command = 'sync-back';
+      break;
     case '--tool': case '-t':
       if (i + 1 >= args.length || args[i + 1].startsWith('-')) {
         console.error(fmt('red', `错误：${arg} 需要一个值（claude | cursor | codex | all）`));
@@ -77,6 +82,16 @@ for (let i = 0; i < args.length; i++) {
     case '--force': case '-f':
       force = true;
       break;
+    case '--skill': case '-s':
+      if (i + 1 >= args.length || args[i + 1].startsWith('-')) {
+        console.error(fmt('red', `错误：${arg} 需要一个技能名称`));
+        process.exit(1);
+      }
+      skillFilter = args[++i];
+      break;
+    case '--submit':
+      submitIssue = true;
+      break;
     case '--help': case '-h':
       printHelp();
       process.exit(0);
@@ -96,12 +111,15 @@ function printHelp() {
   console.log('命令:');
   console.log(`  ${fmt('bold', '(无)')}            交互式初始化（安装到当前项目目录）`);
   console.log(`  ${fmt('bold', 'update')}           更新已安装的框架文件（跳过用户自定义文件）`);
-  console.log(`  ${fmt('bold', 'global')}           全局安装到 ~/.claude / ~/.cursor 等，对所有项目生效\n`);
+  console.log(`  ${fmt('bold', 'global')}           全局安装到 ~/.claude / ~/.cursor 等，对所有项目生效`);
+  console.log(`  ${fmt('bold', 'sync-back')}        对比本地技能修改，生成 diff 或提交 GitHub Issue\n`);
   console.log('选项:');
-  console.log('  --tool, -t <工具>   指定工具: claude | cursor | codex | all');
-  console.log('  --dir,  -d <目录>   目标目录（默认：当前目录，仅 init/update 有效）');
-  console.log('  --force,-f          强制覆盖（init 时覆盖已有文件；update/global 时同时更新保留文件）');
-  console.log('  --help, -h          显示此帮助\n');
+  console.log('  --tool,  -t <工具>   指定工具: claude | cursor | codex | all');
+  console.log('  --dir,   -d <目录>   目标目录（默认：当前目录，仅 init/update 有效）');
+  console.log('  --force, -f          强制覆盖（init 时覆盖已有文件；update/global 时同时更新保留文件）');
+  console.log('  --skill, -s <技能>   sync-back 时只对比指定技能');
+  console.log('  --submit             sync-back 时自动创建 GitHub Issue（需要 gh CLI）');
+  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');
@@ -109,7 +127,11 @@ function printHelp() {
   console.log('  npx ai-engineering-init update --tool claude # 只更新 Claude');
   console.log('  npx ai-engineering-init update --force       # 强制更新，包括保留文件');
   console.log('  npx ai-engineering-init global               # 全局安装所有工具');
-  console.log('  npx ai-engineering-init global --tool claude # 只全局安装 Claude\n');
+  console.log('  npx ai-engineering-init global --tool claude # 只全局安装 Claude');
+  console.log('  npx ai-engineering-init sync-back                        # 扫描所有已安装工具');
+  console.log('  npx ai-engineering-init sync-back --tool claude          # 只扫描 Claude');
+  console.log('  npx ai-engineering-init sync-back --skill bug-detective  # 只对比指定技能');
+  console.log('  npx ai-engineering-init sync-back --skill bug-detective --submit # 提交 Issue\n');
 }
 
 // ── 工具定义（init 用）────────────────────────────────────────────────────
@@ -675,11 +697,419 @@ function runUpdate(selectedTool) {
   if (totalFailed > 0) process.exitCode = 1;
 }
 
+// ── SYNC-BACK 逻辑 ─────────────────────────────────────────────────────────
+
+/** 技能目录名称到工具的映射 */
+const SKILL_DIRS = {
+  claude: '.claude/skills',
+  cursor: '.cursor/skills',
+  codex:  '.codex/skills',
+};
+
+/** 递归列出目录下所有文件（相对路径） */
+function listFilesRecursive(dir, prefix) {
+  prefix = prefix || '';
+  let results = [];
+  let entries;
+  try { entries = fs.readdirSync(dir); } catch { return results; }
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry);
+    const relPath = prefix ? prefix + '/' + entry : entry;
+    try {
+      if (fs.statSync(fullPath).isDirectory()) {
+        results = results.concat(listFilesRecursive(fullPath, relPath));
+      } else {
+        results.push(relPath);
+      }
+    } catch { /* 跳过不可读文件 */ }
+  }
+  return results;
+}
+
+/**
+ * 简易 unified diff 生成器（纯 Node.js，零依赖）
+ * 使用贪心 LCS 简化算法，输出标准 unified diff 格式
+ */
+function generateDiff(oldContent, newContent, oldLabel, newLabel) {
+  const oldLines = oldContent.split(/\r?\n/);
+  const newLines = newContent.split(/\r?\n/);
+
+  // 计算 LCS 表（简化版，O(n*m) 但对技能文件足够）
+  const m = oldLines.length;
+  const n = newLines.length;
+
+  // 对于大文件，跳过 LCS 直接标记全部替换
+  if (m * n > 1000000) {
+    const lines = [];
+    lines.push(`--- ${oldLabel}`);
+    lines.push(`+++ ${newLabel}`);
+    lines.push(`@@ -1,${m} +1,${n} @@`);
+    for (const line of oldLines) lines.push('-' + line);
+    for (const line of newLines) lines.push('+' + line);
+    return lines.join('\n');
+  }
+
+  // LCS 回溯表
+  const dp = Array.from({ length: m + 1 }, () => new Uint16Array(n + 1));
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      if (oldLines[i - 1] === newLines[j - 1]) {
+        dp[i][j] = dp[i - 1][j - 1] + 1;
+      } else {
+        dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+      }
+    }
+  }
+
+  // 回溯生成编辑操作序列
+  const ops = []; // { type: 'equal'|'delete'|'insert', line }
+  let i = m, j = n;
+  while (i > 0 || j > 0) {
+    if (i > 0 && j > 0 && oldLines[i - 1] === newLines[j - 1]) {
+      ops.push({ type: 'equal', oldIdx: i, newIdx: j, line: oldLines[i - 1] });
+      i--; j--;
+    } else if (j > 0 && (i === 0 || dp[i][j - 1] >= dp[i - 1][j])) {
+      ops.push({ type: 'insert', newIdx: j, line: newLines[j - 1] });
+      j--;
+    } else {
+      ops.push({ type: 'delete', oldIdx: i, line: oldLines[i - 1] });
+      i--;
+    }
+  }
+  ops.reverse();
+
+  // 将操作序列组织为 hunks（上下文 3 行）
+  const CTX = 3;
+  const hunks = [];
+  let hunkOps = [];
+  let lastChangeIdx = -999;
+
+  for (let k = 0; k < ops.length; k++) {
+    if (ops[k].type !== 'equal') {
+      // 如果距离上次变更超过 2*CTX+1，开始新 hunk
+      if (k - lastChangeIdx > 2 * CTX + 1 && hunkOps.length > 0) {
+        hunks.push(hunkOps);
+        hunkOps = [];
+        // 回退加上下文
+        const start = Math.max(k - CTX, lastChangeIdx + CTX + 1);
+        for (let c = start; c < k; c++) {
+          if (ops[c]) hunkOps.push(ops[c]);
+        }
+      } else if (hunkOps.length === 0) {
+        // 新 hunk 加前上下文
+        const start = Math.max(0, k - CTX);
+        for (let c = start; c < k; c++) {
+          hunkOps.push(ops[c]);
+        }
+      } else {
+        // 补充中间的上下文行
+        for (let c = lastChangeIdx + 1; c < k; c++) {
+          if (!hunkOps.includes(ops[c])) hunkOps.push(ops[c]);
+        }
+      }
+      hunkOps.push(ops[k]);
+      lastChangeIdx = k;
+    }
+  }
+  // 最后一个 hunk 加后上下文
+  if (hunkOps.length > 0) {
+    const end = Math.min(ops.length, lastChangeIdx + CTX + 1);
+    for (let c = lastChangeIdx + 1; c < end; c++) {
+      hunkOps.push(ops[c]);
+    }
+    hunks.push(hunkOps);
+  }
+
+  if (hunks.length === 0) return ''; // 无差异
+
+  // 格式化输出
+  const lines = [];
+  lines.push(`--- ${oldLabel}`);
+  lines.push(`+++ ${newLabel}`);
+
+  for (const hunk of hunks) {
+    // 计算 hunk 头
+    let oldStart = Infinity, oldCount = 0, newStart = Infinity, newCount = 0;
+    for (const op of hunk) {
+      if (op.type === 'equal' || op.type === 'delete') {
+        if (op.oldIdx < oldStart) oldStart = op.oldIdx;
+        oldCount++;
+      }
+      if (op.type === 'equal' || op.type === 'insert') {
+        if (op.newIdx < newStart) newStart = op.newIdx;
+        newCount++;
+      }
+    }
+    lines.push(`@@ -${oldStart},${oldCount} +${newStart},${newCount} @@`);
+    for (const op of hunk) {
+      if (op.type === 'equal')  lines.push(' ' + op.line);
+      if (op.type === 'delete') lines.push('-' + op.line);
+      if (op.type === 'insert') lines.push('+' + op.line);
+    }
+  }
+
+  return lines.join('\n');
+}
+
+/** 统计 diff 中的增删行数 */
+function countDiffLines(diffText) {
+  let added = 0, removed = 0;
+  for (const line of diffText.split('\n')) {
+    if (line.startsWith('+') && !line.startsWith('+++')) added++;
+    if (line.startsWith('-') && !line.startsWith('---')) removed++;
+  }
+  return { added, removed };
+}
+
+/** 检测 gh CLI 是否可用 */
+function isGhAvailable() {
+  try {
+    const { execSync } = require('child_process');
+    execSync('gh --version', { stdio: 'pipe' });
+    return true;
+  } catch { return false; }
+}
+
+/** 通过 gh CLI 创建 GitHub Issue */
+function submitGitHubIssue(changes, allDiffText) {
+  const { execSync } = require('child_process');
+  const skillNames = changes.map(c => c.skillName).join(', ');
+  const title = `[sync-back] 技能改进：${skillNames}`;
+  const body = [
+    '## 技能修改反馈',
+    '',
+    `> 由 \`npx ai-engineering-init sync-back --submit\` 自动生成`,
+    '',
+    '### 修改的技能',
+    '',
+    ...changes.map(c => {
+      const files = c.files.map(f => `  - \`${f.relPath}\` (+${f.added}, -${f.removed})`).join('\n');
+      return `- **${c.skillName}**\n${files}`;
+    }),
+    '',
+    '### Diff',
+    '',
+    '```diff',
+    allDiffText,
+    '```',
+    '',
+    '---',
+    `CLI 版本: v${PKG_VERSION}`,
+  ].join('\n');
+
+  try {
+    const result = execSync(
+      `gh issue create --repo xu-cell/ai-engineering-init --title "${title.replace(/"/g, '\\"')}" --body-file -`,
+      { input: body, stdio: ['pipe', 'pipe', 'pipe'], encoding: 'utf8' }
+    );
+    return result.trim();
+  } catch (e) {
+    return null;
+  }
+}
+
+/** sync-back 命令主流程 */
+function runSyncBack(selectedTool, selectedSkill, doSubmit) {
+  console.log(`  目标目录: ${fmt('bold', targetDir)}`);
+  console.log(`  本机版本: ${fmt('bold', `v${PKG_VERSION}`)}`);
+  console.log('');
+
+  // 1. 确定扫描范围
+  let toolsToScan = [];
+  if (selectedTool && selectedTool !== 'all') {
+    if (!SKILL_DIRS[selectedTool]) {
+      console.error(fmt('red', `无效工具: "${selectedTool}"。有效选项: claude | cursor | codex | all`));
+      process.exit(1);
+    }
+    toolsToScan = [selectedTool];
+  } else {
+    toolsToScan = detectInstalledTools();
+  }
+
+  if (toolsToScan.length === 0) {
+    console.log(fmt('yellow', '⚠  当前目录未检测到已安装的 AI 工具配置。'));
+    console.log(`   请先运行: ${fmt('bold', hintCmd('--tool claude'))}\n`);
+    process.exit(1);
+  }
+
+  console.log(`  扫描工具: ${fmt('bold', toolsToScan.join(', '))}`);
+  console.log('');
+  console.log(fmt('bold', '🔍 正在对比技能文件...'));
+  console.log('');
+
+  // 2. 对比每个工具的 skills 目录
+  const allChanges = []; // { toolKey, skillName, files: [{ relPath, diff, added, removed }] }
+
+  for (const toolKey of toolsToScan) {
+    const skillDir = SKILL_DIRS[toolKey];
+    const userSkillsDir = path.join(targetDir, skillDir);
+    const srcSkillsDir  = path.join(SOURCE_DIR, skillDir);
+
+    if (!isRealDir(userSkillsDir) || !isRealDir(srcSkillsDir)) continue;
+
+    // 列出用户目录中的技能
+    let skillNames;
+    try { skillNames = fs.readdirSync(userSkillsDir); } catch { continue; }
+
+    for (const name of skillNames) {
+      if (selectedSkill && name !== selectedSkill) continue;
+
+      const userSkillDir = path.join(userSkillsDir, name);
+      const srcSkillDir  = path.join(srcSkillsDir, name);
+
+      if (!isRealDir(userSkillDir)) continue;
+
+      // 列出用户技能目录下所有文件
+      const userFiles = listFilesRecursive(userSkillDir);
+      const srcFiles  = isRealDir(srcSkillDir) ? listFilesRecursive(srcSkillDir) : [];
+      const allFiles = [...new Set([...userFiles, ...srcFiles])].sort();
+
+      const changedFiles = [];
+
+      for (const relFile of allFiles) {
+        const userFile = path.join(userSkillDir, relFile);
+        const srcFile  = path.join(srcSkillDir, relFile);
+
+        const userExists = fs.existsSync(userFile);
+        const srcExists  = fs.existsSync(srcFile);
+
+        if (userExists && srcExists) {
+          // 两边都有，对比内容
+          const userContent = fs.readFileSync(userFile, 'utf8');
+          const srcContent  = fs.readFileSync(srcFile, 'utf8');
+          if (userContent !== srcContent) {
+            const diff = generateDiff(srcContent, userContent,
+              `原版 (v${PKG_VERSION})`, '本地修改');
+            if (diff) {
+              const { added, removed } = countDiffLines(diff);
+              changedFiles.push({ relPath: relFile, diff, added, removed, status: 'modified' });
+            }
+          }
+        } else if (userExists && !srcExists) {
+          // 用户新增的文件
+          const content = fs.readFileSync(userFile, 'utf8');
+          const lineCount = content.split(/\r?\n/).length;
+          changedFiles.push({
+            relPath: relFile,
+            diff: `--- /dev/null\n+++ 本地新增\n@@ -0,0 +1,${lineCount} @@\n` +
+                  content.split(/\r?\n/).map(l => '+' + l).join('\n'),
+            added: lineCount, removed: 0, status: 'added'
+          });
+        }
+        // srcExists && !userExists: 用户删除的文件（不报告，可能是有意删除）
+      }
+
+      if (changedFiles.length > 0) {
+        // 去重：只保留第一个工具的结果（多工具 skills 内容相同）
+        const existing = allChanges.find(c => c.skillName === name);
+        if (!existing) {
+          allChanges.push({ toolKey, skillName: name, files: changedFiles });
+        }
+      }
+    }
+  }
+
+  // 3. 展示结果
+  if (allChanges.length === 0) {
+    console.log(fmt('green', '  ✓ 未检测到技能修改，所有技能与包版本一致。'));
+    console.log('');
+    return;
+  }
+
+  console.log(`  检测到 ${fmt('bold', String(allChanges.length))} 个技能有修改：`);
+  console.log('');
+
+  for (let idx = 0; idx < allChanges.length; idx++) {
+    const change = allChanges[idx];
+    console.log(`  ${fmt('bold', String(idx + 1) + '.')} ${fmt('cyan', change.skillName)}`);
+    for (const file of change.files) {
+      const statusLabel = file.status === 'added' ? fmt('green', '新增文件') : fmt('yellow', '修改文件');
+      console.log(`     ${statusLabel}: ${file.relPath} (${fmt('green', '+' + file.added)} 行, ${fmt('red', '-' + file.removed)} 行)`);
+    }
+    console.log('');
+  }
+
+  // 4. 展示 diff 详情
+  const allDiffParts = [];
+
+  for (const change of allChanges) {
+    for (const file of change.files) {
+      const header = `${change.skillName}/${file.relPath}`;
+      console.log(fmt('bold', '─'.repeat(Math.min(50, header.length + 10))));
+      console.log(`📋 ${fmt('bold', header)} 的变更：`);
+      console.log(fmt('bold', '─'.repeat(Math.min(50, header.length + 10))));
+
+      // 着色 diff 输出
+      for (const line of file.diff.split('\n')) {
+        if (line.startsWith('+++') || line.startsWith('---')) {
+          console.log(fmt('bold', line));
+        } else if (line.startsWith('+')) {
+          console.log(fmt('green', line));
+        } else if (line.startsWith('-')) {
+          console.log(fmt('red', line));
+        } else if (line.startsWith('@@')) {
+          console.log(fmt('cyan', line));
+        } else {
+          console.log(line);
+        }
+      }
+      console.log('');
+
+      allDiffParts.push(`# ${header}\n${file.diff}`);
+    }
+  }
+
+  const allDiffText = allDiffParts.join('\n\n');
+
+  // 5. 提交 Issue 或提示
+  if (doSubmit) {
+    console.log(fmt('bold', '📤 正在提交 GitHub Issue...'));
+    console.log('');
+
+    if (!isGhAvailable()) {
+      console.log(fmt('yellow', '⚠  未检测到 gh CLI，无法自动提交 Issue。'));
+      console.log(`   安装方法: ${fmt('bold', 'https://cli.github.com/')}`);
+      console.log('');
+      console.log(fmt('bold', '📋 请手动复制以下内容到 GitHub Issue：'));
+      console.log('');
+      console.log(fmt('cyan', '─'.repeat(50)));
+      console.log(`标题: [sync-back] 技能改进：${allChanges.map(c => c.skillName).join(', ')}`);
+      console.log(fmt('cyan', '─'.repeat(50)));
+      console.log(allDiffText);
+      console.log(fmt('cyan', '─'.repeat(50)));
+      console.log('');
+      console.log(`提交到: ${fmt('bold', 'https://github.com/xu-cell/ai-engineering-init/issues/new')}`);
+    } else {
+      const issueUrl = submitGitHubIssue(allChanges, allDiffText);
+      if (issueUrl) {
+        console.log(fmt('green', fmt('bold', '✅ Issue 已创建！')));
+        console.log(`  ${fmt('bold', issueUrl)}`);
+      } else {
+        console.log(fmt('red', '✗ Issue 创建失败，请检查 gh 认证状态（gh auth status）'));
+        console.log('');
+        console.log(fmt('bold', '📋 请手动复制上方 diff 到 GitHub Issue：'));
+        console.log(`  ${fmt('bold', 'https://github.com/xu-cell/ai-engineering-init/issues/new')}`);
+      }
+    }
+  } else {
+    console.log(fmt('cyan', '💡 提交方式：'));
+    if (allChanges.length === 1) {
+      console.log(`  → 运行 ${fmt('bold', hintCmd(`sync-back --skill ${allChanges[0].skillName} --submit`))}`);
+    } else {
+      console.log(`  → 运行 ${fmt('bold', hintCmd('sync-back --submit'))}`);
+    }
+    console.log(`  → 或手动复制上方 diff 到 ${fmt('bold', 'https://github.com/xu-cell/ai-engineering-init/issues/new')}`);
+  }
+  console.log('');
+}
+
 // ── 主入口 ────────────────────────────────────────────────────────────────
 if (command === 'update') {
   runUpdate(tool);
 } else if (command === 'global') {
   runGlobal(tool);
+} else if (command === 'sync-back') {
+  runSyncBack(tool, skillFilter, submitIssue);
 } else if (tool) {
   run(tool);
 } else {

package/package.json

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