@agile-team/wl-skills-kit 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [1.1.4] - 2026-04-09
+
+### 修复
+
+- 补充遗漏的 `env.local.json` 模板文件到 `files/.github/skills/menu-sync/env/`
+- 文件内容为占位符模板（非真实凭据），安装后用户按 `guide.md` 填写实际值
+
+## [1.1.3] - 2026-04-09
+
+### 重构：convention-extract → convention-audit（规范审计）
+
+- **定位翻转**：从"扫描代码提炼规范"改为"用规范审计代码"
+  - 旧：项目代码 → 提炼 → 规范文档（代码乱则规范乱）
+  - 新：copilot-instructions.md（标准） → 审计 → 偏差报告 + 整改建议
+- SKILL.md 完全重写：10 项审计维度、偏差严重度定义、报告模板、执行步骤
+- copilot-instructions.md 注册表触发关键词更新：提炼规范 → 规范审计/代码审计/规范检查
+- use-skill.md、wl-skills-kit.md 相关描述同步更新
+
 ## [1.1.2] - 2026-04-09
 
 ### 新增：Skills 自动调度注册表

package/README.md

@@ -46,7 +46,7 @@ npx @agile-team/wl-skills-kit@latest
 │   │   │   ├── TPL-OPERATION-STATION.md←     工序操作站模板
 │   │   │   └── TPL-DRIVEN.md           ←     配置驱动模板识别参考
 │   │   ├── menu-sync/SKILL.md           ←   ④ 菜单同步（pages.ts → 后端菜单表）
-│   │   └── convention-extract/SKILL.md  ←   ⑤ 规范提炼（扫描源码 → 编码规范文档）
+│   │   └── convention-extract/SKILL.md  ←   ⑤ 规范审计（用规范审计代码，输出偏差报告）
 │   └── docs/                            ← 设计文档
 │       ├── use-skill.md                 ←   Skill 使用 + 移植一站式指南
 │       ├── menu-sync-design.md          ←   菜单同步方案设计
@@ -129,7 +129,7 @@ npx @agile-team/wl-skills-kit@latest
          ▼
   ④ menu-sync ──────── 同步 → 后端菜单表（AI 自动调 API 创建菜单）
                        
-  ⑤ convention-extract  一次性：扫描项目源码 → 生成编码规范文档
+  ⑤ convention-audit    按需：用规范审计代码 → 偏差报告 + 整改建议
 ```
 
 ### 支持 9 种页面模板
@@ -185,7 +185,7 @@ AI 自动执行 5 步：扫描 → 生成接口约定 → 生成页面代码 →
 | 给页面生成接口文档 | "生成 api.md" | api-contract |
 | 只生成单个页面代码 | "帮我生成客户档案页面" | page-codegen |
 | 把 pages.ts 同步到菜单表 | "帮我创建菜单" | menu-sync |
-| 扫描项目提炼编码规范 | "提炼项目规范" | convention-extract |
+| 审计项目代码是否合规 | "审计项目规范" / "规范检查" | convention-audit |
 | 查看组件怎么用 | "jh-select 怎么用" | AI 读取 docs/jh-select.md |
 | 参考样例写代码 | "参考 demo 里的客户档案" | AI 读取 demo/ 下的代码 |
 

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

@@ -211,7 +211,7 @@ onMounted(() => select());
 | 接口约定、api.md、字段定义、前后端对齐、接口设计 | `.github/skills/api-contract/SKILL.md` | api-contract |
 | 生成页面、创建页面、代码生成、vue页面、按原型生成 | `.github/skills/page-codegen/SKILL.md`（主文件会指示继续读取对应的 `TPL-*.md` 模板） | page-codegen |
 | 创建菜单、注册菜单、同步菜单、补菜单 | `.github/skills/menu-sync/SKILL.md` | menu-sync |
-| 提炼规范、项目规范、编码规范扫描 | `.github/skills/convention-extract/SKILL.md` | convention-extract |
+| 规范审计、代码审计、规范检查、对齐规范、规范偏差 | `.github/skills/convention-extract/SKILL.md` | convention-audit |
 
 ### 完整流水线（原型/详设 → 页面 → 菜单）
 

package/files/.github/docs/use-skill.md

@@ -25,9 +25,9 @@
 | api-contract       | page-spec JSON          | api.md                                            | ✅ 推荐  | 微调 URL 命名规范       |
 | page-codegen       | page-spec JSON + api.md | index.vue + data.ts + index.scss + menu-config.md | ✅ 必须  | **必须改**，代码模板绑项目（含 9 个 TPL-*.md 模板文件，按模式名命名） |
 | menu-sync          | SYS_MENU_INFO.md + env.local.json | 后端菜单表记录（AI 调 `/system/menu/save`） | ✅ 推荐  | 不用改，配置 env.local.json 即可（Phase 2 script 待接口就绪） |
-| convention-extract | 项目源码                | copilot-instructions.md                           | ❌ 一次性 | 不用改，每个项目执行一次 |
+| convention-audit   | 项目源码 + copilot-instructions.md | 偏差报告 + 整改建议                              | ❌ 按需   | 不用改，规范基线来自 copilot-instructions.md |
 
-**核心结论：prototype-scan 直接复制，page-codegen 必须适配新项目的代码模板，convention-extract 在新项目执行一次自动产出。**
+**核心结论：prototype-scan 直接复制，page-codegen 必须适配新项目的代码模板，convention-audit 用于审计项目代码是否符合规范。**
 
 ---
 
@@ -178,18 +178,19 @@ page-spec 有误 → 改一行 JSON → 重新生成代码（秒级）
 │       ├── prototype-scan/SKILL.md   ← 直接复制，不改
 │       ├── api-contract/SKILL.md     ← 直接复制，微调命名规范
 │       ├── page-codegen/SKILL.md     ← 需要重写代码模板
-│       └── convention-extract/SKILL.md  ← 直接复制，不改
+│       └── convention-extract/SKILL.md  ← 直接复制，用于审计代码合规性
 ```
 
