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

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [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
+
+- **R13 圈复杂度执行器（standard 04，阻断级）**：新增 `lib/ast-rules.js` 的 R13，对 `index.vue`/`data.ts` 的每个函数计算 McCabe 圈复杂度（与 ESLint `complexity` 规则定义一致），`> 10` 报 error 阻断提交。补齐 standard 04 第 14 条核心约定 + 降复杂度手法示例（提前 return / 查表驱动 / 抽子函数）
+- **R14 类型错误零容忍执行器（standard 09，阻断级）**：新增 `runTypeCheck`，委托 `vue-tsc --noEmit`（回退 `tsc`）解析 TS error；无 `tsconfig`/checker 时优雅降级 warn。CLI 新增 `--typecheck`、MCP `wls_validate_page` 新增 `typecheck` 入参双通道一致。CI 应固定 `validate --typecheck --strict`
+
+### Changed
+
+- **standard 09 由 🟡建议 升级为 🔴必遵 + 阻断**：`vue-tsc --noEmit` 必须 0 error，职责分离——ESLint 管风格，R14 管类型正确性
+- `rule-coverage.md` 执行器图例 R1~R12 → R1~R14，登记 R13/R14 两条阻断约定；`convention-audit` 维度 09 改为 R14 委托
+- `eslint.config.ts` 复杂度 `warn 60` 修正为 `warn 10`（项目级硬阻断由 R13 兜底，此处仅作 kit 自身开发提示）
+
 ## [2.11.1] - 2026-06-15
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.11.1** — 一键将 14 条规范、11 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
+**AI Skill 模板包 v2.11.3** — 一键将 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.1
+ * wl-skills-kit CLI v2.11.3
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）
@@ -27,6 +27,7 @@ const {
   runAstRules,
   getStagedFiles,
   hasAstAvailable,
+  runTypeCheck,
 } = require("../lib/ast-rules");
 
 // ─── page-spec 比对引擎（v2.11.1+，"约定 vs 代码"确定性核对）────────────
@@ -66,6 +67,7 @@ const KNOWN_FLAGS = new Set([
   "--all",
   "--pre-commit",
   "--strict",
+  "--typecheck",
 ]);
 
 const dryRun = args.includes("--dry-run");
@@ -74,6 +76,7 @@ const keepReports = args.includes("--keep-reports");
 const force = args.includes("--force");
 const preCommit = args.includes("--pre-commit");
 const strict = args.includes("--strict");
+const typeCheck = args.includes("--typecheck");
 
 // 校验所有 flag 是否已知（--help 优先，跳过校验直接显示帮助）
 if (!showHelp) {
@@ -118,7 +121,8 @@ if (showHelp) {
     check      环境预检（Node / 工具链 / MCP 配置 / manifest）
     diff       对比已安装文件与当前 kit 版本的差异
     validate   静态检查 src/views 页面文件、AGGrid、skills-ui runtime、mock
-               v2.10.1+ 集成 AST 语义级检测（R1~R7），覆盖正则无法检测的规则
+               v2.10.1+ 集成 AST 语义级检测（R1~R14），覆盖正则无法检测的规则
+               R13 圈复杂度 / R14 类型错误（R14 需 --typecheck 开启）
     validate-page validate 的别名，适用于单页/目录检查
     doctor-ui  检查 @agile-team/wk-skills-ui 接入完整性
     export     导出 reports/SYS_* 数据为 xlsx
@@ -133,6 +137,8 @@ if (showHelp) {
     --all            mock-clean 清理全部 mock（保留 _utils.ts）
     --pre-commit     validate 仅检测 git staged 文件，error 阻断提交，warn 仅提示
     --strict         validate 的 error 和 warn 都导致退出码 1（CI 用）
+    --typecheck      validate 额外执行 vue-tsc/tsc --noEmit（R14 类型错误零容忍）
+                     体积较大，CI / pre-push 必跑，pre-commit 不建议开启
     --help           显示帮助
 
   示例:
@@ -142,6 +148,7 @@ if (showHelp) {
     pnpm dlx @agile-team/wl-skills-kit check                 检查本地环境
     pnpm dlx @agile-team/wl-skills-kit diff                  查看当前项目与最新 kit 差异
     pnpm dlx @agile-team/wl-skills-kit validate              检查 src/views 页面文件
+    pnpm dlx @agile-team/wl-skills-kit validate --typecheck  含类型检查 R14（CI 用）
     pnpm dlx @agile-team/wl-skills-kit validate-page src/views/mdata/model/demo
     pnpm dlx @agile-team/wl-skills-kit doctor-ui             检查 wk-skills-ui 接入
     pnpm dlx @agile-team/wl-skills-kit export                导出菜单/字典/权限 xlsx
@@ -1272,12 +1279,27 @@ function runValidate() {
     issues.push(...specIssues);
   }
 
+  // ── 类型检查 R14（v2.11.2+，vue-tsc/tsc 委托，仅 --typecheck 触发）───
+  // 体积较大（整项目编译），validate 默认不跑；pre-commit 不建议开启，CI 必跑。
+  // 无 tsconfig / 无 checker → 优雅降级为 warn，不阻断。
+  let tcRan = false;
+  let tcErrors = 0;
+  if (typeCheck) {
+    const tc = runTypeCheck(TARGET_DIR);
+    tcRan = tc.ran;
+    tcErrors = tc.errorCount || 0;
+    issues.push(...tc.issues);
+  }
+
   // ── 输出 ───────────────────────────────────────────────────────────
   console.log(
     "  页面目录: " +
       pages.length +
       (astResult.pages ? "（AST 扫描 " + astResult.pages + "）" : "") +
-      (specAlignedPages ? "（spec-align " + specAlignedPages + "）" : ""),
+      (specAlignedPages ? "（spec-align " + specAlignedPages + "）" : "") +
+      (typeCheck
+        ? "（类型检查 " + (tcRan ? "已执行 " + tcErrors + " error" : "已跳过") + "）"
+        : ""),
   );
   console.log("  提示项: " + issues.length);
   console.log("");
@@ -1384,6 +1406,8 @@ const AST_FIX_SUGGESTIONS = {
   R10: { fix: '\u66ff\u6362\u539f\u751f el-* \u7ec4\u4ef6\u4e3a\u5e73\u53f0\u5c01\u88c5\uff08jh-select/jh-date/jh-pagination \u7b49\uff09', ref: 'standards/13-platform-components.md', auto: true },
   R11: { fix: '\u4ece data.ts \u4e2d\u79fb\u9664 Pinia Store import\uff0cStore \u5e94\u5728\u7ec4\u4ef6\u5c42\u4f7f\u7528', ref: 'standards/10-pinia.md', auto: true },
   R12: { fix: '\u5c06\u786c\u7f16\u7801 IP/URL \u79fb\u81f3 .env.* \u73af\u5883\u53d8\u91cf', ref: 'standards/07-config.md', auto: true },
+  R13: { fix: '\u62c6\u5206\u9ad8\u590d\u6742\u5ea6\u51fd\u6570\uff1a\u6309\u804c\u8d23\u62bd\u53d6\u5b50\u51fd\u6570\u3001\u7528\u63d0\u524d return \u4ee3\u66ff\u5d4c\u5957 if\u3001\u67e5\u8868\u9a71\u52a8\u53d6\u4ee3 if-else \u94fe\u3001\u7b56\u7565\u6a21\u5f0f\u6d88\u9664\u591a\u5206\u652f', ref: 'standards/04-coding-basics.md', auto: false },
+  R14: { fix: '\u6309 TS \u9519\u8bef\u4fee\u590d\u7c7b\u578b\uff08\u8865\u7c7b\u578b\u6807\u6ce8 / \u4fee\u6b63\u8c03\u7528\u53c2\u6570 / \u8865 any \u8fb9\u754c\u6ce8\u91ca\uff09\uff1b\u672a\u88c5 vue-tsc \u65f6\u5b89\u88c5\u540e\u7eb3\u5165 CI', ref: 'standards/09-typescript.md', auto: false },
   // S 系列：page-spec 约定 vs 代码确定性核对（v2.11.1+）
   S0: { fix: '\u4fee\u6b63 page-spec.json \u7ed3\u6784\uff08page/query/columns/toolbar/operations\uff09', ref: '.wl-skills/skills/core/page-codegen/SKILL.md', auto: false },
   S1: { fix: '\u8c03\u6574 queryDef() \u67e5\u8be2\u5b57\u6bb5\u987a\u5e8f\u4e0e page-spec.json query \u4e25\u683c\u4e00\u81f4', ref: '.wl-skills/skills/core/page-codegen/SKILL.md', auto: true },