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

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # 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
+
+- **validate 项目级豁免配置（零功能影响）**：业务项目根可放 `.wl-skills-validate.json`，对表单设计器/行内编辑明细表等 BaseTable 受限场景批量豁免 `R3`/`R10`，kit 不主动创建、不存在时行为完全不变。新增 `lib/ast-rules.js` 的 `loadExemptions`，`runAstRules` 内部加载（CLI/MCP 自动一致）；与单文件注释豁免（`wl-skills:ignore R3`）互补。配置 schema 详见 `.wl-skills/docs/validate-exempt.md`
+- **standards/12 豁免规则重写**：明确"标准列表强制 BaseTable+AGGrid / BaseTable 可胜任仍优先 BaseTable / BaseTable 受限特殊场景可降级 el-table"三层优先级，两层豁免机制（单文件注释 + 项目级配置），不再一棍子拍死
+
+### Fixed
+
+- **README/脚本系统性滞后修正**：v2.11.0 目录从 `.github/` 迁移到 `.wl-skills/` 后，README 大量路径残留未同步；`sync-version.js`/`verify-version.js` 仍硬编码"13 条"（规范已升 14 条），导致 verify-version 的 headers 校验**静默失效**、`npm version` 触发 sync-version 会把"14 条"**回写成 13 条**。全部修正为 14 条 + `.wl-skills/` 路径，校验链路恢复
+- `_compat/headers/{cursor-mdc,trae,kiro}.txt` 源文件注释 `.github/copilot-instructions.md` → `.wl-skills/copilot-instructions-full.md`
+
 ## [2.11.2] - 2026-06-21
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.11.2** — 一键将 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）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
@@ -25,7 +25,13 @@ pnpm standards:init                           # 本包维护/业务项目均可
 
 ## 版本亮点
 
-**v2.11.1**：精准卡控闭环 —— 把"约定"接线到确定性执行器，生成即精确。
+**v2.11.3**：确定性闭环再加固 —— 编码最佳实践从"文档约定"接线到执行器，特殊场景豁免可配置。
+
+- **新增 R13 圈复杂度执行器（standard 04）**：对每个函数计 McCabe 圈复杂度（与 ESLint `complexity` 一致），`>10` 报 error 阻断；补"降复杂度手法"示例
+- **新增 R14 类型错误零容忍（standard 09 升级为 🔴必遵）**：委托 `vue-tsc/tsc --noEmit` 解析 TS error，`validate --typecheck` / MCP `typecheck:true` 触发，无 checker 优雅降级；ESLint 管风格、R14 管正确性，职责分离
+- **新增 validate 项目级豁免配置**：`.wl-skills-validate.json` 对表单设计器/行内编辑明细表等 BaseTable 受限场景批量豁免 R3/R10，零功能影响（kit 不主动创建）；与单文件注释豁免互补
+
+**v2.11.1**：精准卡控闭环 —— 把"约定"接线到确定性执行器，生成即精准。
 
 - **新增 page-spec 落盘 + spec-align 确定性比对（S1~S5）**：`page-codegen` 生成页面时同步写出 `page-spec.json`（原型约定真值），`validate` 用 AST 解析 `data.ts` 的 `queryDef/columnsDef/toolbarDef` 与之逐项比对——查询字段顺序、表格列顺序、工具栏按钮顺序与颜色、操作列按钮集合、label 文字保真。过去只靠 AI 自觉的 6 条"精准实现"约定，现在变成可阻断的硬卡控
 - **新增 `wl-skills fix` 确定性机械修复**：对幂等、零语义判断的偏差（BaseTable 补 `render-type`、`::v-deep`→`:deep()`、行尾空白、文件末尾换行）做确定性自动修复，AI 只处理需语义判断的部分；`--dry-run` 预览
@@ -115,7 +121,7 @@ docs/business/0X-xx/{index,requirement,dictionary,field}.md
 api.md（页面级前后端契约）
     │
     ▼ [Skill: page-codegen]
-data.ts + index.vue + index.scss（13 条 standards 自动满足）
+data.ts + index.vue + index.scss（14 条 standards 自动满足）
     │
     ▼ [Skill: convention-audit]        ← 也可对存量代码单独触发
 reports/AUDIT_AI_*.md + AUDIT_HUMAN_*.md