-### 第 2 步：生成编码规范
+### 第 2 步：建立编码规范
 
-**情况 A：新项目已有页面代码** → 执行 convention-extract 自动扫描
-
-**情况 B：新项目空白** → 复制 `.github/copilot-instructions.md` 作为基础模板，修改：
+复制 `.github/copilot-instructions.md` 作为基础模板，按新项目实际情况修改：
 - 路由注册方式（`gSale`/`gProd` → 新项目的函数名）
 - 组件库（如果仍是 Element Plus + @jhlc/jh-ui 则不改）
 - 页面目录层级、服务缩写前缀
 
+> **copilot-instructions.md 是唯一编码规范源头**，团队统一维护此文件。
+> 项目引入后，执行 convention-audit Skill 审计已有代码，输出偏差报告和整改清单。
+
 **前置条件清单**：
 
 ```
@@ -369,11 +370,11 @@ export default defineConfig(({ command }) => ({
     │   ├── TPL-OPERATION-STATION.md ← OPERATION_STATION：工序操作站
     │   └── TPL-DRIVEN.md            ← TEMPLATE_DRIVEN：配置驱动识别参考
     ├── menu-sync/SKILL.md           ← pages.ts → 后端菜单表
-    └── convention-extract/SKILL.md  ← 项目源码 → 编码规范
+    └── convention-extract/SKILL.md  ← 规范审计（审计代码是否符合规范）
 docs/
 ├── page-query-hook-best-practices.md
 ├── request.md
 └── jh-*.md                          ← 平台组件使用文档
 ```
 
-> **一句话总结**：prototype-scan 通用可直接复制，page-codegen 需按目标项目改写代码模板，convention-extract 在每个新项目执行一次即可。三步完成 Skill 体系移植。
+> **一句话总结**：prototype-scan 通用可直接复制，page-codegen 需按目标项目改写代码模板，convention-audit 用于审计项目代码合规性。copilot-instructions.md 是唯一规范源头。

package/files/.github/docs/wl-skills-kit.md

@@ -44,7 +44,7 @@
     │   │   ├── menu-sync/
     │   │   │   ├── SKILL.md             ←   菜单同步
     │   │   │   └── env/guide.md         ←   env.local.json 配置说明（json 本身不分发）
