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

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.1（2026-06-15）
+> **当前版本**：v2.11.3（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

@@ -112,7 +112,7 @@ description: "Use when: auditing project source code against the 14 modular stan
 | 06 | 安全规范 | 静态扫描 | `v-html` 无注释 / `import axios` / `eval` / `new Function` → 🔴 |
 | 07 | 配置管理 | 静态扫描 | 硬编码 `http://` IP → 🔴；API 路径散落 → 🟡 |
 | 08 | Git 规范 | Git 命令 + 文件检测 | 工具链缺失 → 🔴；分支名不规范 → 🟡；近期提交不规范 → 🟡；历史 → 🟢 |
-| 09 | TypeScript | tsc / ESLint 委托 | AI 不逐文件做类型推导，读取工具链输出归类；`any` 滥用 → 🟡 |
+| 09 | TypeScript 类型 + 类型错误 | R14（vue-tsc/tsc 委托）+ AI | 类型检查器缺失 → 🔴；`vue-tsc --noEmit` 非 0 → 🔴；`any` 滥用 → 🟡 |
 | 10 | Pinia | 静态扫描 | `data.ts` 内 import Store → 🔴 |
 | 11 | 表单校验 | AI 场景判断 | FORM_ROUTE 缺 validate / resetFields → 🔴 |
 | 12 | BaseTable + cid | 静态 + 场景判断 | 主列表用 el-table → 🔴；cid 缺失/重复 → 🔴；弹窗小表格见豁免规则 |
@@ -158,14 +158,14 @@ description: "Use when: auditing project source code against the 14 modular stan
 1. 读取 `standards/01 ~ 14` 全部规范文件
 2. 检测工具链状态：
    - ESLint：是否可执行
-   - TypeScript：`tsc --noEmit` 是否可执行
+   - TypeScript：`vue-tsc --noEmit`（回退 `tsc --noEmit`）是否可执行、是否 0 error（R14）
    - Git：当前分支 / 最近提交
    - Husky：`.husky/pre-commit`、`.husky/commit-msg` 是否存在
 3. 读取 `package.json` 获取项目脚本名称
 
 ### 步骤 3：扫描源码
 
-逐个文件检查 13 个维度。同时记录：
+逐个文件检查 14 个维度。同时记录：
 
 - **扫描统计**：目录数、文件数、页面数、类型分布
 - **跨页面相同 el-\* 模式**（统计出现次数和位置）