@agile-team/wl-skills-kit 2.4.0 → 2.4.2

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [2.4.2] - 2026-05-05
+
+### Changed
+
+- 更新 README、业务项目指南、架构说明和多编辑器兼容文档，补齐 2.4.x 生命周期、MCP、manifest、规范插件和桥接说明
+- 同步版本文案到 2.4.2，避免发布文档仍停留在 2.4.0/2.4.1
+- 明确 `@agile-team/wk-skills-ui` 仅为可选桥接包，两者不建立强依赖
+
+## [2.4.1] - 2026-05-04
+
+### Added
+
+- CLI 安装完成后新增 `@agile-team/wk-skills-ui` 可选桥接提醒，保持两包独立分工、不强耦合
+- 新增 `standards:init` 脚本，统一指向 `npx @robot-admin/git-standards init`
+- README 补充 wk-skills-ui 可选桥接说明与规范插件入口
+
 ## [2.4.0] - 2026-05-02
 
 ### 🚀 Agent Pipeline + MCP 项目感知 + CLI 质量工具

package/README.md

@@ -1,6 +1,6 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.4.0** — 一条命令将 13 条编码规范、9 个 AI Skill、14 个 MCP Tool、组件文档、领域样例导入 Vue 3 项目。
+**AI Skill 模板包 v2.4.2** — 一条命令将 13 条编码规范、9 个 AI Skill、14 个 MCP Tool、多编辑器规则、MCP 配置、组件文档和领域样例导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / Qoder / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
@@ -11,11 +11,27 @@
 ```bash
 npx @robot-admin/git-standards init      # 工程化前置（必须）
 npx @agile-team/wl-skills-kit            # 安装 AI 体系
+npm run standards:init                   # 本包维护/业务项目均可复用的规范插件入口
 # 在 AI 对话中：
 "扫描 docs/prototypes/ 下的原型生成页面清单"
 "基于上一步生成所有 api.md，再 codegen 出页面"
 ```
 
+> 可选桥接：如业务项目也需要统一 UI 风格、老系统化妆层和 UI 扫描修复，可单独安装 `@agile-team/wk-skills-ui`。两包职责独立，不互相强依赖：`wl-skills-kit` 负责编码规范/页面生成/菜单字典权限，`wk-skills-ui` 负责视觉一致性/设计令牌/化妆层/Runtime 渲染。
+
+---
+
+## 版本亮点
+
+当前 2.4.x 版本重点完善生命周期、规范插件和跨包协作体验：
+
+- `init/update/diff/clean/check/validate/export` 覆盖安装、升级、对比、清理、体检、页面完整性检查和基线导出
+- manifest 记录安装文件哈希，`reports/`、`src/components/`、`src/types/` 等关键资产受到保护
+- 自动生成 Copilot、Claude Code、Cursor、Windsurf、Cline、Kiro、Trae、Qoder、通用 Agents 规则文件
+- 内置 MCP Server，支持菜单、字典、权限和项目感知类工具
+- 接入 `@robot-admin/git-standards`，仓库维护和业务项目可共用 lint、commitlint、husky、commitizen
+- 可选桥接 `@agile-team/wk-skills-ui`：kit 负责页面/规范/菜单字典权限，wk-skills-ui 负责 UI 风格/化妆层/Runtime
+
 ---
 
 ## 这个包到底干什么？
@@ -134,6 +150,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 ├── .clinerules                           Cline
 ├── .kiro/steering/conventions.md         Kiro（含 inclusion frontmatter）
 ├── .trae/rules/conventions.md            Trae（含 alwaysApply frontmatter）
+├── .qoder/rules/conventions.md           Qoder
 │
 ├── docs/                                 12 个组件 API 文档
 ├── demo/                                 13 个领域样例