-    │   │   └── convention-extract/SKILL.md ← 规范提炼
+    │   │   └── convention-extract/SKILL.md ← 规范审计
     │   └── docs/
     │       ├── use-skill.md             ←   使用 + 移植一站式指南
     │       ├── menu-sync-design.md      ←   菜单同步方案设计
@@ -215,7 +215,7 @@ v1.1 实现：CLI 安装时自动从 `.github/copilot-instructions.md` **动态
 详见 [use-skill.md](use-skill.md)「第四章：移植到新项目」。核心步骤：
 
 1. `npx @agile-team/wl-skills-kit` → 导入全部文件
-2. 执行 convention-extract Skill → 生成适配新项目的 copilot-instructions.md
+2. 执行 convention-audit Skill → 审计项目已有代码，输出偏差报告和整改建议
 3. 改写 page-codegen 代码模板（替换基类、组件、API 调用方式）
 4. 验证：拿一个页面走完整 Skill 流程
 

package/files/.github/skills/convention-extract/SKILL.md

@@ -1,355 +1,236 @@
 ---
-name: convention-extract
-description: "Use when: scanning a Vue project to extract and document coding conventions, file structure rules, naming patterns, component usage patterns, and API writing standards into a reusable conventions document. Triggers on: extract conventions, project standards, coding rules, 提炼规范, 编码规范, 项目扫描规范."
+name: convention-audit
+description: "Use when: auditing project source code against the established coding conventions in copilot-instructions.md. Scans files and outputs a deviation report with remediation suggestions. Triggers on: audit code, check conventions, 规范审计, 规范检查, 代码审计, 对齐规范, 规范偏差."
 ---
 
-# Skill: 规范提炼（convention-extract）
+# Skill: 规范审计（convention-audit）
 
-扫描 Vue 项目源码，将隐含的编码规范显式化、固化，供 AI 在代码生成时精确还原项目风格。
+以 `copilot-instructions.md` 为唯一规范源头，扫描项目源码，找出不符合规范的文件和写法，输出偏差报告及整改建议。
 
-**cx-ui-produce 项目的规范已提炼完成并固化在 `.github/copilot-instructions.md` 中。**
-以下是完整规范详情，新项目接入时参考「扫描步骤」重新执行。
+> **核心理念**：规范是"标准"，代码要对齐标准。不从代码提炼规范，而是用规范审计代码。
 
 ---
 
-## 已固化规范：cx-ui-produce
+## 适用场景
 
-### 1. 技术栈
+| 场景 | 说明 |
+|------|------|
+| 新项目导入 wl-skills-kit 后 | 扫描旧代码，输出整改清单，逐步迁移到标准模式 |
+| 日常 Code Review 辅助 | AI 比对单文件或目录，快速发现偏差 |
+| 项目迁移/升级 | 老项目引入新架构，批量评估改造量 |
+| 团队培训 | 新成员提交代码前，用审计验证是否符合规范 |
 
+---
+
+## 审计维度（10 项）
+
+### 1. 页面结构审计
+
+**标准**：每个页面目录必须包含 4 个文件：
 ```
-Vue 3.2 + Vite + TypeScript（strict: false）
-Element Plus 2.x + @jhlc/jh-ui 3.x（自研组件库）
-@jhlc/common-core 3.x（查询/表格/工具栏/HTTP/页面Hook基类）
-Windi CSS + SCSS
-Pinia + pinia-plugin-persistedstate
-Module Federation（@originjs/vite-plugin-federation，子应用架构）
+[kebab-case目录]/
+├── index.vue    ← 纯模板+解构
+├── data.ts      ← AbstractPageQueryHook 类 + API_CONFIG
+├── index.scss   ← 样式
+└── api.md       ← 接口约定
 ```
 
-### 2. 微前端架构
+**检查项**：
+- [ ] 目录名是否 kebab-case
+- [ ] 是否缺少 data.ts（逻辑写在 index.vue 里）
+- [ ] 是否缺少 api.md
+- [ ] 是否存在多余文件（如独立的 api.ts）
 
-- 本项目是 Module Federation **子应用**（produce 域）
-- 路由、权限、布局、Store 均从主应用 `main` 远程加载
-- 子应用只负责 `src/views/` 下的业务页面
-- 页面在 `vite/plugins/shared/pages.ts` 注册，构建后通过 `exposes` 暴露给主应用
-- 共享依赖：vue, pinia, vue-router, element-plus, @jhlc/common-core
+### 2. data.ts 模式审计
 
