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

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.7** — 一条命令将 13 条编码规范、6 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
@@ -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）`  

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.7
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）

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

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

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/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.7",
   "description": "AI Skill 模板包 — 一键导入 AI 指令 + 组件文档 + 通用组件 + 领域样例，覆盖 Copilot/Cursor/Windsurf/Kiro 等主流 AI 编辑器",
   "main": "./bin/wl-skills.js",
   "bin": {