@@ -147,9 +153,9 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   └── wl-skills.js                      CLI 实现（init / update / clean / check / diff / validate / validate-page / fix / doctor-ui / export / mock-clean）
 │
 ├── files/                                ★★★ 真正会被打包并复制到业务项目的内容 ★★★
-│   ├── .github/
-│   │   ├── copilot-instructions.md       源 AI 主入口（编辑这里，不要编辑业务项目里的副本）
-│   │   ├── standards/                    13 条规范
+│   ├── .wl-skills/                       统一隔离目录（所有 Skill/规范/指南/报告/模板）
+│   │   ├── copilot-instructions-full.md  AI 主入口完整指令（业务项目根另有薄壳）
+│   │   ├── standards/                    14 条规范
 │   │   ├── skills/                       Skill 目录（含 _compat/ 多编辑器适配源）
 │   │   ├── guides/                       人读指南
 │   │   └── reports/                      领域基线模板（菜单/字典/权限）
@@ -182,14 +188,14 @@ wl-skills-kit/                            ← 你正看的这个仓库
 ```
 你的业务项目/
 │
-├── .github/                              ← 来自本包 files/.github/
-│   ├── copilot-instructions.md           Copilot 主入口（精简 ~340 行）
-│   ├── standards/                        13 条模块化规范 + index.md 门控
+├── .wl-skills/                           ← 来自本包 files/.wl-skills/（统一隔离）
+│   ├── copilot-instructions-full.md      Copilot 完整指令
+│   ├── standards/                        14 条模块化规范 + index.md 门控
 │   │   ├── 01-toolchain.md
 │   │   ├── 02-code-structure.md
-│   │   ├── ... (共 13 条)
-│   │   └── 13-platform-components.md
-│   ├── skills/                           10 个启用 Skill（全部激活）
+│   │   ├── ... (共 14 条)
+│   │   └── 14-layout-containers.md
+│   ├── skills/                           11 个启用 Skill（全部激活）
 │   │   ├── _registry.md                  ★ 触发词 → SKILL 路径单一数据源
 │   │   ├── _compat/                      多 AI 编辑器适配（配置 + headers）
 │   │   ├── core/                         核心通用 Skill
@@ -208,6 +214,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   │   │   └── code-fix/         { SKILL.md }  已启用
 │   │   └── domain/                       领域专属（按需创建）
 │   ├── guides/                           人读指南（usage.md / architecture.md）
+│   ├── docs/                             组件 API 文档 + validate 豁免配置说明
 │   └── reports/                          AI 生成报告（追加不覆盖）
 │       ├── SYS_MENU_INFO.md              线上菜单基线
 │       ├── SYS_DICT_INFO.md              线上字典基线
@@ -225,12 +232,13 @@ wl-skills-kit/                            ← 你正看的这个仓库
 ├── .trae/rules/conventions.md            Trae（含 alwaysApply frontmatter）
 ├── .qoder/rules/conventions.md           Qoder
 │
+├── .wl-skills-validate.json              ← 可选：validate 项目级豁免配置（kit 不创建）
 ├── mock/                                 ← 来自本包 files/mock/（init 自动写入）
 │   ├── _utils.ts                         共享工具（pageResult / ok / paginate / nowStr / pick）
 │   └── [业务域]/[模块].ts               按域分目录，page-codegen 自动生成
 │
-├── docs/                                 12 个组件 API 文档 + mock-architecture.md
-├── demo/                                 13 个领域样例
+├── docs/                                 组件 API 文档 + mock-architecture.md
+├── demo/                                 领域样例
 └── src/
     ├── components/                       全局/局部/远程组件
     └── types/                            类型桶文件
@@ -238,7 +246,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 
 > **业务项目方准则**：
 >
-> - 主入口是 `.github/copilot-instructions.md`（Copilot 用），**其他根配置文件是它的拷贝 + 各自特化 frontmatter**
+> - 主入口是 `.wl-skills/copilot-instructions-full.md`（Copilot 用），业务项目根的薄壳文件指向它；**其他根配置文件是它的拷贝 + 各自特化 frontmatter**
 > - 修改规范 → **不要**改业务项目里的副本，**升级 wl-skills-kit 包 + `update`** 才不会被覆盖
 > - reports/ 里的内容是团队累积数据，`update` 不会覆盖，可放心 commit
 
@@ -262,11 +270,19 @@ pnpm dlx @agile-team/wl-skills-kit check
 pnpm dlx @agile-team/wl-skills-kit diff
 
 # 静态检查 src/views 页面文件完整性 + AGGrid/cid/skills-ui/mock
+# 内含 AST 语义级检测 R1~R14（正则覆盖不到的语义约束）
+# R13 圈复杂度 / R14 类型错误需 --typecheck 开启
 pnpm dlx @agile-team/wl-skills-kit validate
 
+# 含类型检查 R14（vue-tsc/tsc --noEmit，CI / 发版前用）
+pnpm dlx @agile-team/wl-skills-kit validate --typecheck --strict
+
 # 单页/指定目录校验
 pnpm dlx @agile-team/wl-skills-kit validate-page src/views/mdata/model/mdata-model-config
 
+# 特殊场景（表单设计器/行内编辑明细表等 BaseTable 受限）批量豁免 R3/R10：
+# 在项目根创建 .wl-skills-validate.json（详见 .wl-skills/docs/validate-exempt.md）
+
 # spec-align：页面目录存在 page-spec.json 时，确定性比对"约定 vs 代码"
 # （查询字段/表格列顺序、工具栏按钮顺序与颜色、操作列严格对应、label 保真）
 # 已内置于 validate，无需额外参数
@@ -340,7 +356,7 @@ pnpm dlx @agile-team/wl-skills-kit update
 2. **迁移清理** — 检测并移除旧版遗留文件（如 `skills/prototype-scan/`、`docs/menu-sync-design.md` 等），避免新旧路径并存产生歧义
 3. **保护累积数据** — `reports/*.md` 已存在则跳过，团队累积的菜单/字典数据不丢失
 
-> **注意**：如果项目在旧的 `.github/skills/menu-sync/env/env.local.json` 中有自定义配置，`update` 会将其迁移位置（删旧、新路径文件由 `init` 写入默认模板）。**请在 `update` 前备份** 或 `update` 后手动迁移到 `.github/skills/sync/menu-sync/env/env.local.json`。
+> **注意**：如果项目在旧的 `.wl-skills/skills/menu-sync/env/env.local.json` 中有自定义配置，`update` 会将其迁移位置。**请在 `update` 前备份** 或 `update` 后手动迁移到 `.wl-skills/skills/sync/menu-sync/env/env.local.json`。
 
 ---
 
@@ -352,7 +368,7 @@ pnpm dlx @agile-team/wl-skills-kit update
 | `spec-doc-parse`   | ✅ 启用 | `skills/core/spec-doc-parse/`   | 规范线：wl-skills-design 标准说明书 → 页面清单 |
 | `api-contract`     | ✅ 启用 | `skills/core/api-contract/`     | 生成 api.md 前后端契约                      |
 | `page-codegen`     | ✅ 启用 | `skills/core/page-codegen/`     | 页面骨架生成 + 模板调度                     |
-| `convention-audit` | ✅ 启用 | `skills/core/convention-audit/` | 13 条规范扫描 + 双报告                      |
+| `convention-audit` | ✅ 启用 | `skills/core/convention-audit/` | 14 条规范扫描 + 双报告                      |
 | `business-doc-extract` | ✅ 启用 | `skills/core/business-doc-extract/` | 语义触发，业务文档抽取与维护            |
 | `template-extract` | ✅ 启用 | `skills/core/template-extract/` | 现有页面 → 领域模板                         |
 | `menu-sync`        | ✅ 启用 | `skills/sync/menu-sync/`        | 菜单基线 ↔ 后端接口                         |
@@ -389,9 +405,9 @@ pnpm dlx @agile-team/wl-skills-kit update
 
 | 命令                   | 保护路径                         | 说明                     |
 | ---------------------- | -------------------------------- | ------------------------ |
-| `init` / `update`      | `.github/reports/*.md`           | 已存在则跳过，不覆盖累积 |
+| `init` / `update`      | `.wl-skills/reports/*.md`        | 已存在则跳过，不覆盖累积 |
 | `clean`（默认）        | `src/components/` + `src/types/` | 业务代码必需，永不删除   |
-| `clean --keep-reports` | + `.github/reports/`             | 保留菜单/字典/权限基线   |
+| `clean --keep-reports` | + `.wl-skills/reports/`          | 保留菜单/字典/权限基线   |
 
 ---
 
@@ -424,8 +440,9 @@ AbstractPageQueryHook + BaseQuery + BaseToolbar + BaseTable(render-type="agGrid"
 - 🔁 Agent Pipeline 运行手册：[docs/agent-pipeline-runbook.md](docs/agent-pipeline-runbook.md)
 - 🛡️ MCP Tool 风险矩阵：[docs/mcp-tool-risk-matrix.md](docs/mcp-tool-risk-matrix.md)
 - 📝 业务文档抽取 Skill：[files/.wl-skills/skills/core/business-doc-extract/USAGE.md](files/.wl-skills/skills/core/business-doc-extract/USAGE.md)
-- 📚 业务方使用指南：`.github/guides/usage.md`（业务项目内）
-- 🏗️ 架构与决策：`.github/guides/architecture.md`（业务项目内）
+- 📚 业务方使用指南：`.wl-skills/guides/usage.md`（业务项目内）
+- 🏗️ 架构与决策：`.wl-skills/guides/architecture.md`（业务项目内）
+- 🛡️ validate 豁免配置：[files/.wl-skills/docs/validate-exempt.md](files/.wl-skills/docs/validate-exempt.md)
 - 🔧 维护者文档：[kit-internal/README.md](kit-internal/README.md)（仅本仓库）
 - 🤖 多编辑器适配机制：[files/.wl-skills/skills/\_compat/README.md](files/.wl-skills/skills/_compat/README.md)
 - 🛠️ Jenkins 流水线参考：[kit-internal/jenkins-pipeline.md](kit-internal/jenkins-pipeline.md)

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.11.2
+ * 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/docs/validate-exempt.md

@@ -0,0 +1,113 @@
+# validate 豁免配置（.wl-skills-validate.json）
+
+> **版本**：v2.11.3+ 引入。对应执行器 `loadExemptions`（`lib/ast-rules.js`）。
+> **零功能影响**：kit 不主动创建该文件；不存在时 validate 行为完全不变。
+
+---
+
+## 用途
+
+对"标准列表页强制 `BaseTable + AGGrid`"等规则，**批量豁免特殊场景目录**：
+表单设计器内嵌表格、行内编辑明细表等 BaseTable 受限的场景。
+
+与单文件注释豁免（`<!-- wl-skills:ignore R3 -->`）互补：
+
+| 机制 | 粒度 | 适用 |
+|---|---|---|
+| 单文件注释 | 精确到单个文件 | 个别特殊页面 |
+| 项目级配置（本文件） | 批量到目录前缀 | 整片特殊场景（设计器/编辑器域） |
+
+---
+
+## 文件位置
+
+业务项目**根目录**（与 `.wl-skills-manifest.json` 同级）：
+
+```
+你的业务项目/
+├── .wl-skills-validate.json   ← 本文件（可选，按需创建）
+├── .wl-skills-manifest.json
+└── src/
+```
+
+---
+
+## Schema
+
+```json
+{
+  "exemptions": [
+    {
+      "paths": ["<页面目录前缀，支持 /**>"],
+      "rules": ["<规则编号，如 R3 R10，大小写不敏感>"],
+      "reason": "<必填，审计用途，说明为何豁免>"
+    }
+  ]
+}
+```
+
+### 字段说明
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `exemptions` | array | 是 | 豁免条目数组 |
+| `exemptions[].paths` | string[] | 是 | 页面目录前缀。支持 `/**` glob；命中该目录**及其子目录**下所有页面 |
+| `exemptions[].rules` | string[] | 是 | 规则编号（`R3`/`R10` 等），大小写不敏感 |
+| `exemptions[].reason` | string | 是 | 审计字段，说明豁免原因，避免滥用 |
+
+### 路径匹配规则
+
+- `src/views/produce/designer` → 命中 `src/views/produce/designer` 及 `src/views/produce/designer/**`
+- `src/views/sale/order/**` → 等价于上一行（显式 glob）
+- 路径分隔符自动规范化（Windows `\` → `/`），末尾 `/` 被忽略
+
+---
+
+## 当前可豁免规则
+
+| 规则 | 检测内容 | 典型豁免场景 |
+|---|---|---|
+| `R3` | el-table 未用 BaseTable | 表单设计器内嵌表格、行内编辑明细表 |
+| `R10` | el-form/el-select 等原生组件未用平台封装 | 设计器/自定义编辑器内部 |
+
+> 其他规则（R1/R2/R4~R9/R11~R14）原则上不豁免；确有需要时用单文件注释豁免。
+
+---
+
+## 完整示例
+
+```json
+{
+  "exemptions": [
+    {
+      "paths": ["src/views/produce/designer"],
+      "rules": ["R3", "R10"],
+      "reason": "表单设计器内嵌表格 + 自定义编辑器，BaseTable AGGrid 内联编辑受限"
+    },
+    {
+      "paths": ["src/views/sale/order-edit/**"],
+      "rules": ["R3"],
+      "reason": "订单行内编辑明细表，AGGrid 行编辑成本高于收益"
+    },
+    {
+      "paths": ["src/components/business/rich-table"],
+      "rules": ["R3"],
+      "reason": "复杂合并单元格/自定义行列布局，AGGrid 不易实现"
+    }
+  ]
+}
+```
+
+---
+
+## 验证
+
+```bash
+# 跑 validate，命中豁免的页面不再报对应规则
+wl-skills validate src/views
+
+# 豁免配置格式错误时，validate 输出 warn 提示（不阻断），行为退化为无豁免
+```
+
+> 豁免项升级为主列表页时，必须迁移回 `BaseTable + AGGrid` 并从本文件移除豁免。
+> `convention-audit` 审计会列出所有豁免项供人工复核。

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

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

package/files/.wl-skills/skills/_compat/headers/cursor-mdc.txt

@@ -10,7 +10,7 @@ alwaysApply: true
 ---
 
 <!-- Cursor MDC 规则文件。由 @agile-team/wl-skills-kit 自动生成。 -->
-<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
+<!-- 源文件：.wl-skills/copilot-instructions-full.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
 
 ---
 

package/files/.wl-skills/skills/_compat/headers/kiro.txt

@@ -4,7 +4,7 @@ description: 项目编码规范（14 条标准 + 11 个 Skill 自动调度）
 ---
 
 <!-- Kiro Steering 规则。由 @agile-team/wl-skills-kit 自动生成。-->
-<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
+<!-- 源文件：.wl-skills/copilot-instructions-full.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
 
 ---
 

package/files/.wl-skills/skills/_compat/headers/trae.txt

@@ -5,7 +5,7 @@ alwaysApply: true
 ---
 
 <!-- Trae Rules 规则。由 @agile-team/wl-skills-kit 自动生成。-->
-<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
+<!-- 源文件：.wl-skills/copilot-instructions-full.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
 
 ---
 

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/files/.wl-skills/standards/12-base-table.md

@@ -132,10 +132,62 @@ subColumnsDef(): TableColumnDesc<any>[] {
 
 ### 豁免规则
 
-- 豁免场景仍**优先使用 `BaseTable`**（非 AGGrid 模式），而非裸 `el-table`
-- 豁免场景如果支持列持久化，仍**必须有 `cid`**
-- 审查报告中豁免项必须标注**原因**，避免滥用
-- 如果豁免场景后续升级为主列表，必须迁移到 AGGrid
+> **两层豁免机制**：单文件注释豁免（精确）+ 项目级配置豁免（批量）。标准列表页不受豁免影响，仍强制 `BaseTable + AGGrid`。
+
+#### 优先级：标准列表 vs 特殊场景
+
+| 场景类型 | 渲染要求 | R3（el-table）/ AGGrid 卡控 |
+|---|---|---|
+| **标准列表页**（分页查询、台账、核心业务列表） | `BaseTable` + `render-type="agGrid"` + `cid` | 🔴 强制，不可豁免 |
+| **BaseTable 可胜任的特殊表格**（弹窗小表、只读展示、嵌套子表） | `BaseTable`（非 AGGrid 也可），尽量带 `cid` | 🟢 豁免 AGGrid（R3 仍建议改 BaseTable） |
+| **BaseTable 受限的复杂场景**（表单/设计器内嵌表格、行内编辑明细表、特殊合并单元格/复杂行列布局） | 优先 `BaseTable`；确实受限时降级 `el-table` | 🟢 可豁免 R3（需登记豁免原因） |
+| **平台封装组件内部** | 按需 | 🟢 豁免 R3（封装层单独评审） |
+
+> 判定原则：**先用 BaseTable**；BaseTable 确实受限不能满足时，才降级 `el-table`，不直接裸用。
+
+#### 豁免方式一：单文件注释（精确到文件）
+
+在特殊文件内加注释标记，精确豁免该文件的指定规则（适合个别页面）：
+
+```vue
+<!-- index.vue -->
+<!-- wl-skills:ignore R3 -->   ← 整页豁免 R3（el-table 检测）
+<template>
+  <el-table> ... </el-table>   <!-- 表单设计器内嵌表格，AGGrid 内联编辑受限 -->
+</template>
+```
+
+```typescript
+// data.ts
+// wl-skills:ignore R10         ← 豁免该文件的 R10
+```
+
+#### 豁免方式二：项目级配置（批量到目录，推荐用于整片特殊场景）
+
+项目根放 `.wl-skills-validate.json`（kit 不主动创建，零功能影响；详见 `docs/validate-exempt.md`）：
+
+```json
+{
+  "exemptions": [
+    {
+      "paths": ["src/views/produce/designer"],
+      "rules": ["R3", "R10"],
+      "reason": "表单设计器内嵌表格，BaseTable AGGrid 内联编辑受限"
+    },
+    {
+      "paths": ["src/views/sale/order-edit/**"],
+      "rules": ["R3"],
+      "reason": "订单行内编辑明细表，AGGrid 行编辑成本高于收益"
+    }
+  ]
+}
+```
+
+- `paths`：页面目录前缀，支持 `/**` glob；命中该目录及其子目录
+- `rules`：规则编号（`R3`/`R10` 等），大小写不敏感
+- `reason`：**必填审计字段**，避免滥用
+
+> ⚠️ 豁免不是放任。豁免项升级为主列表页时，必须迁移回 `BaseTable + AGGrid`。`convention-audit` 审计时列出所有豁免项供人工复核。
 
 ### 审查报告中的分类
 

package/files/.wl-skills/standards/13-platform-components.md

@@ -116,6 +116,7 @@ export function createPage() {
 
 - [ ] 查询区使用了 BaseQuery，没有自己写 el-form？
 - [ ] 表格使用了 BaseTable + agGrid + cid，没有用 el-table？
+      （BaseTable 受限的特殊场景如表单/设计器内嵌表格，登记豁免后可用 el-table，见 standards/12 §豁免规则）
 - [ ] 弹窗使用了 c_formModal / c_listModal，没有手写 el-dialog？
 - [ ] 日期组件用了 jh-date 系列，没有用 el-date-picker？
 - [ ] HTTP 请求都走 `this.getAction / postAction`，没有 import axios？

package/lib/ast-rules.js

@@ -31,6 +31,7 @@
  *   countEffectiveLines(scriptContent) → number
  *   computeFunctionComplexity(fnNode) → number
  *   runTypeCheck(root) → { issues, ran, errorCount }
+ *   loadExemptions(targetDir) → { isExempt, source, warnings }
  *   hasAstAvailable() → boolean
  */
 