@@ -143,7 +160,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 ```
 
 > **业务项目方准则**：
-> - 主入口是 `.github/copilot-instructions.md`（Copilot 用），**其他 9 个根配置文件是它的拷贝 + 各自特化 frontmatter**
+> - 主入口是 `.github/copilot-instructions.md`（Copilot 用），**其他根配置文件是它的拷贝 + 各自特化 frontmatter**
 > - 修改规范 → **不要**改业务项目里的副本，**升级 wl-skills-kit 包 + `update`** 才不会被覆盖
 > - reports/ 里的内容是团队累积数据，`update` 不会覆盖，可放心 commit
 
@@ -151,6 +168,9 @@ wl-skills-kit/                            ← 你正看的这个仓库
 
 ## CLI 命令
 
+所有命令默认作用于当前工作目录；如需先预览，请加 `--dry-run`。
+
+
 ```bash
 # 全量安装（默认）
 npx @agile-team/wl-skills-kit
@@ -184,6 +204,17 @@ npx @agile-team/wl-skills-kit update --dry-run
 
 ---
 
+## 生命周期文件
+
+安装后会生成 `.wl-skills-manifest.json`，记录本次安装版本和文件哈希：
+
+- `update`：对比 manifest 与包内文件，仅更新有变化的内容
+- `diff`：查看当前项目与最新 kit 内容差异
+- `clean`：按 manifest 清理 AI 辅助文件，默认保留 `src/components/` 和 `src/types/`
+- `check`：检查 Node、MCP、manifest 和工程化配置
+
+---
+
 ## MCP Tools 概览
 
 | 类别 | Tools |
@@ -264,6 +295,19 @@ npx @agile-team/wl-skills-kit update
 
 ---
 
+## 与 wk-skills-ui 的边界
+
+`wl-skills-kit` 和 `wk-skills-ui` 是可组合但不强耦合的两个包：
+
+| 包 | 主要职责 | 典型触发 |
+|---|---|---|
+| `wl-skills-kit` | 编码规范、页面生成、菜单/字典/权限同步、Agent Pipeline | “生成页面”“同步菜单”“规范审计” |
+| `wk-skills-ui` | UI 风格一致性、老项目化妆层、设计令牌、Runtime 渲染、UI 扫描修复 | “统一 UI 风格”“老项目化妆”“UI 扫描修复” |
+
+如果业务项目同时安装两者，AI 可先用 kit 生成/审计页面，再用 wk-skills-ui 做视觉一致性扫描；任意一包都不自动安装另一包。
+
+---
+
 ## 进一步阅读
 
 - 📚 业务方使用指南：`.github/guides/usage.md`（业务项目内）

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.4.0
+ * wl-skills-kit CLI v2.4.2
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）
@@ -143,7 +143,7 @@ function removeFileAndEmptyParents(filePath) {
       } else {
         break;
       }
-    } catch (e) {
+    } catch {
       break;
     }
   }
@@ -154,7 +154,7 @@ function readManifest() {
   if (fs.existsSync(MANIFEST_PATH)) {
     try {
       return JSON.parse(fs.readFileSync(MANIFEST_PATH, "utf8"));
-    } catch (e) {
+    } catch {
       return null;
     }
   }
@@ -332,9 +332,11 @@ function runInstall(incremental) {
     if (dryRun) {
       const exists = fs.existsSync(dest);
       console.log("  " + (exists ? "覆盖" : "新增") + "  " + relPath);
-      exists ? updated++ : created++;
+      if (exists) updated++;
+      else created++;
     } else {
-      copyFileSafe(src, dest) === "created" ? created++ : updated++;
+      if (copyFileSafe(src, dest) === "created") created++;
+      else updated++;
     }
   }
 
@@ -372,9 +374,11 @@ function runInstall(incremental) {
         console.log(
           "  " + (ecExists ? "覆盖" : "新增") + "  [编辑器] " + ecPath,
         );
-        ecExists ? updated++ : created++;
+        if (ecExists) updated++;
+        else created++;
       } else {
-        writeFile(ecDest, ecContent) === "created" ? created++ : updated++;
+        if (writeFile(ecDest, ecContent) === "created") created++;
+        else updated++;
       }
     }
   }
