@agile-team/wl-skills-kit 2.11.3 → 2.11.4

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [2.11.4] - 2026-06-21
+
+### Added
+
+- **R14 类型检查自动接线（pre-push hook）**：`init`/`update` 自动创建 `.husky/pre-push`，推送前跑 `validate --typecheck`（R14 vue-tsc 类型检查）。补齐"pre-commit 跑 R1~R13、pre-push 跑 R14、CI 跑 R1~R14"三层确定性兜底，R14 不再是 opt-in 空规则
+- **validate 端到端集成测试（tests/validate.test.js）**：通过真实 CLI 二进制跑完整 validate 流程，覆盖正则级（agGrid/cid/defineColumns）+ AST 级（R3/R13）+ 合规页 + 豁免配置。补齐 runValidate 主体的零覆盖缺口（"自吃狗粮"）
+- **convention-audit 豁免项复核**：审计步骤新增"读取 .wl-skills-validate.json 列出所有豁免条目"，供人工逐条确认豁免是否仍需保留（豁免审计闭环）
+
+### Changed
+
+- **kit 自身代码质量门禁修复**：修复 13 个 eslint error（8 处未用变量 + 4 处嵌套过深 + 1 处死代码），`lint-staged` 匹配范围从无效的 `src/**` 改为 `bin/lib/scripts/**`，`pnpm lint` 纳入 `verify`/`prepublishOnly`。kit 自身代码不再绕开规范
+- **runAstRules 重构降复杂度**：抽出 `checkR8FileSeparation`/`checkR13Complexity` 独立 helper，降低主函数圈复杂度（84→更低），消除 R9 死代码（hasInterfaceTable/hasEntityDef）
+
+### Fixed
+
+- **jenkins-pipeline.md 滞后**：3 处 `.github/` → `.wl-skills/`（v2.11.0 目录迁移遗留未同步）；Typecheck 独立 stage 合并进 `validate --strict --typecheck`（R14 不再割裂）
+- **R14 配置错误误报**：`vue-tsc` 退出码非 0 但无标准 TS error 行时，区分 tsconfig 配置问题（warn，非类型错误）与未知失败（error），避免误导用户改类型
+- **lint-skills printFixSuggestions 残留**：`.github/standards/` 引用修正为 `.wl-skills/`
+
 ## [2.11.3] - 2026-06-21
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.11.3** — 一键将 14 条规范、11 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
+**AI Skill 模板包 v2.11.4** — 一键将 14 条规范、11 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / Qoder / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.11.3
+ * wl-skills-kit CLI v2.11.4
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）
@@ -26,7 +26,6 @@ const crypto = require("crypto");
 const {
   runAstRules,
   getStagedFiles,
-  hasAstAvailable,
   runTypeCheck,
 } = require("../lib/ast-rules");
 