-### 3. 目录结构
+**标准**：使用 `class extends AbstractPageQueryHook` 配置化开发。
 
-```
-src/views/[域]/[模块]/[子模块分组]/[kebab-case-页面目录]/
-├── index.vue              ← 纯模板 + createPage 解构，不写业务逻辑
-├── data.ts                ← AbstractPageQueryHook 类 + API_CONFIG
-├── index.scss             ← 页面样式（可为空）
-└── api.md                 ← 接口约定（前端预留 + 后端出接口依据）
-```
+**检查项**：
+- [ ] 是否有 `API_CONFIG` 常量（URL 配置集中管理）
+- [ ] 是否继承 `AbstractPageQueryHook`
+- [ ] 是否通过 `createPage()` 工厂函数导出
+- [ ] `queryDef()` / `toolbarDef()` / `columnsDef()` 是否齐全
+- [ ] 字典字段是否使用 `logicType: BusLogicDataType.dict`
+- [ ] 操作列是否使用 `operations` 配置而非手写 slot
 
-弹窗组件提取策略：
-
-- **通用弹窗**（2+ 页面复用）→ `src/components/local/c_xxxModal/`（如 `c_modal/`）
-- **极个性弹窗**（仅单页面，c_modal 无法满足）→ 页面 `components/xxxModal.vue`
-
-### 4. data.ts 编码模式（核心）
-
-所有页面使用 `class extends AbstractPageQueryHook` 配置化开发：
-
-```typescript
-import {
-  AbstractPageQueryHook,
-  BaseQueryItemDesc,
-  ActionButtonDesc,
-  TableColumnDesc
-} from "@/types/page";
-import { getAction, postAction } from "@jhlc/common-core/src/api/action";
-import { ElMessage, ElMessageBox } from "element-plus";
-
-// ✅ API 配置：URL 格式为 /[服务缩写]/[资源名CamelCase]/[操作]
-export const API_CONFIG = {
-  list: "/pm/omptMillPlanOrder/list",
-  export: "/pm/omptMillPlanOrder/export",
-  remove: "/pm/omptMillPlanOrder/remove",
-  getById: "/pm/omptMillPlanOrder/getById",
-  save: "/pm/omptMillPlanOrder/save",
-  update: "/pm/omptMillPlanOrder/update"
-} as const;
-
-// ✅ createPage 工厂：接收弹窗 ref，返回 Page.create()
-export function createPage(addModalRef?: any) {
-  let Page = new (class extends AbstractPageQueryHook {
-    constructor() {
-      // super 传入 list 和 remove 的 URL，基类自动处理分页查询和删除
-      super({ url: { list: API_CONFIG.list, remove: API_CONFIG.remove } });
-    }
-
-    // ✅ 查询条件（BaseQuery 组件数据源）
-    queryDef(): BaseQueryItemDesc<any>[] {
-      return [
-        // 普通输入框（默认）
-        { name: "orderNo", label: "订单号", placeholder: "请输入订单号" },
-        // 字典下拉（自动加载字典数据）
-        {
-          name: "planStatus",
-          label: "计划状态",
-          placeholder: "请选择",
-          logicType: BusLogicDataType.dict,
-          logicValue: "planStatus"
-        },
-        // 月份选择器
-        {
-          name: "orderMonth",
-          label: "订单月",
-          placeholder: "请选择",
-          component: () => ({
-            tag: "jh-date",
-            type: "month",
-            showFormat: "YYYY-MM",
-            format: "YYYYMM"
-          })
-        },
-        // 日期范围选择器
-        {
-          name: "planDate",
-          startName: "planStartDate",
-          endName: "planEndDate",
-          label: "计划时间",
-          placeholder: "请选择",
-          component: () => ({
-            tag: "jh-date",
-            type: "daterange",
-            rangeSeparator: "至",
-            showFormat: "YYYY-MM-DD",
-            valueFormat: "YYYY-MM-DD"
-          })
-        }
-      ];
-    }
-
-    // ✅ 工具栏按钮（BaseToolbar 组件数据源）
-    toolbarDef(): ActionButtonDesc[] {
-      return [
-        {
-          name: "primary",
-          label: "新增",
-          plain: true,
-          onClick: () => addModalRef?.value?.open()
-        },
-        {
-          name: "danger",
-          label: "删除",
-          plain: true,
-          onClick: () => {
-            this.actionBatch(
-              this.postAction,
-              API_CONFIG.remove,
-              "确定删除选中数据吗？",
-              this.getSelection().map((item) => item.id)
-            );
-          }
-        }
-      ];
-    }
-
-    // ✅ 表格列（BaseTable 组件数据源）
-    columnsDef(): TableColumnDesc<any>[] {
-      return [
-        { type: "selection" },
-        { type: "index" },
-        {
-          label: "订单号",
-          name: "orderNo",
-          minWidth: 120,
-          sortable: true,
-          filterable: true
-        },
-        // 字典列（自动翻译 value → label）
-        {
-          label: "计划状态",
-          name: "planStatus",
-          minWidth: 120,
-          logicType: BusLogicDataType.dict,
-          logicValue: "planStatus",
-          sortable: true,
-          filterable: true
-        },
-        {
-          label: "计划重量",
-          name: "planWeight",
-          minWidth: 120,
-          sortable: true,
-          filterable: true
-        },
-        // 操作列
-        {
-          label: "操作",
-          operations: [
-            {
-              name: "edit",
-              label: "编辑",
-              onClick: (row) => addModalRef?.value?.open(row.id)
-            },
-            {
-              name: "remove",
-              label: "删除",
-              onClick: (row) => this.remove(row.id)
-            }
-          ]
-        }
-      ];
-    }
-  })();
-
-  return Page.create() as any;
-}
-```
+**严重偏差（红灯）**：
+- ❌ 直接在 `<script setup>` 中写 `ref()` + `onMounted()` + 手动 fetch
+- ❌ 独立 api.ts 文件包含 axios 调用
+- ❌ 手动拼装表格列而不用 `columnsDef()`
 