@@ -411,6 +415,20 @@ function runInstall(incremental) {
 
   if (!dryRun) writeManifest(newManifest);
 
+  // ── Step 5: 非耦合桥接提醒（不自动安装 wk-skills-ui）───────────────────────
+
+  const targetPkgPath = path.join(TARGET_DIR, "package.json");
+  let hasUiPackage = false;
+  if (fs.existsSync(targetPkgPath)) {
+    try {
+      const targetPkg = JSON.parse(fs.readFileSync(targetPkgPath, "utf8"));
+      const deps = { ...targetPkg.dependencies, ...targetPkg.devDependencies };
+      hasUiPackage = Boolean(deps["@agile-team/wk-skills-ui"]);
+    } catch {
+      hasUiPackage = false;
+    }
+  }
+
   // ── 输出统计 ──────────────────────────────────────────────────────
 
   const total = created + updated + unchanged;
@@ -455,6 +473,19 @@ function runInstall(incremental) {
     }
   }
   console.log("");
+  if (hasUiPackage) {
+    console.log(
+      "  ℹ 检测到 @agile-team/wk-skills-ui：两包独立分工，可组合触发 UI 风格对齐流程。",
+    );
+  } else {
+    console.log(
+      "  ℹ 可选桥接：如需统一 UI 风格/老项目化妆层，可安装 @agile-team/wk-skills-ui。",
+    );
+  }
+  console.log(
+    "  ℹ 规范插件：建议执行 npx @robot-admin/git-standards init 接入代码质量与提交规范。",
+  );
+  console.log("");
 }
 
 // ─── 命令: clean ────────────────────────────────────────────────────────