@@ -51,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");
@@ -75,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 {}
@@ -169,9 +162,87 @@ const CONFIG = {
   MAX_CYCLOMATIC_COMPLEXITY: 10,
   // R14: 单页类型错误采集上限（避免输出爆炸）
   TYPECHECK_ERROR_CAP: 50,
+  // 项目级豁免配置文件名（业务项目根，kit 不主动创建，零功能影响）
+  EXEMPT_CONFIG_NAME: ".wl-skills-validate.json",
   SKIP_DIRS: ["node_modules", "dist", ".git", "demo", "template"],
 };
 
+// ─── 项目级豁免配置（零功能影响，可选）──────────────────────────────────
+//
+// 业务项目根可放 .wl-skills-validate.json，对指定路径前缀批量豁免规则：
+//   {
+//     "exemptions": [
+//       {
+//         "paths": ["src/views/produce/designer"],
+//         "rules": ["R3", "R10"],
+//         "reason": "表单设计器内嵌表格，BaseTable AGGrid 内联编辑受限"
+//       }
+//     ]
+//   }
+//
+// 与单文件注释豁免（wl-skills:ignore R3）互补：注释精确到单文件，
+// 配置批量到目录。无配置文件时返回空豁免，行为完全不变。
+
+/**
+ * 加载项目级豁免配置
+ * @param {string} targetDir 项目根目录
+ * @returns {{ isExempt: (pageDir:string, rule:string)=>boolean, source: string|null, warnings: string[] }}
+ */
+function loadExemptions(targetDir) {
+  const warnings = [];
+  const configPath = path.join(
+    targetDir || process.cwd(),
+    CONFIG.EXEMPT_CONFIG_NAME,
+  );
+  if (!fs.existsSync(configPath)) {
+    return { isExempt: () => false, source: null, warnings };
+  }
+  let raw;
+  try {
+    raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
+  } catch (e) {
+    warnings.push(
+      CONFIG.EXEMPT_CONFIG_NAME +
+        " 解析失败，已忽略（" +
+        ((e && e.message) || String(e)) +
+        "）",
+    );
+    return { isExempt: () => false, source: configPath, warnings };
+  }
+  const list = Array.isArray(raw.exemptions) ? raw.exemptions : [];
+  // 预编译：每个 path 规范化为前缀，每个 entry 的 rules 转大写 Set
+  const compiled = [];
+  for (const entry of list) {
+    if (!entry || !Array.isArray(entry.paths) || !Array.isArray(entry.rules)) {
+      continue;
+    }
+    const rules = new Set(
+      entry.rules.map((r) => String(r).toUpperCase()),
+    );
+    for (let p of entry.paths) {
+      p = String(p).replace(/\\/g, "/").replace(/\/+$/, "");
+      if (p.endsWith("/**")) p = p.slice(0, -3);
+      if (p.endsWith("/*")) p = p.slice(0, -2);
+      compiled.push({ prefix: p, rules });
+    }
+  }
+  function isExempt(pageDir, rule) {
+    if (!pageDir || !rule) return false;
+    const dir = String(pageDir).replace(/\\/g, "/");
+    const r = String(rule).toUpperCase();
+    for (const c of compiled) {
+      if (
+        (c.rules.has(r)) &&
+        (dir === c.prefix || dir.startsWith(c.prefix + "/"))
+      ) {
+        return true;
+      }
+    }
+    return false;
+  }
+  return { isExempt, source: configPath, warnings };
+}
+
 // ─── 工具函数 ──────────────────────────────────────────────────────────
 
 function walkDir(dir, base, results) {
@@ -351,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;
   }