-### 5. index.vue 模式
-
-```vue
-<template>
-  <div class="app-container app-page-container">
-    <BaseQuery
-      :form="queryParam"
-      :items="queryItems"
-      @select="select"
-      @reset="select"
-    />
-    <BaseToolbar :items="toolbars" />
-    <BaseTable ref="tableRef" :data="list" :columns="columns" showToolbar />
-    <jh-pagination
-      v-show="page.total && page.total > 0"
-      :total="page.total || 0"
-      v-model:currentPage="page.current"
-      v-model:pageSize="page.size"
-      @current-change="select"
-      @size-change="select"
-    />
-  </div>
-</template>
-
-<script setup lang="ts">
-import { createPage } from "./data";
-
-const Page = createPage();
-const {
-  tableRef,
-  page,
-  queryParam,
-  list,
-  queryItems,
-  columns,
-  toolbars,
-  select
-} = Page;
-
-onMounted(() => select());
-</script>
-
-<style scoped lang="scss">
-@import "./index.scss";
-</style>
-```
+### 3. index.vue 模式审计
 
-**强制规则：**
-
-- `<script setup lang="ts">` 必须
-- index.vue 里**不写业务逻辑**
-- 最外层 class 必须是 `app-container app-page-container`
-- 弹窗组件放在根 `</div>` 之后
-- 样式用 `@import "./index.scss"`
-
-### 6. API 写法
-
-```typescript
-// ✅ 使用 @jhlc/common-core 封装方法
-import { getAction, postAction } from "@jhlc/common-core/src/api/action";
-
-// URL 格式：/[服务缩写]/[资源名CamelCase]/[操作]
-// 服务缩写如：pm(生产管理)、mmwr(精整)、mmsm(炼钢)、sale(销售)、hrms(人力)
-
-// 分页查询（基类 super({ url }) 自动处理）
-// 单条查询
-getAction(API_CONFIG.getById, { id });
-// 新增 / 编辑
-postAction(API_CONFIG.save, formData);
-postAction(API_CONFIG.update, formData);
-// 删除（单条）
-this.remove(row.id); // 基类内置方法
-// 批量操作
-this.actionBatch(this.postAction, url, "确认提示", ids);
-```
+**标准**：纯模板 + createPage 解构，不写业务逻辑。
+
+**检查项**：
+- [ ] `<script setup lang="ts">` 是否只有 import + createPage 解构 + onMounted
+- [ ] 是否引用了 BaseQuery / BaseToolbar / BaseTable / jh-pagination 四件套
+- [ ] 最外层 class 是否为 `app-container app-page-container`
+- [ ] 是否有内联业务逻辑（computed、watch、methods 等）
+
+**严重偏差（红灯）**：
+- ❌ `<script setup>` 超过 30 行（大概率混入了业务逻辑）
+- ❌ 手写 `<el-form>` + `<el-table>` 而非平台组件
+- ❌ 直接调用 axios / fetch
+
+### 4. 命名规范审计
+
+| 位置 | 标准 | 检查方式 |
+|------|------|---------|
+| 路由/目录 | kebab-case | 目录名含大写或下划线 → 偏差 |
+| 字段名 | camelCase | data.ts 中 name 属性含下划线 → 偏差 |
+| 全局组件 | `C_PascalCase/` | src/components/global/ 下非此格式 → 偏差 |
+| 局部组件 | `c_camelCase/` | src/components/local/ 下非此格式 → 偏差 |
+| API URL | `/服务缩写/资源名CamelCase/操作` | URL 含下划线或全小写资源名 → 偏差 |
+
+### 5. 组件使用审计
+
+**标准**：优先使用平台组件，禁止手写替代品。
+
+**检查项**：
+- [ ] 查询区域是否用 `<BaseQuery>` 而非手写 `<el-form>`
+- [ ] 工具栏是否用 `<BaseToolbar>` 而非手写按钮行
+- [ ] 表格是否用 `<BaseTable>` 而非裸 `<el-table>`
+- [ ] 分页是否用 `<jh-pagination>` 而非 `<el-pagination>`
+- [ ] 下拉选择是否用 `<jh-select>` 而非 `<el-select>`
+- [ ] 日期选择是否用 `<jh-date>` / `<jh-date-range>` 而非 `<el-date-picker>`
+- [ ] 弹窗是否优先使用 `c_formModal` 等公共组件
+
+### 6. API 写法审计
+
+**标准**：使用 `getAction` / `postAction`（@jhlc/common-core），禁止直接用 axios。
+
+**检查项**：
+- [ ] 是否 import 了 axios / 自封装的 request
+- [ ] 是否使用 `getAction` / `postAction` / `putAction` / `deleteAction`
+- [ ] URL 是否集中在 `API_CONFIG` 中（不散落在各处）
+
+### 7. 样式规范审计
+
+**检查项**：
+- [ ] 是否使用 `:deep()` 而非 `::v-deep` / `/deep/`
+- [ ] 页面样式是否写在 `index.scss` 中（非行内 style）
+- [ ] 是否使用 Windi CSS 工具类优先
+
+### 8. 状态管理审计
+
+**检查项**：
+- [ ] 是否使用 Pinia 而非 Vuex
+- [ ] Store 是否从主应用远程加载（微前端场景）
+
+### 9. 弹窗/组件提取审计
+
+**检查项**：
+- [ ] 2+ 页面复用的弹窗是否提取到 `src/components/local/c_xxxModal/`
+- [ ] 页面私有弹窗是否只在 c_modal 无法满足时才内联
+
+### 10. 路由导航审计（微前端）
+
+**检查项**：
+- [ ] 前进导航是否使用 `location.href`（而非 `router.push()`）
+- [ ] 返回是否使用 `useRouter().back()`
+
+---
 