@@ -537,7 +568,11 @@ function expectedManifestFiles() {
   for (const relPath of files) {
     expected[relPath] = fileMd5(path.join(FILES_DIR, relPath));
   }
-  const instructionsSrc = path.join(FILES_DIR, ".github", "copilot-instructions.md");
+  const instructionsSrc = path.join(
+    FILES_DIR,
+    ".github",
+    "copilot-instructions.md",
+  );
   if (fs.existsSync(instructionsSrc)) {
     const raw = fs.readFileSync(instructionsSrc, "utf8");
     for (const [ecPath, ecContent] of getEditorConfigs(raw)) {
@@ -567,19 +602,34 @@ function runCheck() {
 
   const toolFiles = [".prettierrc.js", "eslint.config.ts", ".husky"];
   for (const rel of toolFiles) {
-    add(rel, fs.existsSync(path.join(TARGET_DIR, rel)), fs.existsSync(path.join(TARGET_DIR, rel)) ? "存在" : "缺失");
+    add(
+      rel,
+      fs.existsSync(path.join(TARGET_DIR, rel)),
+      fs.existsSync(path.join(TARGET_DIR, rel)) ? "存在" : "缺失",
+    );
   }
 
   const manifest = readManifest();
-  add(MANIFEST_NAME, Boolean(manifest), manifest ? "已安装 v" + manifest.version : "未安装");
+  add(
+    MANIFEST_NAME,
+    Boolean(manifest),
+    manifest ? "已安装 v" + manifest.version : "未安装",
+  );
 
-  const envPath = path.join(TARGET_DIR, ".github", "skills", "sync", "env.local.json");
+  const envPath = path.join(
+    TARGET_DIR,
+    ".github",
+    "skills",
+    "sync",
+    "env.local.json",
+  );
   let envOk = false;
   let envDetail = "缺失";
   if (fs.existsSync(envPath)) {
     try {
       const env = JSON.parse(fs.readFileSync(envPath, "utf8"));
-      const gatewayOk = env.gatewayPath && !String(env.gatewayPath).includes("你的网关");
+      const gatewayOk =
+        env.gatewayPath && !String(env.gatewayPath).includes("你的网关");
       const tokenOk = env.token && !String(env.token).includes("Bearer Token");
       envOk = Boolean(gatewayOk && tokenOk);
       envDetail = envOk ? "已填写 gatewayPath/token" : "存在但仍含占位值";
@@ -589,15 +639,33 @@ function runCheck() {
   }
   add("MCP env.local.json", envOk, envDetail);
 
-  const mcpServer = path.join(TARGET_DIR, "node_modules", "@agile-team", "wl-skills-kit", "mcp", "server.js");
-  add("MCP server", fs.existsSync(mcpServer) || fs.existsSync(path.join(__dirname, "..", "mcp", "server.js")), "server.js 可发现");
+  const mcpServer = path.join(
+    TARGET_DIR,
+    "node_modules",
+    "@agile-team",
+    "wl-skills-kit",
+    "mcp",
+    "server.js",
+  );
+  add(
+    "MCP server",
+    fs.existsSync(mcpServer) ||
+      fs.existsSync(path.join(__dirname, "..", "mcp", "server.js")),
+    "server.js 可发现",
+  );
 
   for (const item of checks) {
-    console.log("  " + statusIcon(item.ok) + " " + item.name + " — " + item.detail);
+    console.log(
+      "  " + statusIcon(item.ok) + " " + item.name + " — " + item.detail,
+    );
   }
   const failed = checks.filter((item) => !item.ok).length;
   console.log("");
-  console.log(failed === 0 ? "  ✔ 环境预检通过" : "  ⚠ 环境预检完成，发现 " + failed + " 项需处理");
+  console.log(
+    failed === 0
+      ? "  ✔ 环境预检通过"
+      : "  ⚠ 环境预检完成，发现 " + failed + " 项需处理",
+  );
   console.log("");
   if (failed > 0) process.exitCode = 1;
 }
@@ -633,7 +701,9 @@ function runDiff() {
     }
   }
 
-  console.log("  当前 manifest: " + (manifest ? "v" + manifest.version : "未找到"));
+  console.log(
+    "  当前 manifest: " + (manifest ? "v" + manifest.version : "未找到"),
+  );
   console.log("  最新 kit: v" + PKG.version);
   console.log("  新增/缺失: " + added.length);
   console.log("  内容不同: " + changed.length);
@@ -645,7 +715,8 @@ function runDiff() {
     if (list.length === 0) return;
     console.log("  " + title + "：");
     for (const relPath of list.slice(0, 80)) console.log("    - " + relPath);
-    if (list.length > 80) console.log("    ... 还有 " + (list.length - 80) + " 项");
+    if (list.length > 80)
+      console.log("    ... 还有 " + (list.length - 80) + " 项");
     console.log("");
   }
 
@@ -671,7 +742,9 @@ function scanPageDirs(scanRel) {
     let apiConfigCount = 0;
     const dataPath = path.join(TARGET_DIR, dir, "data.ts");
     if (fs.existsSync(dataPath)) {
-      apiConfigCount = (fs.readFileSync(dataPath, "utf8").match(/API_CONFIG/g) || []).length;
+      apiConfigCount = (
+        fs.readFileSync(dataPath, "utf8").match(/API_CONFIG/g) || []
+      ).length;
     }
     pages.push({
       dir,
@@ -685,7 +758,8 @@ function scanPageDirs(scanRel) {
 }
 
 function runValidate() {
-  const scanPath = args.find((a) => !a.startsWith("-") && a !== command) || "src/views";
+  const scanPath =
+    args.find((a) => !a.startsWith("-") && a !== command) || "src/views";
   const pages = scanPageDirs(scanPath);
   console.log("");
   console.log("  wl-skills-kit v" + PKG.version + "  [validate]");
@@ -701,9 +775,20 @@ function runValidate() {
 
   const issues = [];
   for (const page of pages) {
-    if (!page.hasDataTs) issues.push({ level: "warn", dir: page.dir, text: "缺 data.ts（需结合页面复杂度判断）" });
-    if (!page.hasIndexScss) issues.push({ level: "warn", dir: page.dir, text: "缺 index.scss" });
-    if (page.apiConfigCount > 0 && !page.hasApiMd) issues.push({ level: "warn", dir: page.dir, text: "检测到 API_CONFIG 但缺 api.md" });
+    if (!page.hasDataTs)
+      issues.push({
+        level: "warn",
+        dir: page.dir,
+        text: "缺 data.ts（需结合页面复杂度判断）",
+      });
+    if (!page.hasIndexScss)
+      issues.push({ level: "warn", dir: page.dir, text: "缺 index.scss" });
+    if (page.apiConfigCount > 0 && !page.hasApiMd)
+      issues.push({
+        level: "warn",
+        dir: page.dir,
+        text: "检测到 API_CONFIG 但缺 api.md",
+      });
   }
 
   console.log("  页面目录: " + pages.length);
@@ -721,7 +806,12 @@ function parseMarkdownTable(content) {
   return content
     .split(/\r?\n/)
     .filter((line) => /^\|.*\|$/.test(line) && !/^\|\s*-+/.test(line))
-    .map((line) => line.split("|").slice(1, -1).map((cell) => cell.trim()));
+    .map((line) =>
+      line
+        .split("|")
+        .slice(1, -1)
+        .map((cell) => cell.trim()),
+    );
 }
 
 function runExport() {
@@ -743,7 +833,11 @@ function runExport() {
     if (!fs.existsSync(full)) continue;
     const content = fs.readFileSync(full, "utf8");
     let rows = parseMarkdownTable(content);
-    if (rows.length === 0) rows = content.split(/\r?\n/).filter(Boolean).map((line) => [line]);
+    if (rows.length === 0)
+      rows = content
+        .split(/\r?\n/)
+        .filter(Boolean)
+        .map((line) => [line]);
     sheets.push([sheetName, rows]);
     addedSheets++;
   }
@@ -764,13 +858,19 @@ function runExport() {
     let XLSX;
     try {
       XLSX = require("xlsx");
-    } catch (e) {
-      console.error("  ✖ 未找到 xlsx 依赖，请重新安装最新 @agile-team/wl-skills-kit");
+    } catch {
+      console.error(
+        "  ✖ 未找到 xlsx 依赖，请重新安装最新 @agile-team/wl-skills-kit",
+      );
       process.exit(1);
     }
     const wb = XLSX.utils.book_new();
     for (const [sheetName, rows] of sheets) {
-      XLSX.utils.book_append_sheet(wb, XLSX.utils.aoa_to_sheet(rows), sheetName);
+      XLSX.utils.book_append_sheet(
+        wb,
+        XLSX.utils.aoa_to_sheet(rows),
+        sheetName,
+      );
     }
     fs.mkdirSync(outDir, { recursive: true });
     XLSX.writeFile(wb, outFile);
@@ -783,14 +883,30 @@ function runExport() {
 // ─── 主路由 ─────────────────────────────────────────────────────────────
 
 switch (command) {
-  case "init":     runInstall(false); break;
-  case "update":   runInstall(true);  break;
-  case "clean":    runClean();        break;
-  case "check":    runCheck();        break;
-  case "diff":     runDiff();         break;
-  case "validate": runValidate();     break;
-  case "export":   runExport();       break;
+  case "init":
+    runInstall(false);
+    break;
+  case "update":
+    runInstall(true);
+    break;
+  case "clean":
+    runClean();
+    break;
+  case "check":
+    runCheck();
+    break;
+  case "diff":
+    runDiff();
+    break;
+  case "validate":
+    runValidate();
+    break;
+  case "export":
+    runExport();
+    break;
   default:
-    console.error('  ✖ 未知命令: "' + command + '"，请使用 --help 查看可用命令');
+    console.error(
+      '  ✖ 未知命令: "' + command + '"，请使用 --help 查看可用命令',
+    );
     process.exit(1);
 }

package/docs/ai/345/205/250/346/231/257/345/210/206/346/236/220.md

@@ -1,6 +1,6 @@
 # AI 辅助开发全景分析 & 架构演进蓝图
 
-> **基于 wl-skills-kit v2.4.0 架构**
+> **基于 wl-skills-kit v2.4.x 架构**
 > **日期**：2026-05-02
 > **目标**：企业级通用 · 质量精度高 · 速度快 · 节省 token · 还原度高 · 开箱即用 · 支持 Agent Pipeline
 
@@ -33,7 +33,7 @@ L7 自演化体系         🔭 需要足够审计报告与模板样本后再规
 
 ---
 
-## 3. v2.4.0 关键新增
+## 3. v2.4.x 关键能力
 
 ### 3.1 Agent Pipeline
 
@@ -134,7 +134,7 @@ wls_code_scan
 
 ## 6. 结论
 
-v2.4.0 后，wl-skills-kit 已具备搭建通用智能体的基础条件：
+v2.4.x 后，wl-skills-kit 已具备搭建通用智能体的基础条件：
 
 - 有 Skills 作为结构化能力单元
 - 有 MCP 作为实时项目感知与副作用执行工具

package/files/.github/guides/architecture.md

@@ -2,7 +2,7 @@
 
 > **读者**：团队技术负责人 / wl-skills-kit 维护者 / 对体系设计感兴趣的团队成员
 > **更新方式**：重大架构变更后追加对应章节，旧章节原文保留（历史可溯）
-> **当前版本**：v2.4.0（2026-05-02）
+> **当前版本**：v2.4.2（2026-05-05）
 
 ---
 
@@ -58,7 +58,7 @@ AI 编辑器（Copilot / Cursor / Windsurf 等）知道通用编程知识，但
 1. 规范分层、按任务类型懒加载（token 高效利用）
 2. Skill 触发词驱动（开发者用自然语言，AI 读结构化 SKILL.md）
 3. Pre-flight 约定式声明（消除 AI "假执行"黑盒问题）
-4. 多 AI 编辑器适配（一套内容，自动生成 9 种根配置，解耦可扩展）
+4. 多 AI 编辑器适配（一套内容，自动生成 Copilot/Claude/Cursor/Windsurf/Cline/Kiro/Trae/Qoder/Agents 配置，解耦可扩展）
 5. 报告层追加不覆盖（累积团队知识，不丢失审计历史）
 
 ---
@@ -102,7 +102,9 @@ wl-skills.js init/update
     │      - reports/*.md 已存在则跳过（保护团队累积数据）
     │      - 其他文件：覆盖写入
     │
-    └─ 5. 写入/更新 .wl-skills-manifest.json（文件哈希快照）
+    ├─ 5. 写入/更新 .wl-skills-manifest.json（文件哈希快照）
+    │
+    └─ 6. 输出 wk-skills-ui 可选桥接提醒与 git-standards 规范插件建议
 ```
 
 ---
@@ -124,6 +126,7 @@ AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae
   │   Cline    → .clinerules
   │   Kiro     → .kiro/steering/conventions.md
   │   Trae     → .trae/rules/conventions.md
+  │   Qoder    → .qoder/rules/conventions.md
   │   通用     → AGENTS.md
   │
   │ 根配置包含：

package/files/.github/guides/usage.md

@@ -1,7 +1,7 @@
 # wl-skills-kit 使用指南
 
 > **目标读者**：使用 `@agile-team/wl-skills-kit` 的 Vue 3 业务项目团队成员。
-> **适用版本**：v2.0+
+> **适用版本**：v2.4.x
 > **维护者**：CHENY（工号 409322）
 
 ---
@@ -34,7 +34,7 @@ npx @agile-team/wl-skills-kit
 - Trae
 - Qoder
 
-打开项目后，AI 会自动加载 `.github/copilot-instructions.md`，你不用做任何配置。
+打开项目后，AI 会按编辑器自动加载对应规则文件：Copilot 读 `.github/copilot-instructions.md`，Claude Code 读 `CLAUDE.md`，Cline 读 `.clinerules`，通用 Agent 读 `AGENTS.md`，Qoder 读 `.qoder/rules/conventions.md`。
 
 ### 第 3 步：开始使用
 
@@ -79,7 +79,7 @@ AI 会自动识别意图，触发对应的 Skill。
 ├── .github/
 │   ├── copilot-instructions.md      AI 主入口
 │   ├── standards/                   13 条模块化规范
-│   ├── skills/                      8 个 Skill + 1 个 PLANNED 草稿
+│   ├── skills/                      9 个启用 Skill + 多编辑器适配
 │   ├── guides/                      使用指南 + 架构设计
 │   └── reports/                     AI 生成报告（SYS_MENU_INFO 等）
 ├── docs/                            12 个组件 API 文档（jh-* / request 等）
@@ -131,6 +131,9 @@ Windsurf、Cline、Trae、Qoder 仅支持全局配置，需手动操作一次，
 
 配置完成后在 `.github/skills/sync/env.local.json` 中填好 `token`、`gatewayPath`、`menu.domainId`，重启编辑器，对 AI 说「扩展菜单」或「加字典」，AI 会自动调用 MCP 工具完成同步，无需手动粘贴接口响应。
 
+**Q: 如何和 wk-skills-ui 一起用？**
+A: 两个包不互相依赖。先用 `wl-skills-kit` 做页面生成、规范审计、菜单字典权限同步；如需统一 UI 风格或老系统化妆层，再单独安装 `@agile-team/wk-skills-ui` 并执行 `wk-ui init/update`。
+
 **Q: 部署到生产环境前如何清理 AI 文件？**
 A: 执行 `npx @agile-team/wl-skills-kit clean`。会移除所有 AI 辅助文件，保留 `src/components/` 和 `src/types/`。
 
@@ -138,6 +141,16 @@ A: 执行 `npx @agile-team/wl-skills-kit clean`。会移除所有 AI 辅助文
 
 ## 升级与维护
 
+### 生命周期命令
+
+```bash
+npx @agile-team/wl-skills-kit check        # 环境/MCP/manifest 体检
+npx @agile-team/wl-skills-kit diff         # 查看与当前包版本差异
+npx @agile-team/wl-skills-kit update       # 增量更新
+npx @agile-team/wl-skills-kit clean        # 清理 AI 文件，保留 src/components + src/types
+npx @agile-team/wl-skills-kit export       # 导出菜单/字典/权限基线 xlsx
+```
+
 ### 增量更新
 
 ```bash

package/files/.github/reports//350/247/204/350/214/203/345/256/241/346/237/245/346/212/245/345/221/212.md

@@ -36,6 +36,27 @@
 ### ✅ 合规页面
 - src/views/produce/.../mmwr-customer-archive/
 
+### 目录/模块问题分布
+
+| 模块目录 | 🔴 | 🟡 | 🟢 | 合计 | 建议 |
+|---|---:|---:|---:|---:|---|
+| {模块路径}/ | {N} | {N} | {N} | {N} | {建议} |
+
+### 推荐整改路线
+
+| 优先级 | 整改项 | 建议方式 |
+|---|---|---|
+| P0 | {工具链缺失项} | 先备份配置，再初始化 |
+| P1 | {严重偏差项} | code-fix / 立即修复 |
+| P2 | {警告偏差项} | 分批修 |
+| P3 | {存量治理项} | 渐进迁移 |
+
+---
+
+> 报告生成时间：{YYYY-MM-DD} | @agile-team/wl-skills-kit@{version} | {项目名}@{branch} branch
+> 扫描工具：@agile-team/wl-skills-kit scanner + AI 代码全量扫描
+> 执行人：{姓名} | {工号}
+
 ---
 
 （旧报告章节）

package/files/.github/skills/_compat/README.md

@@ -29,7 +29,8 @@ _compat/
     ├── cline.txt
     ├── kiro.txt                （.kiro/steering/conventions.md，含 frontmatter）
     ├── trae.txt                （.trae/rules/conventions.md，含 frontmatter）
-    └── agents.txt              （AGENTS.md 通用代理）
+    ├── agents.txt              （AGENTS.md 通用代理）
+    └── qoder.txt               （.qoder/rules/conventions.md）
 ```
 
 ---
@@ -57,7 +58,7 @@ bin/wl-skills.js (init/update)
 | ------------------------------------- | ----------------------------- | --------------------------- |
 | 团队不用 Cursor，从 editors.json 删除 | `.cursorrules`、`.cursor/`    | `.github/`、CLAUDE.md、其他 |
 | 团队新增某 AI 编辑器（如 Augment）    | 加 headers/augment.txt + 注册 | 其他文件不动                |
-| `copilot-instructions.md` 内容更新    | 全部 8 个根配置同步更新       | headers/ 不变（只是模板）   |
+| `copilot-instructions.md` 内容更新    | 全部编辑器根配置同步更新       | headers/ 不变（只是模板）   |
 
 ---
 
@@ -104,5 +105,6 @@ bin/wl-skills.js (init/update)
 | Kiro           | `.kiro/steering/*.md`                  | ✅                   | 需 inclusion 字段                |
 | Trae           | `.trae/rules/*.md`                     | ✅                   | 需 description 字段              |
 | 通用 Agent     | `AGENTS.md` (root)                     | ❌                   | 新兴跨平台规范                   |
+| Qoder          | `.qoder/rules/conventions.md`          | ✅                   | 项目规则文件                     |
 
 > 所有这些编辑器在加载完根配置后，**都支持按指令读取项目内任意文件**（含 `.github/standards/`、`.github/skills/`、`.github/guides/`），所以本架构的"懒加载门控 + 子目录规范"对所有编辑器**有效**。

package/files/.github/skills/core/convention-audit/SKILL.md

@@ -235,7 +235,16 @@ description: "Use when: auditing project source code against the 13 modular stan
 |---|---:|---:|---:|---:|---|
 | {模块路径}/ | {N} | {N} | {N} | {N} | {建议} |
 
-### 11. 修复闭环与复扫
+### 11. 推荐整改路线
+
+| 优先级 | 整改项 | 建议方式 |
+|---|---|---|
+| P0 | {工具链缺失项} | 先备份配置，再初始化 |
+| P1 | {严重偏差项} | code-fix / 立即修复 |
+| P2 | {警告偏差项} | 分批修 |
+| P3 | {存量治理项} | 渐进迁移 |
+
+### 12. 修复闭环与复扫
 
 | 指标 | 本次值 | 上次值 | 变化 |
 |---|---:|---:|---|
@@ -246,6 +255,10 @@ description: "Use when: auditing project source code against the 13 modular stan
 
 > 📌 后续提交必须使用 `git cz`，不符合规范的提交视为闭环失败。
 
+> 报告生成时间：{YYYY-MM-DD} | @agile-team/wl-skills-kit@{version} | {项目名}@{branch} branch
+> 扫描工具：@agile-team/wl-skills-kit scanner + AI 代码全量扫描
+> 执行人：{姓名} | {工号}
+
 ---
 
 （历史章节自然下沉）

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.4.0",
-  "description": "AI Skill 模板包 v2.4.0 — 13 条编码规范 + 9 个 AI Skill + 14 个 MCP Tool，一条命令导入 Vue 3 项目",
+  "version": "2.4.2",
+  "description": "AI Skill 模板包 v2.4.2 — 13 条编码规范 + 9 个 AI Skill + 14 个 MCP Tool，一条命令导入 Vue 3 项目",
   "main": "./bin/wl-skills.js",
   "bin": {
     "wl-skills": "bin/wl-skills.js"
@@ -35,7 +35,36 @@
   "engines": {
     "node": ">=16.0.0"
   },
+  "scripts": {
+    "standards:init": "npx @robot-admin/git-standards init",
+    "prepare": "husky",
+    "cz": "git-cz",
+    "lint": "eslint ."
+  },
   "dependencies": {
     "xlsx": "^0.18.5"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.5.3",
+    "@commitlint/config-conventional": "^20.5.3",
+    "@typescript-eslint/eslint-plugin": "^8.59.2",
+    "@typescript-eslint/parser": "^8.59.2",
+    "@vue/eslint-config-typescript": "^14.7.0",
+    "commitizen": "^4.3.1",
+    "cz-customizable": "^7.5.4",
+    "eslint": "^10.3.0",
+    "eslint-plugin-vue": "^10.9.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0"
+  },
+  "config": {
+    "commitizen": {
+      "path": "node_modules/cz-customizable"
+    }
+  },
+  "lint-staged": {
+    "src/**/*.{js,jsx,ts,tsx,vue}": [
+      "eslint --fix --no-cache"
+    ]
   }
-}
+}