@@ -453,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");
+  }
+}
+
 // ─── 主检测函数 ────────────────────────────────────────────────────────
 
 /**
@@ -508,6 +648,12 @@ function runAstRules(targetDir, scanRel, options) {
   const issues = [];
   const globalCidMap = new Map(); // cid → Set<pageDir>
 
+  // 项目级豁免配置（零功能影响，无配置文件时返回空豁免）
+  const exempt = loadExemptions(targetDir);
+  for (const w of exempt.warnings) {
+    issues.push({ level: "warn", dir: ".", text: w, rule: "EXEMPT" });
+  }
+
   for (const page of pages) {
     const absDir = path.join(targetDir, page.dir);
 
@@ -547,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) {
@@ -639,11 +761,12 @@ function runAstRules(targetDir, scanRel, options) {
       }
     }
 
-    // R3: el-table 但未用 BaseTable（检查豁免标记）
+    // R3: el-table 但未用 BaseTable（检查注释豁免 + 配置豁免）
     if (
       hasRawElTable(template) &&
       !hasBaseTable(template) &&
-      !hasIgnoreMarker(fullSource, "R3")
+      !hasIgnoreMarker(fullSource, "R3") &&
+      !exempt.isExempt(page.dir, "R3")
     ) {
       issues.push({
         level: "error",
@@ -727,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")) {
@@ -769,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
@@ -808,7 +899,8 @@ function runAstRules(targetDir, scanRel, options) {
         const tagRegex = new RegExp("<" + tag.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "[\\s>]");
         if (
           tagRegex.test(template) &&
-          !hasIgnoreMarker(fullSource, "R10")
+          !hasIgnoreMarker(fullSource, "R10") &&
+          !exempt.isExempt(page.dir, "R10")
         ) {
           issues.push({
             level: "error",
@@ -1013,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,
     };
   }
 
@@ -1054,6 +1150,7 @@ module.exports = {
   computeFunctionComplexity,
   collectFunctions,
   runTypeCheck,
+  loadExemptions,
   hasAstAvailable,
   isAstFunctionallyUsable,
   getStagedFiles,

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.2",
-  "description": "AI Skill 模板包 v2.11.2 — 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"
     ]
   },