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

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

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

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-\* 模式**（统计出现次数和位置）

package/files/.wl-skills/skills/core/page-codegen/SKILL.md

@@ -43,10 +43,12 @@ description: "Use when: generating complete Vue 3 page code (index.vue + data.ts
 ✅ src/views/.../{页面}/data.ts
 ✅ src/views/.../{页面}/index.scss
 ✅ src/views/.../{页面}/api.md
+✅ src/views/.../{页面}/page-spec.json  → 约定真值（供 S1~S5 比对）
 ✅ reports/SYS_MENU_INFO.md  → 已追加菜单条目
 ────────────────────────────────────────────────
 🔍 强制自检（不可跳过）：
    wl-skills validate src/views/{生成的页面目录}
+   → 同时执行 R1~R12（AST 语义）+ S1~S5（page-spec 比对）
    → 结果：{0 error / N warn} 或列出 error 待修复
 ────────────────────────────────────────────────
 📌 后续步骤：
@@ -98,12 +100,15 @@ description: "Use when: generating complete Vue 3 page code (index.vue + data.ts
 
 ```
 src/views/[域]/[模块]/[子模块]/[kebab-case-目录名]/
-├── index.vue     ← 页面入口（纯模板 + 解构）
-├── data.ts       ← 业务逻辑（AbstractPageQueryHook 类 / 直接导出 ref+函数）
-├── index.scss    ← 页面样式
-└── api.md        ← 接口约定（按 api-contract Skill 模板生成）
+├── index.vue       ← 页面入口（纯模板 + 解构）
+├── data.ts         ← 业务逻辑（AbstractPageQueryHook 类 / 直接导出 ref+函数）
+├── index.scss      ← 页面样式
+├── api.md          ← 接口约定（按 api-contract Skill 模板生成）
+└── page-spec.json  ← ★ 原型约定真值（查询/列/按钮/操作列 顺序+颜色），供 validate S1~S5 确定性比对
 ```
 
+> **page-spec.json 是"精准实现"的真值锚点**：把 page-spec（查询字段顺序、列顺序、按钮顺序与颜色、操作列）固化到页面目录，`wl-skills validate` 据此比对 data.ts 实际实现，偏差即报（详见 `.wl-skills/docs/page-spec-schema.md`）。**不可省略**——没有它，"按约定实现"无法被验证，只能靠 AI 自觉。
+
 弹窗组件处理策略：
 
 - **通用弹窗**（新增/编辑表单，2+ 页面可复用）→ 提取到 `.wl-skills/src/components/local/c_xxxModal/`
@@ -150,6 +155,7 @@ src/views/[域]/[模块]/[子模块]/[kebab-case-目录名]/
 27. **BaseTable 强制 AGGrid**：所有业务主列表/台账/主从表/树表/详情子表的 `BaseTable` 必须显式写 `render-type="agGrid"`，并绑定全局唯一 `cid`。弹窗小表格可豁免，但必须在生成摘要中说明理由。
 28. **cid 必须可追踪**：每个页面导出 `TABLE_CID = "{pageAbbr}-{base36Timestamp}"`；多表页面使用 `BOTTOM_TABLE_CID` / `ITEM_TABLE_CID`，列级 `cid` 必须使用 `${TABLE_CID}-fieldName` 前缀。
 29. **skills-ui 只能融合，不可生搬硬套**：不得照搬 `wk-skills-ui/templates/list-page` 中的原生 `el-form/usePageHook/el-pagination` 通用写法；本项目必须保留 `AbstractPageQueryHook + BaseQuery + BaseToolbar + BaseTable + jh-pagination` 平台骨架，只融合 `defineColumns/renderOps/tokens/preset`。
+30. **必须落盘 page-spec.json**：生成页面时，把 page-spec（`page` 中文名 + `query` + `columns` + `toolbar` + `operations`）按 `.wl-skills/docs/page-spec-schema.md` 写入页面目录的 `page-spec.json`。字段 `name`/`label`/顺序必须与 data.ts 生成内容、与原型严格一致——这是 `validate` 做 S1~S5 比对的真值。生成后自检若出现 S2/S3/S4 error，说明 data.ts 与 spec 不一致，必须修正到 0 error。
 
 ### 禁止事项（严格遵守）