@@ -382,6 +381,7 @@ function runInstall(incremental) {
   // 这样即使 early-return（同版本跳过文件复制），hook 也会被创建/更新
   if (!dryRun) {
     ensurePreCommitHook(TARGET_DIR);
+    ensurePrePushHook(TARGET_DIR);
     ensureEslintConfig(TARGET_DIR);
   }
 
@@ -517,21 +517,20 @@ function runInstall(incremental) {
     // v2.11 目录重构迁移：.github/skills|standards|guides|reports/ → .wl-skills/
     for (const prefix of LEGACY_DIR_PREFIXES) {
       const legacyDir = path.join(TARGET_DIR, prefix);
-      if (fs.existsSync(legacyDir)) {
-        const legacyFiles = walkDir(legacyDir, legacyDir);
-        for (const f of legacyFiles) {
-          const legacyFile = path.join(legacyDir, f);
-          if (dryRun) {
-            console.log("  迁移清理  " + prefix + f + "  (v2.11 目录重构)");
-          } else {
-            removeFileAndEmptyParents(legacyFile);
-          }
-          migrated++;
-        }
-        // 删除空目录
-        if (!dryRun && fs.existsSync(legacyDir)) {
-          try { fs.rmSync(legacyDir, { recursive: true, force: true }); } catch {}
+      if (!fs.existsSync(legacyDir)) continue;
+      const legacyFiles = walkDir(legacyDir, legacyDir);
+      for (const f of legacyFiles) {
+        const legacyFile = path.join(legacyDir, f);
+        if (dryRun) {
+          console.log("  迁移清理  " + prefix + f + "  (v2.11 目录重构)");
+        } else {
+          removeFileAndEmptyParents(legacyFile);
         }
+        migrated++;
+      }
+      // 删除空目录
+      if (!dryRun && fs.existsSync(legacyDir)) {
+        try { fs.rmSync(legacyDir, { recursive: true, force: true }); } catch {}
       }
     }
 
@@ -642,7 +641,6 @@ function runInstall(incremental) {
  */
 function ensurePreCommitHook(targetDir) {
   const huskyDir = path.join(targetDir, ".husky");
-  const preCommitPath = path.join(huskyDir, ".husky/pre-commit");
 
   // 只有 git 仓库才创建 husky hook
   if (!fs.existsSync(path.join(targetDir, ".git"))) return;
@@ -723,6 +721,58 @@ function ensurePreCommitHook(targetDir) {
   }
 }
 
+/**
+ * 确保 .husky/pre-push 包含 wl-skills validate --typecheck
+ * — pre-push 跑全量类型检查（R14），补 pre-commit 不跑 R14 的缺口
+ *
+ * 设计理由：pre-commit 跑全量 vue-tsc 太慢（拖慢日常提交），
+ * 但 pre-push 频率低、可接受耗时，且 CI 也跑相同命令。
+ * 这样 R14 在"推送到远程"和"CI"两个节点都有确定性执行器兜底。
+ *
+ * 策略同 pre-commit：不存在则创建，存在但无 marker 则追加。
+ */
+function ensurePrePushHook(targetDir) {
+  const huskyDir = path.join(targetDir, ".husky");
+  if (!fs.existsSync(path.join(targetDir, ".git"))) return;
+  if (!fs.existsSync(huskyDir)) return;
+
+  const HOOK_VERSION_TAG = "# wl-skills-prepush-hook-v1";
+  const pushContent =
+    "#!/usr/bin/env sh\n" +
+    HOOK_VERSION_TAG + "\n" +
+    "# wl-skills-kit 自动管理：推送前全量类型检查（R14，error 阻断推送）\n" +
+    "# 含 vue-tsc/tsc --noEmit，体积较大故放 pre-push 而非 pre-commit\n" +
+    "# 如果 node_modules 不存在或 kit 未安装，优雅跳过，不阻断推送\n" +
+    'if [ -f "node_modules/@agile-team/wl-skills-kit/bin/wl-skills.js" ]; then\n' +
+    '  node node_modules/@agile-team/wl-skills-kit/bin/wl-skills.js validate --typecheck\n' +
+    "  if [ $? -ne 0 ]; then\n" +
+    '    echo ""\n' +
+    '    echo "  ✖ 类型检查/规范检测未通过，推送已阻断（R14 类型错误零容忍）"\n' +
+    '    echo "  → 修复后重新 git push，或单独 commit 后用 --no-verify 跳过（CI 仍会拦截）"\n' +
+    "    exit 1\n" +
+    "  fi\n" +
+    "else\n" +
+    '  echo "  ⚠ wl-skills-kit 未安装，跳过推送前类型检查"\n' +
+    "fi\n";
+
+  const pushFile = path.join(huskyDir, "pre-push");
+  if (!fs.existsSync(pushFile)) {
+    fs.writeFileSync(pushFile, pushContent, "utf8");
+    try { fs.chmodSync(pushFile, 0o755); } catch {}
+    console.log("  ✔ 已创建 .husky/pre-push（推送前自动运行 wl-skills validate --typecheck）");
+    console.log("    → R14 类型检查在 pre-push 兜底（pre-commit 太慢不放这）");
+    console.log("");
+  } else {
+    const existing = fs.readFileSync(pushFile, "utf8");
+    if (existing.includes(HOOK_VERSION_TAG)) return;
+    const addition = "\n" + pushContent.replace("#!/usr/bin/env sh\n", "");
+    fs.writeFileSync(pushFile, existing.trimEnd() + "\n" + addition, "utf8");
+    try { fs.chmodSync(pushFile, 0o755); } catch {}
+    console.log("  ✔ 已在 .husky/pre-push 追加 wl-skills validate --typecheck（R14 类型检查）");
+    console.log("");
+  }
+}
+
 /**
  * 确保业务项目有 ESLint 配置
  * 策略：如果项目根目录没有 eslint.config.cjs，从 kit 复制模板
@@ -1433,15 +1483,13 @@ function printFixSuggestions(blockingIssues) {
   console.log("  \u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
 
   let hasAutoFix = false;
-  let hasUnknownIssue = false;
   for (const [rule, ruleIssues] of ruleGroups.entries()) {
     const suggestion = AST_FIX_SUGGESTIONS[rule] || findRegexSuggestion(ruleIssues[0].text);
     const count = ruleIssues.length;
     if (!suggestion) {
       // 免底：未知规则的阻断项也要展示，避免用户看不到任何提示
-      hasUnknownIssue = true;
       console.log("  \u2502  " + rule + "\uff08" + count + " \u5904\uff09 [\u2753\u672a\u77e5\u89c4\u5219]");
-      console.log("  \u2502    \u2192 \u8bf7\u67e5\u770b .github/standards/ \u76f8\u5173\u89c4\u8303\u6216\u89e6\u53d1\u89c4\u8303\u5ba1\u8ba1");
+      console.log("  \u2502    \u2192 \u8bf7\u67e5\u770b .wl-skills/standards/ \u76f8\u5173\u89c4\u8303\u6216\u89e6\u53d1\u89c4\u8303\u5ba1\u8ba1");
       console.log("  \u2502");
       continue;
     }
@@ -1449,7 +1497,7 @@ function printFixSuggestions(blockingIssues) {
     if (suggestion.auto) hasAutoFix = true;
     console.log("  \u2502  " + rule + "\uff08" + count + " \u5904\uff09" + autoTag);
     console.log("  \u2502    \u2192 " + suggestion.fix);
-    console.log("  \u2502    \u53c2\u8003: .github/" + suggestion.ref);
+    console.log("  \u2502    \u53c2\u8003: .wl-skills/" + suggestion.ref);
     console.log("  \u2502");
   }
 

package/files/.wl-skills/guides/architecture.md

@@ -2,7 +2,7 @@
 
 > **读者**：团队技术负责人 / wl-skills-kit 维护者 / 对体系设计感兴趣的团队成员
 > **更新方式**：重大架构变更后追加对应章节，旧章节原文保留（历史可溯）
-> **当前版本**：v2.11.3（2026-06-21）
+> **当前版本**：v2.11.4（2026-06-21）
 
 ---
 

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

@@ -160,8 +160,9 @@ description: "Use when: auditing project source code against the 14 modular stan
    - ESLint：是否可执行
    - TypeScript：`vue-tsc --noEmit`（回退 `tsc --noEmit`）是否可执行、是否 0 error（R14）
    - Git：当前分支 / 最近提交
-   - Husky：`.husky/pre-commit`、`.husky/commit-msg` 是否存在
+   - Husky：`.husky/pre-commit`、`.husky/pre-push`、`.husky/commit-msg` 是否存在
 3. 读取 `package.json` 获取项目脚本名称
+4. **读取豁免配置**（v2.11.4+）：如项目根存在 `.wl-skills-validate.json`，解析其中所有豁免条目（paths / rules / reason），在报告中单列"豁免项复核清单"，供人工逐条确认是否仍需豁免
 
 ### 步骤 3：扫描源码
 

package/lib/ast-rules.js

@@ -52,14 +52,6 @@ function ensureAst() {
   if (_astChecked) return _compilerSfc && _babelParser;
   _astChecked = true;
 
-  // 优先从 kit 自身 node_modules 解析（开发/测试环境）
-  const tryPaths = [
-    // 1. kit 自身 node_modules（标准 require 解析）
-    null,
-    // 2. 调用方项目（CWD）的 node_modules — 业务项目通过 npx/node 运行时
-    //    kit 本身没装 @vue/compiler-sfc，但业务项目有
-  ];
-
   // 尝试标准 require（从 kit 目录解析）
   try {
     _compilerSfc = require("@vue/compiler-sfc");
@@ -76,7 +68,7 @@ function ensureAst() {
   if (!_compilerSfc || !_babelParser) {
     const cwd = process.env.WL_PROJECT_ROOT || process.cwd();
     try {
-      const createRequire = require("module").createRequire;
+      const {createRequire} = require("module");
       const cwdRequire = createRequire(cwd + "/package.json");
       if (!_compilerSfc) {
         try { _compilerSfc = cwdRequire("@vue/compiler-sfc"); } catch {}
@@ -430,7 +422,7 @@ function resolveFnName(node, parent) {
     return parent.key.name || parent.key.value || "(anonymous)";
   }
   if (parent.type === "AssignmentExpression" && parent.left) {
-    const left = parent.left;
+    const {left} = parent;
     if (left.property) return left.property.name || left.property.value;
     if (left.name) return left.name;
   }
@@ -532,6 +524,75 @@ function isLikelyListPage(template) {
   return hasBaseTable && hasPagination && !hasForm && !hasTabs;
 }
 
+// ─── 单页规则 helper（从 runAstRules 抽出，降低主函数圈复杂度）──────────
+
+/**
+ * R8: 强制 3 文件分离 — 有 API 调用/大量逻辑但无 data.ts，或有 data.ts 仍泄漏 API 调用
+ */
+function checkR8FileSeparation(scriptContent, effectiveLines, hasDataTs, pageDir, fullSource, issues) {
+  const hasApiCall = /getAction|postAction|putAction|deleteAction|API_CONFIG/.test(
+    stripCommentsAndStrings(scriptContent),
+  );
+  const ignore = hasIgnoreMarker(fullSource, "R8");
+  if (!hasDataTs) {
+    if (hasApiCall && !ignore) {
+      issues.push({
+        level: "error",
+        dir: pageDir,
+        text: "页面有接口调用但缺 data.ts（业务逻辑必须在 data.ts 中）",
+        rule: "R8",
+      });
+    } else if (effectiveLines > 20 && !ignore) {
+      issues.push({
+        level: "warn",
+        dir: pageDir,
+        text: "index.vue 有 " + effectiveLines + " 行逻辑但无 data.ts（建议拆分）",
+        rule: "R8",
+      });
+    }
+  }
+  // 有 data.ts 但 index.vue 仍然有 API 调用（逻辑泄漏）
+  if (hasDataTs && hasApiCall && !ignore) {
+    issues.push({
+      level: "error",
+      dir: pageDir,
+      text: "有 data.ts 但 index.vue 中仍含 API 调用（逻辑应全部在 data.ts）",
+      rule: "R8",
+    });
+  }
+}
+
+/**
+ * R13: 单函数圈复杂度 > MAX_CYCLOMATIC_COMPLEXITY → error
+ *     覆盖 index.vue <script> 与 data.ts 的所有函数/方法/箭头函数（嵌套函数独立计）
+ */
+function checkR13Complexity(scriptContent, dataPath, pageDir, fullSource, issues) {
+  if (hasIgnoreMarker(fullSource, "R13")) return;
+  const maxC = CONFIG.MAX_CYCLOMATIC_COMPLEXITY;
+  const scanComplexity = (code, label) => {
+    const ast = parseScriptAst(code);
+    if (!ast) return;
+    for (const fn of collectFunctions(ast)) {
+      const cc = computeFunctionComplexity(fn.node);
+      if (cc > maxC) {
+        issues.push({
+          level: "error",
+          dir: pageDir,
+          text:
+            label + " 函数 " + fn.name +
+            "() 圈复杂度 " + cc + "（阈值 " + maxC +
+            "），需拆分为更小函数（standard 04）",
+          rule: "R13",
+        });
+      }
+    }
+  };
+  scanComplexity(scriptContent, "index.vue");
+  if (fs.existsSync(dataPath)) {
+    scanComplexity(fs.readFileSync(dataPath, "utf8"), "data.ts");
+  }
+}
+
 // ─── 主检测函数 ────────────────────────────────────────────────────────
 
 /**
@@ -632,31 +693,7 @@ function runAstRules(targetDir, scanRel, options) {
 
     // R13: 单函数圈复杂度 ≤ MAX_CYCLOMATIC_COMPLEXITY（standard 04，Mcabe）
     //     覆盖 index.vue <script> 与 data.ts 的所有函数/方法/箭头函数
-    if (!hasIgnoreMarker(fullSource, "R13")) {
-      const maxC = CONFIG.MAX_CYCLOMATIC_COMPLEXITY;
-      const scanComplexity = (code, label) => {
-        const ast = parseScriptAst(code);
-        if (!ast) return;
-        for (const fn of collectFunctions(ast)) {
-          const cc = computeFunctionComplexity(fn.node);
-          if (cc > maxC) {
-            issues.push({
-              level: "error",
-              dir: page.dir,
-              text:
-                label + " 函数 " + fn.name +
-                "() 圈复杂度 " + cc + "（阈值 " + maxC +
-                "），需拆分为更小函数（standard 04）",
-              rule: "R13",
-            });
-          }
-        }
-      };
-      scanComplexity(scriptContent, "index.vue");
-      if (fs.existsSync(dataPath)) {
-        scanComplexity(fs.readFileSync(dataPath, "utf8"), "data.ts");
-      }
-    }
+    checkR13Complexity(scriptContent, dataPath, page.dir, fullSource, issues);
 
     // R2: 禁止的 import / 全局 API
     if (scriptContent) {
@@ -813,38 +850,10 @@ function runAstRules(targetDir, scanRel, options) {
 
     // R8: 强制 3 文件分离 — 有 API 调用/大量逻辑但无 data.ts
     // 任何页面（不分类型）只要有接口调用或超过阈值行数，就应该拆出 data.ts
-    {
-      const hasApiCall = /getAction|postAction|putAction|deleteAction|API_CONFIG/.test(
-        stripCommentsAndStrings(scriptContent),
-      );
-      const hasScss = page.names.has("index.scss");
-      if (!page.names.has("data.ts")) {
-        if (hasApiCall && !hasIgnoreMarker(fullSource, "R8")) {
-          issues.push({
-            level: "error",
-            dir: page.dir,
-            text: "页面有接口调用但缺 data.ts（业务逻辑必须在 data.ts 中）",
-            rule: "R8",
-          });
-        } else if (effectiveLines > 20 && !hasIgnoreMarker(fullSource, "R8")) {
-          issues.push({
-            level: "warn",
-            dir: page.dir,
-            text: "index.vue 有 " + effectiveLines + " 行逻辑但无 data.ts（建议拆分）",
-            rule: "R8",
-          });
-        }
-      }
-      // 有 data.ts 但 index.vue 仍然有 API 调用（逻辑泄漏）
-      if (page.names.has("data.ts") && hasApiCall && !hasIgnoreMarker(fullSource, "R8")) {
-        issues.push({
-          level: "error",
-          dir: page.dir,
-          text: "有 data.ts 但 index.vue 中仍含 API 调用（逻辑应全部在 data.ts）",
-          rule: "R8",
-        });
-      }
-    }
+    checkR8FileSeparation(
+      scriptContent, effectiveLines, page.names.has("data.ts"),
+      page.dir, fullSource, issues,
+    );
 
     // R9: api.md 质量检测 — 有 API_CONFIG 时检查 api.md 结构完整性
     if (page.names.has("data.ts")) {
@@ -855,10 +864,6 @@ function runAstRules(targetDir, scanRel, options) {
       if (hasApiConfig && page.names.has("api.md")) {
         const apiMdPath = path.join(absDir, "api.md");
         const apiMdContent = fs.readFileSync(apiMdPath, "utf-8");
-        // 检查 api.md 是否有接口列表表格（核心结构）
-        const hasInterfaceTable = /\|\s*操作\s*\|.*\|\s*Method\s*\||\|\s*操作\s*\|.*\|\s*URL\s*\|/.test(apiMdContent);
-        // 检查 api.md 是否有实体定义
-        const hasEntityDef = /字段|实体|Entity|字段名/.test(apiMdContent);
         // 检查 api.md 中的 URL 是否与 data.ts API_CONFIG 一致
         // 正则匹配 URL 路径：支持多段、数字、连字符、下划线
         // 例：/mdata/mdataModel/list /api/v2/customer-archive/save /sys/user_role/list
@@ -1100,22 +1105,26 @@ function runTypeCheck(root) {
     if (result.status === 0) {
       return { issues: [], ran: true, errorCount: 0 };
     }
-    // 退出码非 0 但未解析出标准 error 行：疑似 tsconfig / 配置级错误
+    // 退出码非 0 但未解析出标准 error 行：区分配置级错误与未知失败
+    // tsconfig 配置问题（extends 不存在、语法错等）归为 warn（非类型错误，不阻断类型门禁）
+    const isConfigError = /tsconfig|Cannot find module.*\.json|error TS6053|error TS5023|File not found/i.test(out);
     return {
       issues: [
         {
-          level: "error",
+          level: isConfigError ? "warn" : "error",
           dir: label,
           text:
             checker +
             " --noEmit 退出码 " +
             result.status +
-            "（请检查 tsconfig / 类型配置，无标准 TS 错误输出）",
+            (isConfigError
+              ? "（疑似 tsconfig 配置问题，非类型错误，请检查 tsconfig.json）"
+              : "（无标准 TS 错误输出，请检查 tsconfig / 类型配置）"),
           rule: "R14",
         },
       ],
       ran: true,
-      errorCount: 1,
+      errorCount: isConfigError ? 0 : 1,
     };
   }
 

package/lib/page-spec.js

@@ -262,7 +262,7 @@ function extractOperationSequence(dataContent) {
   for (const item of items) {
     const labelM = item.match(/(?:^|[\s,{])label\s*:\s*["'`]([^"'`]+)["'`]/);
     const typeM = item.match(/(?:^|[\s,{])type\s*:\s*["'`]([^"'`]+)["'`]/);
-    let label = labelM ? labelM[1] : typeM ? TYPE_LABEL[typeM[1]] : null;
+    const label = labelM ? labelM[1] : typeM ? TYPE_LABEL[typeM[1]] : null;
     if (label) result.push({ label });
   }
   return result;
@@ -288,9 +288,6 @@ function extractBracketBody(source, openIdx) {
 function seqNames(seq) {
   return seq.map((x) => x.name).filter(Boolean);
 }
-function seqLabels(seq) {
-  return seq.map((x) => x.label).filter(Boolean);
-}
 
 /** 数组顺序是否严格相等 */
 function arrayEq(a, b) {
@@ -314,6 +311,31 @@ function pushMissingImplementationIssue(issues, level, dir, rule, target) {
   });
 }
 
+/**
+ * S3 颜色比对：集合一致时逐个核对 toolbar 按钮颜色（抽出降低 compareSpecToCode 复杂度）
+ */
+function pushToolbarColorIssues(specToolbar, actualToolbar, dir, issues) {
+  const actualByLabel = new Map(actualToolbar.map((b) => [b.label, b]));
+  for (const sb of specToolbar) {
+    if (!sb.label || !sb.color) continue;
+    const ab = actualByLabel.get(sb.label);
+    if (ab && ab.color !== sb.color) {
+      issues.push({
+        level: "warn",
+        dir,
+        rule: "S3",
+        text:
+          '按钮"' +
+          sb.label +
+          '"颜色与原型不一致：spec=' +
+          sb.color +
+          " vs code=" +
+          ab.color,
+      });
+    }
+  }
+}
+
 /**
  * 比对 page-spec 与 data.ts 实际实现
  * @param {object} spec     page-spec.json 对象
@@ -444,25 +466,7 @@ function compareSpecToCode(spec, dataContent, dir) {
       }
       // 颜色比对（仅在集合一致时逐个核对）
       if (specLabels.length && actualLabels.length && setEq(specLabels, actualLabels)) {
-        const actualByLabel = new Map(actual.map((b) => [b.label, b]));
-        for (const sb of spec.toolbar) {
-          if (!sb.label || !sb.color) continue;
-          const ab = actualByLabel.get(sb.label);
-          if (ab && ab.color !== sb.color) {
-            issues.push({
-              level: "warn",
-              dir,
-              rule: "S3",
-              text:
-                '按钮"' +
-                sb.label +
-                '"颜色与原型不一致：spec=' +
-                sb.color +
-                " vs code=" +
-                ab.color,
-            });
-          }
-        }
+        pushToolbarColorIssues(spec.toolbar, actual, dir, issues);
       }
     }
   }

package/lib/vite-plugin-wl-skills.js

@@ -23,8 +23,6 @@
  *   ⑤ Vite 插件层（本插件） → 构建时自动执行，无需额外配置 ← 不可绕开
  */
 
-const path = require("path");
-
 let astRules = null;
 try {
   astRules = require("./ast-rules.js");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.11.3",
-  "description": "AI Skill 模板包 v2.11.3 — 14 条编码规范 + 11 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目（.wl-skills/ 统一隔离架构）",
+  "version": "2.11.4",
+  "description": "AI Skill 模板包 v2.11.4 — 14 条编码规范 + 11 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目（.wl-skills/ 统一隔离架构）",
   "main": "./bin/wl-skills.js",
   "packageManager": "pnpm@11.5.3",
   "bin": {
@@ -48,11 +48,11 @@
     "lint:skills": "node scripts/lint-skills.js",
     "test": "vitest run",
     "version:verify": "node scripts/verify-version.js",
-    "verify": "pnpm version:verify && pnpm lint:skills && pnpm test",
+    "verify": "pnpm version:verify && pnpm lint && pnpm lint:skills && pnpm test",
     "ci": "pnpm install --frozen-lockfile && pnpm verify",
     "pack:dry": "npm pack --dry-run --ignore-scripts",
     "release:check": "pnpm verify && npm pack --dry-run --ignore-scripts",
-    "prepublishOnly": "node scripts/verify-version.js && node scripts/lint-skills.js && vitest run"
+    "prepublishOnly": "node scripts/verify-version.js && pnpm lint && node scripts/lint-skills.js && vitest run"
   },
   "optionalDependencies": {
     "@babel/parser": "^7.20.0",
@@ -90,7 +90,13 @@
     }
   },
   "lint-staged": {
-    "src/**/*.{js,jsx,ts,tsx,vue}": [
+    "bin/**/*.js": [
+      "eslint --fix --no-cache"
+    ],
+    "lib/**/*.js": [
+      "eslint --fix --no-cache"
+    ],
+    "scripts/**/*.js": [
       "eslint --fix --no-cache"
     ]
   },