-详细文档：`docs/request.md`、`docs/page-query-hook-best-practices.md`
-
-### 7. 命名规范
-
-| 位置         | 规范                    | 示例                                 |
-| ------------ | ----------------------- | ------------------------------------ |
-| 路由/目录    | kebab-case              | `ompt-mill-plan/`                    |
-| pages.ts     | `["kebab名", "中文名"]` | `["ompt-mill-plan", "轧钢计划编制"]` |
-| 字段名       | camelCase               | `orderNo`, `planStatus`              |
-| logicValue   | camelCase               | `planStatus`, `plineCode`            |
-| 全局组件     | `C_PascalCase/`         | `C_Tree/`                            |
-| 局部组件     | `c_camelCase/`          | `c_modal/`、`c_detailPanel/`         |
-| 页面私有组件 | camelCase               | `addModal.vue`（仅极个性弹窗）       |
-| API CONFIG   | UPPER_SNAKE（变量名）   | `API_CONFIG`                         |
-| 服务缩写     | 小写简写                | `pm`, `mmwr`, `mmsm`, `sale`         |
-
-### 8. 共享业务组件分类与命名
-
-| 分类 | 路径 | 命名 | 职责 | 示例 |
-|---|---|---|---|---|
-| **通用弹窗** | `src/components/local/c_xxxModal/` | `c_formModal`、`c_modal` | 配置驱动的表单弹窗，多页面复用 | `c_formModal`（CRUD 弹窗） |
-| **业务表单容器** | `src/components/local/c_xxxForm/` | `c_customerApplyForm` | 封装多 Tab 表单 + 数据契约（loadData/collectFormData/validate），多页面共享 | `c_customerTabs`（建议重命名为 `c_customerApplyForm`） |
-| **配置驱动模板** | `src/components/template/XxxTemplate/` | PascalCase | 布局完全相同的 3+ 页面共用的模板组件，页面仅传 config | `FinishingAchievementTemplate`（7 个精整实绩页共用） |
-| **页面私有组件** | `页面目录/components/` | camelCase | 仅单页面使用、c_modal 无法满足的极个性弹窗 | `addModal.vue` |
-
-**命名避坑**：
-- ❌ 不要用 `c_xxxTabs` 命名业务表单容器 → 容易与 `el-tabs` / `jh-tabs` 混淆
-- ✅ 用 `c_xxxForm` / `c_xxxPanel` 表达其"表单容器"本质
-
-### 9. 路由导航规范（微前端子应用）
-
-| 场景 | 方式 | 原因 |
-|---|---|---|
-| **菜单页 → 隐藏页**（列表→表单） | `envConfig()?.router.resolve() + location.href` | 父壳需刷新菜单高亮 |
-| **隐藏页 → 隐藏页**（表单→变更历史） | `envConfig()?.router.resolve() + location.href` | `router.push()` 跳过 shell 的 `generateCurrentRoute`，导致 "Invalid route component" 报错 |
-| **返回上一页** | `useRouter().back()` | 任何页面均可用，无需加载组件 |
-
-> ⚠️ **所有前进导航（无论是否隐藏页）必须用 `location.href`**，`useRouter().push()` 仅用于 `.back()`。
-
-### 10. 样式规范
-
-- Windi CSS 工具类优先
-- `:deep()` 替代 `::v-deep` / `/deep/`
-- jh-drag-row 必须：`.app-page-container .drager_row { height: 100%; }`
-- 所有页面/组件样式统一写在 `index.scss` 中，不可在 template 中大量使用内联 style
-
-### 11. pages.ts 注册
-
-```typescript
-// vite/plugins/shared/pages.ts
-const moduleName = gProd("base-path", {
-  subModuleKey: [["kebab-目录名", "中文名"]]
-});
-// 导出到 list 数组
-export const list: SharedPageItem[] = [...moduleName, ...otherModule];
+## 执行步骤
+
+### 第 1 步：确定审计范围
+
+用户可指定：
+- **全量审计**："审计整个项目" → 扫描 `src/views/` 全部页面
+- **模块审计**："审计 produce/mmwr" → 只扫描该模块目录
+- **单页审计**："审计 mmwr-customer-archive 页面" → 只扫描该页面
+
+### 第 2 步：读取规范基线
+
+读取 `.github/copilot-instructions.md` 获取当前项目的编码规范（唯一源头）。
+
+### 第 3 步：扫描源码
+
+按页面目录逐个扫描：
+1. 列出目录内所有文件 → 检查结构完整性
+2. 读取 `data.ts` → 检查 AbstractPageQueryHook 模式、API_CONFIG、命名等
+3. 读取 `index.vue` → 检查模板结构、是否混入业务逻辑
+4. 读取 `index.scss` → 检查样式规范
+5. 检查 `components/` 子目录 → 评估弹窗提取合理性
+
+### 第 4 步：输出偏差报告
+
+报告格式如下：
+
+```markdown
+# 规范审计报告
+
+## 概要
+
+| 指标 | 值 |
+|------|----|
+| 扫描范围 | src/views/produce/mmwr/ |
+| 页面总数 | 12 |
+| 合规页面 | 8 |
+| 偏差页面 | 4 |
+| 严重偏差数 | 3 |
+| 轻微偏差数 | 7 |
+
+## 严重偏差（必须整改）
+
+### 🔴 [页面路径] — [偏差类型]
+
+**现状**：[当前代码的写法]
+**标准**：[规范要求的写法]
+**整改建议**：[具体怎么改]
+**影响范围**：[改动涉及哪些文件]
+
+## 轻微偏差（建议整改）
+
+### 🟡 [页面路径] — [偏差类型]
+
+**现状**：...
+**标准**：...
+**整改建议**：...
+
+## 合规页面（无需改动）
+
+- ✅ mmwr-customer-archive/
+- ✅ mmwr-customer-detail/
+- ...
+
+## 整改优先级建议
+
+1. 先改严重偏差（结构性问题）
+2. 再改轻微偏差（命名/样式等）
+3. 新增页面一律使用 page-codegen Skill 自动生成，天然合规
 ```
 
+### 第 5 步：按需生成整改代码
+
+如果用户要求，可对偏差页面逐个生成整改后的代码。
+整改时读取 `page-codegen/SKILL.md` 及对应模板，确保整改后代码完全合规。
+
 ---
 
-## 扫描步骤（新项目时使用）
+## 偏差严重度定义
 
-当接入新项目时，扫描以下文件提炼规范：
+| 级别 | 标记 | 定义 | 示例 |
+|------|------|------|------|
+| 🔴 严重 | 必须整改 | 架构性违反，影响可维护性和团队协作 | 不用 AbstractPageQueryHook、直接用 axios、index.vue 混入业务逻辑 |
+| 🟡 轻微 | 建议整改 | 风格/命名不统一，不影响功能 | 目录名用 camelCase 而非 kebab-case、缺少 api.md |
+| ✅ 合规 | 无需改动 | 完全符合规范 | — |
+
+---
 
-1. `package.json` → 技术栈 + 依赖版本
-2. `vite.config.ts` / `vite/plugins/` → 构建配置 + 微前端配置
-3. 页面注册文件（如 `pages.ts`、`router/index.ts`）→ 路由注册规范
-4. `src/views/` 选取 2-3 个典型页面 → 页面结构 + data.ts 模式
-5. `src/components/` → 全局/局部组件规范
-6. `src/api/` → API 写法规范
-7. `src/types/` → 类型规范
-8. 组件文档（如 `docs/`）→ 自研组件用法
-9. `.env*` / 环境配置文件 → 环境变量
+## 与其他 Skill 的关系
+
+| Skill | 关系 |
+|-------|------|
+| **page-codegen** | 审计发现偏差后，可调用 page-codegen 重新生成合规代码 |
+| **prototype-scan** | 审计不涉及原型，仅检查已有代码 |
+| **api-contract** | 审计可检查 api.md 是否存在但不检查其内容（内容由 api-contract 负责） |
+
+---
 
-> **如果新项目是空白/刚初始化的**，跳过本步骤，直接复制 cx-ui-produce 的 `.github/copilot-instructions.md` 作为基础模板，按实际修改即可。
+## 注意事项
 
-输出更新本文件的「已固化规范」部分。
+1. **规范是不可协商的** — 偏差报告中不会因为"旧代码一直这么写"就放行，旧代码不合规就是不合规
+2. **AI 生成的代码必须合规** — 如果用 page-codegen 等 Skill 生成的代码出现偏差，那是 Skill 模板的 bug，需要反馈修复
+3. **规范的演进** — 如果团队决定调整规范，更新 `copilot-instructions.md`（唯一源头），然后重新审计

package/files/.github/skills/menu-sync/env/env.local.json

@@ -0,0 +1,5 @@
+{
+  "gatewayPath": "http://你的网关地址:端口",
+  "parentMenuId": "父级菜单ID",
+  "token": "你的Bearer Token（不含bearer前缀）"
+}

package/package.json

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