@agile-team/wl-skills-kit 2.1.6 → 2.1.8

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@agile-team/wl-skills-kit?label=wl-skills-kit&color=brightgreen)](https://www.npmjs.com/package/@agile-team/wl-skills-kit)
 
-**AI Skill 模板包 v2.1.6** — 一条命令将 13 条编码规范、6 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
+**AI Skill 模板包 v2.1.8** — 一条命令将 13 条编码规范、6 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
@@ -99,7 +99,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   │   ├── 02-code-structure.md
 │   │   ├── ... (共 13 条)
 │   │   └── 13-platform-components.md
-│   ├── skills/                           6 个启用 Skill + 3 个 PLANNED 草稿
+│   ├── skills/                           8 个启用 Skill + 1 个 PLANNED 草稿
 │   │   ├── _registry.md                  ★ 触发词 → SKILL 路径单一数据源
 │   │   ├── _compat/                      多 AI 编辑器适配（配置 + headers）
 │   │   ├── core/                         核心通用 Skill
@@ -110,10 +110,10 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   │   │   └── template-extract/ { SKILL.md, USAGE.md }
 │   │   ├── sync/                         数据同步类
 │   │   │   ├── menu-sync/        { SKILL.md, USAGE.md, env/ }
-│   │   │   ├── dict-sync/        [PLANNED] SKILL.draft.md
+│   │   │   ├── dict-sync/        { SKILL.md, env/ }
 │   │   │   └── permission-sync/  [PLANNED] SKILL.draft.md
 │   │   ├── ops/                          运维类
-│   │   │   └── code-fix/         [PLANNED] SKILL.draft.md
+│   │   │   └── code-fix/         { SKILL.md }
 │   │   └── domain/                       领域专属（按需创建）
 │   ├── guides/                           人读指南（usage.md / architecture.md）
 │   └── reports/                          AI 生成报告（追加不覆盖）
@@ -197,9 +197,9 @@ npx @agile-team/wl-skills-kit update
 | `convention-audit` | ✅ 启用    | `skills/core/convention-audit/`          | 13 条规范扫描 + 双报告        |
 | `template-extract` | ✅ 启用    | `skills/core/template-extract/`          | 现有页面 → 领域模板           |
 | `menu-sync`        | ✅ 启用    | `skills/sync/menu-sync/`                 | 菜单基线 ↔ 后端接口          |
-| `dict-sync`        | 🔧 待激活 | `skills/sync/dict-sync/`                 | 字典基线 ↔ 后端接口（API 端点已验证，配置后即用）|
+| `dict-sync`        | ✅ 启用    | `skills/sync/dict-sync/`                 | 字典基线 ↔ 后端接口                           |
 | `permission-sync`  | ⏳ PLANNED | `skills/sync/permission-sync/`           | 权限基线 ↔ 后端接口          |
-| `code-fix`         | ⏳ PLANNED | `skills/ops/code-fix/`                   | 受控自动修复偏差              |
+| `code-fix`         | ✅ 启用    | `skills/ops/code-fix/`                   | 受控自动修复偏差                  |
 
 每个启用 Skill 同目录都有 **`SKILL.md`（AI 触发用）+ `USAGE.md`（团队成员阅读）**。
 
@@ -211,11 +211,14 @@ npx @agile-team/wl-skills-kit update
 
 ```typescript
 // ✅ 正确：Date.now().toString(36) — 毫秒级唯一，永不重复，约 9 位 base-36
-cid="mca-lhfge5hc"                    // 表格级：{页面首字母缩写}-{base36时间戳}
-cid: 'mca-customerName'               // 列级：{表格缩写}-{fieldName}
+cid="mca-lhfge5hc"                           // 表格级：{页面首字母缩写}-{base36时间戳}
+cid: 'mca-lhfge5hc-customerName'             // 列级：{完整表格cid}-{fieldName}
+cid: 'mca-lhfge5hc-sub1-customerName'        // 子表列级：{完整子表cid}-{fieldName}
 
-// ❌ 错误：截断十进制后6位（每11.5天循环一次，且不同页面缩写易碰撞）
+// ❌ 错误：截断十进制后6位（每11.5天循环一次）
 cid="mca-745831"
+// ❌ 错误：列级只用缩写（同页面两张表都有steelCode → mca-steelCode 碰撞）
+cid: 'mca-customerName'
 ```
 
 **Pre-flight 中 AI 自动输出**：`✅ cid 已生成：mca-lhfge5hc（mmwr-customer-archive）`  
@@ -274,7 +277,7 @@ cid="mca-745831"
 ```
 "扫描 src/views/ 下所有页面，做规范审计，输出偏差报告"  → convention-audit
   → 人工确认整改优先级（报告中标 🔴 / 🟡 / 🟢）
-  → "对 {偏差文件} 做规范整改"                          → [PLANNED] code-fix
+  → "对 {偏差文件} 做规范整改"                          → code-fix
 ```
 
 ### 触发异常处理

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.1.6
+ * wl-skills-kit CLI v2.1.8
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）

package/files/.github/copilot-instructions.md

@@ -235,9 +235,9 @@ onMounted(() => select());
 | menu-sync            | ✅ 启用  | reports/SYS_MENU_INFO → 后端菜单接口    |
 | convention-audit     | ✅ 启用  | 13 条规范扫描 + 偏差报告 + 提取建议     |
 | template-extract     | ✅ 启用  | 现有页面 → 领域模板沉淀                 |
-| dict-sync            | ⏳ PLANNED | 字典数据同步                            |
+| dict-sync            | ✅ 启用   | 字典数据同步                            |
 | permission-sync      | ⏳ PLANNED | 权限数据同步                            |
-| code-fix             | ⏳ PLANNED | 自动整改 🟢🟡 等级偏差                  |
+| code-fix             | ✅ 启用   | 自动整改 🟢🟡 等级偏差                  |
 
 **执行规则**：
 
@@ -278,7 +278,7 @@ AI 生成的所有报告类文件统一写入 `.github/reports/`，**全部追
 | 文件                              | 写入方             | 读取方                |
 | --------------------------------- | ------------------ | --------------------- |
 | `reports/SYS_MENU_INFO.md`        | page-codegen       | menu-sync             |
-| `reports/SYS_DICT_INFO.md` [PLANNED]   | dict-collect  | dict-sync             |
+| `reports/SYS_DICT_INFO.md`        | dict-collect  | dict-sync             |
 | `reports/SYS_PERMISSION_INFO.md` [PLANNED] | permission-collect | permission-sync |
 | `reports/规范审查报告.md`          | convention-audit   | 人工 → code-fix       |
 | `reports/组件提取建议.md`          | convention-audit   | 人工 → template-extract |

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

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

package/files/.github/skills/_registry.md

@@ -20,11 +20,11 @@ skills/
 │
 ├── sync/                数据同步类（与后端联动）
 │   ├── menu-sync/
-│   ├── dict-sync/        [PLANNED]
+│   ├── dict-sync/
 │   └── permission-sync/  [PLANNED]
 │
 ├── ops/                 运维/构建类
-│   └── code-fix/         [PLANNED]
+│   └── code-fix/
 │
 └── domain/              领域专属 Skill（按域扩展，初始为空）
 ```
@@ -46,9 +46,9 @@ skills/
 | convention-audit | ✅ 启用    | `skills/core/convention-audit/SKILL.md`      | 规范审计 / 代码审计 / 规范检查 / 对齐规范 / 规范偏差 / 接手新项目 / 存量代码分析 / 项目体检 |
 | template-extract | ✅ 启用    | `skills/core/template-extract/SKILL.md`      | 提取模板 / 抽取模板 / 沉淀模板 / 模板贡献                                  |
 | menu-sync        | ✅ 启用    | `skills/sync/menu-sync/SKILL.md`             | 创建菜单 / 注册菜单 / 同步菜单 / 补菜单                                    |
-| dict-sync        | 🔧 待激活 | `skills/sync/dict-sync/SKILL.md`             | 同步字典 / 创建字典 / 刷新字典基线 / 字典对比 / 字典审计（**API 端点确认后自动生效**）|
+| dict-sync        | ✅ 启用    | `skills/sync/dict-sync/SKILL.md`             | 同步字典 / 创建字典 / 刷新字典基线 / 字典对比 / 字典审计                           |
 | permission-sync  | ⏳ PLANNED | `skills/sync/permission-sync/SKILL.draft.md` | （草稿，不参与调度）                                                       |
-| code-fix         | ⏳ PLANNED | `skills/ops/code-fix/SKILL.draft.md`         | （草稿，不参与调度）                                                       |
+| code-fix         | ✅ 启用    | `skills/ops/code-fix/SKILL.md`               | 自动修复 / 整改偏差 / 修复报告 / 规范整改 / 修复偏差 / code fix               |
 
 ---
 

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

@@ -57,7 +57,7 @@ description: "Use when: auditing project source code against the 13 modular stan
 | 09   | TypeScript                   | 滥用 any（>3 处/页） → 🟡                                            |
 | 10   | Pinia                        | data.ts 内 import Store → 🔴                                         |
 | 11   | 表单校验                     | FORM_ROUTE 缺 validate / resetFields → 🔴                            |
-| 12   | BaseTable + cid              | 用 el-table / 缺 render-type / cid 缺失或重复 → 🔴；cid 后缀使用旧格式（十进制截断后6位）→ 🟡 提示改为 base-36 完整值 |
+| 12   | BaseTable + cid              | 用 el-table / 缺 render-type / cid 缺失或重复 → 🔴；cid 后缀使用旧格式（十进制截断后6位）→ 🟡；列级 cid 只用缩写作前缀（同页面两张表同名列碰撞）→ 🔴 |
 | 13   | 平台组件合规                 | 用 el-form/el-table/el-date-picker 替代封装 → 🔴；3+ 复用 → 提取建议 |
 
 ---

package/files/.github/skills/ops/code-fix/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: code-fix
+description: "Use when: fixing code convention issues found in convention-audit reports. Triggers on: 自动修复, 整改偏差, 修复报告, 规范整改, 修复偏差, code fix, 整改规范."
+---
+
+# Skill: 受控自动修复（code-fix）
+
+读取 `reports/规范审查报告.md` 中的偏差条目，在用户确认 diff 后执行单条或分组修复。
+
+> **前置**：必须先运行 `convention-audit` 生成审计报告，code-fix 依赖其输出。  
+> **范围**：仅修复 🟡 / 🟢 等级偏差；🔴 严重偏差必须人工或 page-codegen 重新生成。
+
+---
+
+## 工作流
+
+```
+reports/规范审查报告.md（convention-audit 输出）
+        │
+        ▼
+[1] 用户从报告挑选 issueId（或 issueGroup），或说"列出可修复项"
+        │
+        ▼
+[2] 解析 issue → 定位文件 + 行号 + 偏差类型
+        │
+        ▼
+[3] 选择修复策略：
+    ├─ rule-based（如缺 :scoped、缺 cid 等）→ 直接按规则生成 patch
+    └─ ai-based（语义性偏差）→ AI 生成 patch
+        │
+        ▼
+[4] Pre-flight 输出 diff 预览（人读，必须等待确认）
+        │
+        ▼
+[5] 用户 yes → 写入文件 + 在报告中标记该条目为 ✅ 已修复
+    用户 no  → 跳过该 issue，回到挑选界面
+```
+
+---
+
+## 受控原则（严格执行，不可绕过）
+
+| 原则 | 说明 |
+| --- | --- |
+| **不修 🔴** | 严重偏差必须人工或 page-codegen 处理，code-fix 不介入 |
+| **不破坏功能** | 只改报告点名的行，不顺手"重构"周边代码 |
+| **不批量盲改** | 每个文件都先 diff 预览，禁止跳过用户确认 |
+| **不生成新逻辑** | 只修偏差，不做功能补全（那是 page-codegen 的职责） |
+| **范围明确** | 若用户引导修改业务逻辑，必须拒绝并说明原因 |
+
+---
+
+## 偏差类型 → 修复策略
+
+| 偏差类型 | 来源 standards | 策略 |
+| --- | --- | --- |
+| EColumn 缺 cid | standards/12-base-table.md | rule-based |
+| 列级 cid 只用缩写前缀（如 `mca-steelCode`） | standards/12-base-table.md | rule-based |
+| scss 文件缺 `:scoped` 包裹 | standards/02-code-structure.md | rule-based |
+| import 路径不规范 | standards/04-coding-basics.md | rule-based |
+| `any` 滥用（> 3 处/页） | standards/09-typescript.md | ai-based |
+| API_CONFIG URL 命名偏差 | api-contract.md | ai-based |
+| 表格列定义与 api.md 字段不一致 | api-contract + data-ts | ai-based |
+| 业务语义偏差（流程不对）| 多 standards 综合 | **不修复，标记人工** |
+
+---
+
+## 触发命令形态
+
+```
+"修复 reports/规范审查报告.md 中的 issue#3"              → 单条修复
+"修复 reports/规范审查报告.md 中所有 scss 偏差"          → 分组修复
+"修复全部 rule-based 偏差，跳过 ai-based"                → 受控批量
+"列出可修复的 issue"                                     → 仅列清单，不动任何文件
+```
+
+---
+
+## Pre-flight 声明示例
+
+```
+🚀 已触发技能 ops/code-fix/SKILL.md → 受控自动修复偏差
+✅ 已读取 reports/规范审查报告.md    → 找到 12 条偏差（rule-based 8 条，ai-based 4 条）
+✅ 当前目标：issue#3（EColumn 缺 cid）→ 文件 src/views/sale/order/data.ts L42
+⚠️  以下操作会修改文件，请在 diff 预览后确认
+```
+
+---
+
+## 与其他 Skill 的关系
+
+| Skill | 关系 |
+| --- | --- |
+| convention-audit | **前置**：必须先有审计报告，code-fix 才有输入 |
+| page-codegen | 互斥：生成新页面用 codegen，不用 fix |
+| template-extract | 无直接关系 |

package/files/.github/skills/sync/menu-sync/env/guide.md

@@ -1,18 +1,33 @@
 # env.local.json 配置说明
 
-> 该目录下的 `env.local.json` 已加入 `.gitignore`，**不会提交到远端仓库**。
-> 每位成员在本地维护自己的副本，首次使用时按本文档填写即可。
+> 每位成员在本地维护自己的副本，已加入 `.gitignore`，**不会提交到远端仓库**。
 
 ---
 
-## 文件结构
+## 配置文件位置（优先使用新统一路径）
+
+**新路径（v2.1.5+ 推荐）**：`.github/skills/sync/env.local.json`  
+**兼容路径（老版）**：`.github/skills/sync/menu-sync/env/env.local.json`
+
+AI 优先读新路径，如不存在自动回落到兼容路径。
+
+---
+
+## 配置格式（菜单/字典/权限三合一）
 
 ```json
 {
   "gatewayPath": "http://192.168.10.50:9000",
-  "parentMenuId": "1803456789012345678",
   "sysAppNo": "QjQuXy1kbKxZyjhS5N2",
-  "token": "eyJhbGci..."
+  "token": "eyJhbGci...",
+
+  "menu": {
+    "parentMenuId": "1803456789012345678"
+  },
+
+  "dict": {
+    "moduleId": "7C909G0U2F8HI7E305LV0135LSJ3UBIO"
+  }
 }
 ```
 
@@ -23,9 +38,10 @@
 | 字段 | 说明 | 示例 |
 |---|---|---|
 | `gatewayPath` | 后端网关地址，含协议和端口，**末尾不加斜杠** | `http://192.168.10.50:9000` |
-| `parentMenuId` | 目标父级目录的菜单数据库 ID（每套环境不同） | `1803456789012345678` |
 | `sysAppNo` | 应用编码（非明文，从已有菜单接口响应中获取） | `QjQuXy1kbKxZyjhS5N2` |
 | `token` | 当前登录用户的 Bearer Token，**不含 `bearer ` 前缀** | `eyJhbGci...` |
+| `menu.parentMenuId` | 目标父级目录的菜单数据库 ID（每套环境不同） | `1803456789012345678` |
+| `dict.moduleId` | 字典所属模块 ID（字典管理后台获取） | `7C909G0U2F8HI7E305LV0135LSJ3UBIO` |
 
 ---
 
@@ -35,7 +51,7 @@
 
 询问后端同事，或查看浏览器 Network 面板中任意接口请求的 URL，取协议 + 域名/IP + 端口部分。
 
-### parentMenuId
+### menu.parentMenuId
 
 **方法 A（推荐）**：系统管理后台 → 菜单管理 → 找到目标父级目录 → 点编辑/查看 → 复制菜单 ID
 

package/files/.github/standards/12-base-table.md

@@ -12,7 +12,7 @@
 <BaseTable
   ref="tableRef"
   render-type="agGrid"
-  cid="mca-745831"
+  cid="mca-lhfge5hc"
   :data="list"
   :columns="columns"
   showToolbar
@@ -58,27 +58,42 @@ AGGrid 通过 `cid` 持久化列配置（列宽、顺序、显示），**cid 必
 ### 列级 cid
 
 ```
-格式：{表格cid的缩写部分}-{fieldName}
+格式：{完整表格 cid}-{fieldName}
 ```
 
+> ✅ 用完整表格 cid（而非仅缩写部分）作前缀，是防碌撞的关键。
+> 同一页面两张表都有 `steelCode` 列时：
+> - 主表（cid=`mca-lhfge5hc`）：`mca-lhfge5hc-steelCode` ✅
+> - 子表（cid=`mca-lhfge5hc-sub1`）：`mca-lhfge5hc-sub1-steelCode` ✅
+> - 如果用缩写作前缀：两张表同名列都会得到 `mca-steelCode` → 碰撞 ❌
+
 ```typescript
-// 表格缩写为 mca
+// 主表 cid="mca-lhfge5hc"
 columnsDef(): TableColumnDesc<any>[] {
   return [
     { type: 'selection' },
     { type: 'index' },
-    { label: '取样',     name: 'sampling',           cid: 'mca-sampling',           width: 70 },
-    { label: '线上公告', name: 'onlineAnnouncement', cid: 'mca-onlineAnnouncement', width: 70 },
+    { label: '取样',     name: 'sampling',           cid: 'mca-lhfge5hc-sampling',           width: 70 },
+    { label: '线上公告', name: 'onlineAnnouncement', cid: 'mca-lhfge5hc-onlineAnnouncement', width: 70 },
+  ]
+}
+
+// 子表 cid="mca-lhfge5hc-sub1"
+subColumnsDef(): TableColumnDesc<any>[] {
+  return [
+    { type: 'index' },
+    { label: '钢种编码', name: 'steelCode', cid: 'mca-lhfge5hc-sub1-steelCode', width: 100 },
+    { label: '规格',     name: 'spec',      cid: 'mca-lhfge5hc-sub1-spec',      width: 80 },
   ]
 }
-```
 
 ---
 
 ## 禁止事项
 
 - ❌ 随机短字符串 `cid="ipiCfsb"`（AI 重新生成时极易碰撞）
-- ❌ 纯字段名 `cid: "sampling"`（不同页面同名字段冲突）
+- ❌ 纴字段名 `cid: "sampling"`（不同页面/不同表格同名字段必碰撞）
+- ❌ 列级 cid 只用缩写 `cid: 'mca-steelCode'`（同页面两张表都有 steelCode 时碰撞）
 - ❌ 省略 cid（列配置持久化完全失效）
 - ❌ 跨页面复用同一 cid
 
@@ -88,7 +103,7 @@ columnsDef(): TableColumnDesc<any>[] {
 
 ```
 ✅ cid 已生成：mca-lhfge5hc（mmwr-customer-archive）
-✅ 列级 cid 前缀：mca-
+✅ 列级 cid 前缀：mca-lhfge5hc-（完整表格 cid 加连接符）
 ```
 
 ---
@@ -115,8 +130,8 @@ columnsDef(): TableColumnDesc<any>[] {
   return [
     { type: 'selection' },
     { type: 'index' },
-    { label: '客户名称', name: 'customerName', cid: 'mca-customerName', minWidth: 120 },
-    { label: '状态',     name: 'status',       cid: 'mca-status',       minWidth: 80 },
+    { label: '客户名称', name: 'customerName', cid: 'mca-lhfge5hc-customerName', minWidth: 120 },
+    { label: '状态',     name: 'status',       cid: 'mca-lhfge5hc-status',       minWidth: 80 },
   ]
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.1.6",
+  "version": "2.1.8",
   "description": "AI Skill 模板包 — 一键导入 AI 指令 + 组件文档 + 通用组件 + 领域样例，覆盖 Copilot/Cursor/Windsurf/Kiro 等主流 AI 编辑器",
   "main": "./bin/wl-skills.js",
   "bin": {