@agile-team/wl-skills-kit 1.2.0 → 2.1.0

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

@@ -0,0 +1,81 @@
+# Skills 注册表（单一数据源）
+
+> 触发词 → SKILL 路径的唯一映射。所有 AI 编辑器/模型从此处查路由，**禁止在其他文件重复定义触发词**。
+
+---
+
+## 目录分级（v2.0+）
+
+```
+skills/
+├── _registry.md         ← 本文件
+├── _compat/             多 AI 编辑器适配（配置 + 注入逻辑）
+│
+├── core/                核心通用 Skill（任何前端业务项目通用）
+│   ├── prototype-scan/
+│   ├── api-contract/
+│   ├── page-codegen/
+│   ├── convention-audit/
+│   └── template-extract/
+│
+├── sync/                数据同步类（与后端联动）
+│   ├── menu-sync/
+│   ├── dict-sync/        [PLANNED]
+│   └── permission-sync/  [PLANNED]
+│
+├── ops/                 运维/构建类
+│   └── code-fix/         [PLANNED]
+│
+└── domain/              领域专属 Skill（按域扩展，初始为空）
+```
+
+> **扩展策略**：
+>
+> - Skill 数 ≤ 15 个：留在本仓库分子目录管理
+> - Skill 数 > 15 或出现领域强相关 Skill 集群：拆为独立 npm 包（如 `@agile-team/wl-skills-produce`），主包仅保留 core/sync/ops
+
+---
+
+## 启用 Skill 路由表
+
+| Skill 名         | 状态       | 路径                                         | 触发关键词                                                                 |
+| ---------------- | ---------- | -------------------------------------------- | -------------------------------------------------------------------------- |
+| prototype-scan   | ✅ 启用    | `skills/core/prototype-scan/SKILL.md`        | 扫描原型 / 解析原型 / 页面清单 / 详设文档 / 口述需求 / 建个页面 / 写个页面 |
+| api-contract     | ✅ 启用    | `skills/core/api-contract/SKILL.md`          | 接口约定 / api.md / 字段定义 / 前后端对齐 / 接口设计                       |
+| page-codegen     | ✅ 启用    | `skills/core/page-codegen/SKILL.md`          | 生成页面 / 创建页面 / 代码生成 / vue页面 / 按原型生成 / 帮我生成           |
+| 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        | ⏳ PLANNED | `skills/sync/dict-sync/SKILL.draft.md`       | （草稿，不参与调度）                                                       |
+| permission-sync  | ⏳ PLANNED | `skills/sync/permission-sync/SKILL.draft.md` | （草稿，不参与调度）                                                       |
+| code-fix         | ⏳ PLANNED | `skills/ops/code-fix/SKILL.draft.md`         | （草稿，不参与调度）                                                       |
+
+---
+
+## 调度规则
+
+1. AI 收到用户消息 → 匹配上表 `触发关键词` → `read_file` 加载 `路径` 列对应的 SKILL.md
+2. SKILL.md 中标注的 `必读 standards` 按 `standards/index.md` 任务类型映射加载
+3. 在 SKILL.md 指示下输出 **Pre-flight 声明**（强制约定式输出）
+
+---
+
+## 多触发词时的优先级
+
+当用户消息同时匹配多个 Skill 时（如"扫描原型并生成页面"）：
+
+1. 优先识别**完整流水线意图**：触发 `prototype-scan` → 串接 `api-contract` → 串接 `page-codegen` → 串接 `menu-sync`
+2. 否则按**最具体的触发词**匹配单个 Skill
+3. 用户明确指定时（如"只扫描，不生成"），按用户指示
+
+---
+
+## 配套人读文档
+
+每个启用 Skill 同目录下都有 `USAGE.md`：
+
+| 文件            | 读者           | 用途                                       |
+| --------------- | -------------- | ------------------------------------------ |
+| `SKILL.md`      | AI 编辑器/模型 | 触发规则、流程步骤、Pre-flight 声明        |
+| `USAGE.md`      | 团队成员       | 示例对话、踩坑、FAQ、快速上手              |
+| `*.MAINTAIN.md` | kit 维护者     | 维护要点（在 `kit-internal/skills/` 目录） |

package/files/.github/skills/{api-contract → core/api-contract}/SKILL.md

@@ -46,35 +46,130 @@ description: "Use when: designing API contracts between frontend and backend bas
 
 非标准 CRUD 操作按以下约定命名，URL 后缀使用**动词原形**（camelCase）：
 
-| 操作       | 方法 | URL 后缀          | 请求说明                                |
-| ---------- | ---- | ----------------- | --------------------------------------- |
-| 提交审批   | POST | `/submit`         | `{ id }` 或 `{ ids: [] }`              |
-| 审批通过   | POST | `/approve`        | `{ id, opinion? }`                      |
-| 审批驳回   | POST | `/reject`         | `{ id, opinion }`                       |
-| 撤回       | POST | `/withdraw`       | `{ id }` 撤回已提交的单据              |
-| 启用/禁用  | POST | `/changeStatus`   | `{ id, status }`                        |
-| 转化       | POST | `/convert`        | `{ id }` 临时→正式（如临时客户→正式）  |
-| 下发       | POST | `/release`        | `{ id }` 计划/工单下发执行              |
-| 关闭       | POST | `/close`          | `{ id }` 关闭订单/计划                  |
-| 作废       | POST | `/cancel`         | `{ id }` 作废单据                       |
-| 批量操作   | POST | `/batchXxx`       | 如 `/batchSubmit`、`/batchRemove`       |
-| 子表查询   | POST | `/queryXxxList`   | 如 `/queryDetailList`，主从表场景       |
+| 操作      | 方法 | URL 后缀        | 请求说明                              |
+| --------- | ---- | --------------- | ------------------------------------- |
+| 提交审批  | POST | `/submit`       | `{ id }` 或 `{ ids: [] }`             |
+| 审批通过  | POST | `/approve`      | `{ id, opinion? }`                    |
+| 审批驳回  | POST | `/reject`       | `{ id, opinion }`                     |
+| 撤回      | POST | `/withdraw`     | `{ id }` 撤回已提交的单据             |
+| 启用/禁用 | POST | `/changeStatus` | `{ id, status }`                      |
+| 转化      | POST | `/convert`      | `{ id }` 临时→正式（如临时客户→正式） |
+| 下发      | POST | `/release`      | `{ id }` 计划/工单下发执行            |
+| 关闭      | POST | `/close`        | `{ id }` 关闭订单/计划                |
+| 作废      | POST | `/cancel`       | `{ id }` 作废单据                     |
+| 批量操作  | POST | `/batchXxx`     | 如 `/batchSubmit`、`/batchRemove`     |
+| 子表查询  | POST | `/queryXxxList` | 如 `/queryDetailList`，主从表场景     |
 
 > **命名原则**：`/[服务缩写]/[资源名]/[动作]`，动作用英文动词原形，不用中文拼音，不加 `do` / `handle` 前缀。
 
-### 统一响应结构
+### 统一响应结构（基于真实后端契约）
+
+> ⚠️ **重要**：本项目后端响应外壳为 `{ code, message, data }`（**非 `result`**），成功码为 **`2000`**（**非 200**）。
+
+#### 1. 分页查询响应
+
+```json
+{
+  "code": 2000,
+  "message": "操作成功",
+  "data": {
+    "records": [
+      {
+        /* Entity 字段 */
+      }
+    ],
+    "total": 100,
+    "current": 1,
+    "size": 20,
+    "pages": 5,
+    "countId": null,
+    "maxLimit": null,
+    "orders": [],
+    "searchCount": true
+  }
+}
+```
+
+| data 字段     | 类型    | 说明                                     |
+| ------------- | ------- | ---------------------------------------- |
+| `records`     | array   | 当前页数据列表                           |
+| `total`       | number  | 总记录数                                 |
+| `current`     | number  | 当前页码                                 |
+| `size`        | number  | 每页条数                                 |
+| `pages`       | number  | 总页数                                   |
+| `countId`     | any     | MyBatis-Plus 分页计数 ID（前端忽略）     |
+| `maxLimit`    | any     | 最大单页限制（前端忽略）                 |
+| `orders`      | array   | 排序条件回传（前端忽略，除非需回显排序） |
+| `searchCount` | boolean | 是否执行总数查询（前端忽略）             |
+
+> 前端 `BaseTable` / `AbstractPageQueryHook` 已自动适配：取 `data.records` 渲染、`data.total` 设分页、其他字段透传或忽略。无需在 data.ts 中处理。
+
+#### 2. 单条 / 非分页查询响应
+
+```json
+{
+  "code": 2000,
+  "message": "操作成功",
+  "data": {
+    /* Entity 单对象 */
+  }
+}
+```
+
+或返回数组（无需分页时）：
+
+```json
+{
+  "code": 2000,
+  "message": "操作成功",
+  "data": [
+    {
+      /* Entity */
+    }
+  ]
+}
+```
+
+#### 3. 字典查询响应
+
+```json
+{
+  "code": 2000,
+  "message": "操作成功",
+  "data": [
+    { "value": "01", "label": "已审批", "extra": null },
+    { "value": "02", "label": "驳回", "extra": null }
+  ]
+}
+```
+
+#### 4. 增删改响应
+
+```json
+{ "code": 2000, "message": "操作成功", "data": true }
+```
+
+或返回主键：
 
 ```json
-// 分页查询
-{ "code": 200, "message": "操作成功", "result": { "records": [], "total": 100, "current": 1, "size": 20 } }
+{ "code": 2000, "message": "操作成功", "data": "1234567890123456789" }
+```
 
-// 单条查询
-{ "code": 200, "result": { /* Entity */ } }
+#### 5. 失败响应
 
-// 增删改
-{ "code": 200, "message": "操作成功", "result": true }
+```json
+{ "code": 4001, "message": "参数缺失：customerName 不能为空", "data": null }
 ```
 
+| code 范围     | 含义                              |
+| ------------- | --------------------------------- |
+| `2000`        | 成功                              |
+| `4xxx`        | 客户端错误（参数/权限/校验）      |
+| `5xxx`        | 服务端错误                        |
+| `401` / `403` | 网关层未登录 / 无权限（统一拦截） |
+
+> 业务代码**不需要**关心 `code` 判断，`request.ts` 拦截器统一处理：非 2000 自动 `Promise.reject` + Toast 提示。业务代码 `.then()` 拿到的就是 `data` 字段内容。
+
 ### 字段命名
 
 | 端   | 规范         | 说明                           |
@@ -111,7 +206,7 @@ export const API_CONFIG = {
   update: "/pm/omptMillPlanOrder/update",
   export: "/pm/omptMillPlanOrder/export",
   // 按需增加业务操作
-  release: "/pm/omptMillPlanOrder/release"
+  release: "/pm/omptMillPlanOrder/release",
 } as const;
 ```
 
@@ -140,7 +235,7 @@ export const API_CONFIG = {
   getById: "/[服务缩写]/[资源名]/getById",
   save: "/[服务缩写]/[资源名]/save",
   update: "/[服务缩写]/[资源名]/update",
-  export: "/[服务缩写]/[资源名]/export"
+  export: "/[服务缩写]/[资源名]/export",
 } as const;
 ```
 
@@ -179,7 +274,7 @@ POST /[服务缩写]/[资源名]/list
 | [startDate]   | string | ❌   | 开始日期 YYYY-MM-DD                 |
 | [endDate]     | string | ❌   | 结束日期 YYYY-MM-DD                 |
 
-**响应 records：** 同实体定义
+**响应 data.records：** 同实体定义；外壳 `{ code: 2000, message, data: { records, total, current, size, pages, countId, maxLimit, orders, searchCount } }`
 
 ### 2. 详情查询
 
@@ -187,7 +282,7 @@ POST /[服务缩写]/[资源名]/list
 GET /[服务缩写]/[资源名]/getById?id=xxx
 ```
 
-**响应 result：** 单个 Entity
+**响应 data：** 单个 Entity；外壳 `{ code: 2000, message, data: {...} }`
 
 ### 3. 新增
 
@@ -231,11 +326,13 @@ GET /[服务缩写]/[资源名]/export?[查询参数]
 
 ## 联调注意
 
-1. 前端字段全部 camelCase，后端 JSON 序列化输出 camelCase
-2. 时间字段统一 `YYYY-MM-DD HH:mm:ss`
-3. 大数字 ID 后端转字符串
-4. 分页参数是 `current` / `size`（基类自动处理）
-5. 枚举字段前端传 value，后端可返回 `[field]Label` 辅助展示
+1. **响应外壳**：`{ code, message, data }`，成功 `code: 2000`（非 200，非 result）
+2. 前端字段全部 camelCase，后端 JSON 序列化输出 camelCase
+3. 时间字段统一 `YYYY-MM-DD HH:mm:ss`
+4. 大数字 ID 后端转字符串（雪花 ID 超过 JS Number 精度）
+5. 分页参数前端传 `current` / `size`（基类自动处理），后端响应 `data.records` / `data.total`
+6. 枚举字段前端传 value，后端可返回 `[field]Label` 辅助展示，或前端自行通过 `logicValue` 字典翻译
+7. 业务代码 `.then(res => res)` 拿到的就是 `data` 字段（拦截器已剥外壳）
 ````
 
 ---

package/files/.github/skills/core/api-contract/USAGE.md

@@ -0,0 +1,110 @@
+# 使用指南：api-contract（接口约定）
+
+> **谁读这个文档**：团队成员（前端/后端/产品）
+> **AI 触发文件**：同目录 `SKILL.md`
+
+---
+
+## 这个 Skill 解决什么问题
+
+为每个页面生成一份 `api.md`，**作为前后端联调的契约**：
+
+- 前端：`data.ts` 里的 `API_CONFIG` URL、查询字段直接来源于此
+- 后端：拿 api.md 即可写 Controller + Service + Entity，字段名一致零联调成本
+
+---
+
+## 何时使用
+
+- 拿到《页面清单》（来自 `prototype-scan`），准备让后端开发接口
+- 已有页面但接口未定义，需要补齐契约
+- 接口字段需要变更，更新 api.md 让前后端同步
+
+---
+
+## 触发关键词
+
+`接口约定` / `api.md` / `字段定义` / `前后端对齐` / `接口设计`
+
+---
+
+## 真实响应契约（务必背下来）
+
+```json
+// 分页
+{ "code": 2000, "message": "操作成功", "data": { "records": [...], "total": 100, "current": 1, "size": 20, "pages": 5, "countId": null, "maxLimit": null, "orders": [], "searchCount": true } }
+
+// 单条 / 数组
+{ "code": 2000, "message": "...", "data": { /* 或 [] */ } }
+
+// 失败
+{ "code": 4001, "message": "...", "data": null }
+```
+
+- **code 成功值是 `2000`**（不是 200！）
+- **包裹字段是 `data`**（不是 `result`！）
+- 业务代码 `.then(res => res)` 拿到的已是 `data` 内容（拦截器剥壳）
+
+---
+
+## 标准对话示例
+
+```
+你：基于 reports/PROTOTYPE_SCAN_客户管理_20260426.md 生成各页面的 api.md
+AI：[Pre-flight]
+    将生成 7 个 api.md 文件，输出位置：
+    src/views/produce/aiflow/mmwr-customer-archive/api.md
+    src/views/produce/aiflow/mmwr-customer-detail/api.md
+    ...
+    服务缩写：mmwr，资源名：mmwrCustomer*
+    需向你确认 3 项：
+    1. 主键字段是 customerCode 还是 customerNo？
+    2. 状态字典 logicValue 是 customer_state 还是 mmwr_customer_state？
+    3. 临时客户转正式客户是 /convert 还是单独接口？
+```
+
+---
+
+## 输出物
+
+每个页面目录下生成 `api.md`，结构：
+
+1. **API_CONFIG**（粘贴到 data.ts 用）
+2. **实体定义**（字段名、类型、字典、必填）
+3. **接口清单**（list/getById/save/update/remove/export + 业务操作如 release/approve）
+4. **数据字典**（dictCode 列表）
+5. **联调注意**
+
+---
+
+## 团队协作流程
+
+1. 前端基于 prototype-scan 输出生成 api.md（标 🟡 待确认）
+2. **发后端 review**（钉钉/IM 直接发文件路径）
+3. 后端确认字段，标 🟢 已确认
+4. 后端按 api.md 出接口，前端按 api.md 写 data.ts
+5. 联调时若有变更，更新 api.md 并标 🔴 有变更，双方同步修改
+
+---
+
+## 常见踩坑
+
+| 现象                                              | 原因                           | 解法                                          |
+| ------------------------------------------------- | ------------------------------ | --------------------------------------------- |
+| 字段名不一致（前端 customerNo 后端 customerCode） | 没走 api.md 直接编码           | 强制约定：**先 api.md 再 data.ts**            |
+| 拦截器报"code 不是 2000"                          | mock 数据用了 200              | 改 mock 为 2000                               |
+| 业务代码报 `data.records is undefined`            | 后端忘记包装外壳，返回了纯数组 | 后端按契约包 `{ code, message, data: {...} }` |
+| 雪花 ID 精度丢失                                  | 后端返回 number                | 后端 ID 字段统一 String 序列化                |
+
+---
+
+## FAQ
+
+**Q：api.md 一定要放在页面目录下吗？**
+A：是。便于 PR review 时一眼看到改了哪个页面的契约。
+
+**Q：可以跳过 api.md 直接 codegen 吗？**
+A：技术上可以，AI 会用通用模板字段，但**联调时必踩坑**。建议至少写到"实体定义"段落。
+
+**Q：业务操作（如 release / approve）需要写吗？**
+A：写。`page-codegen` 会读取 api.md 中的业务操作列表，自动在 toolbar 里加按钮。

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

@@ -0,0 +1,189 @@
+---
+name: convention-audit
+description: "Use when: auditing project source code against the 13 modular standards in .github/standards/. Outputs deviation report and component-extraction suggestions to reports/. Triggers on: 规范审计, 规范检查, 代码审计, 对齐规范, 规范偏差, audit code, check conventions."
+---
+
+# Skill: 规范审计（convention-audit）
+
+以 `.github/standards/` 13 条规范为唯一基线，扫描项目源码，输出**偏差报告**和**组件提取建议**到 `reports/` 目录。
+
+> **核心理念**：规范是"标准"，代码必须对齐标准。本 Skill 只负责发现偏差并给出整改建议，**不自动修复**（修复由 [PLANNED] code-fix Skill 完成）。
+
+---
+
+## 触发词
+
+`规范审计` / `规范检查` / `代码审计` / `对齐规范` / `规范偏差` / `audit code`
+
+---
+
+## Pre-flight 声明（执行前必须输出）
+
+```
+🚀 已触发技能 convention-audit/SKILL.md → 规范审计：扫描源码 + 偏差报告 + 提取建议
+✅ 已读取 standards/index.md          → 规范门控
+✅ 已读取 standards/01 ~ 13           → 完整 13 条规范基线（审计场景需全量加载）
+✅ 已读取 reports/规范审查报告.md      → 现有报告（用于追加，不覆盖）
+✅ 审计范围：{用户指定的目录或单文件}
+```
+
+---
+
+## 适用场景
+
+| 场景                        | 说明                                     |
+| --------------------------- | ---------------------------------------- |
+| 新项目导入 wl-skills-kit 后 | 扫描旧代码，输出整改清单，逐步迁移       |
+| 日常 Code Review 辅助       | 比对单文件或目录，快速发现偏差           |
+| 项目迁移/升级               | 老项目引入新架构，批量评估改造量         |
+| 团队培训                    | 新成员提交代码前，用审计验证是否符合规范 |
+| page-codegen 后置自检       | 页面生成完成后自动跑一次审计，确认合规   |
+| CI/CD（PLANNED）            | PR 上自动跑审计，不合规 PR 阻断合并      |
+
+---
+
+## 审计范围（13 条规范全覆盖）
+
+| 编号 | 审计维度                     | 严重度判定                                                           |
+| ---- | ---------------------------- | -------------------------------------------------------------------- |
+| 01   | 工具链就绪                   | 缺少 `.prettierrc.js` / `eslint.config.ts` / `.husky/` → 🔴 严重     |
+| 02   | 4 文件原则、三段式、9 段顺序 | 缺 data.ts / index.vue 含业务逻辑 → 🔴；段落顺序乱 → 🟡              |
+| 03   | 注释规范                     | 文件头缺失 → 🟡；显而易见的注释 → 🟢 提示                            |
+| 04   | 基础编码（13 条）            | 用 var / for...in / 字符串拼接 → 🟡                                  |
+| 05   | console 残留                 | src/ 下任何 console.log / warn / error → 🟡                          |
+| 06   | 安全规范                     | v-html 无注释 / import axios / eval → 🔴                             |
+| 07   | 配置管理                     | 硬编码 `http://` / `https://` IP → 🔴；非 VITE\_ 环境变量 → 🟡       |
+| 08   | Git 规范                     | （审计时不检测，由 husky 自动拦截）                                  |
+| 09   | TypeScript                   | 滥用 any（>3 处/页） → 🟡                                            |
+| 10   | Pinia                        | data.ts 内 import Store → 🔴                                         |
+| 11   | 表单校验                     | FORM_ROUTE 缺 validate / resetFields → 🔴                            |
+| 12   | BaseTable + cid              | 用 el-table / 缺 render-type / cid 缺失或重复 → 🔴                   |
+| 13   | 平台组件合规                 | 用 el-form/el-table/el-date-picker 替代封装 → 🔴；3+ 复用 → 提取建议 |
+
+---
+
+## 执行流程
+
+### 步骤 1：确定审计范围
+
+| 用户输入                          | 范围          |
+| --------------------------------- | ------------- |
+| "审计整个项目"                    | `src/views/`  |
+| "审计 produce/mmwr"               | 该子目录      |
+| "审计 mmwr-customer-archive 页面" | 单页面 4 文件 |
+
+### 步骤 2：加载规范基线
+
+读取 `standards/01 ~ 13` 全部规范文件（审计场景必须全量加载）。
+
+### 步骤 3：扫描源码
+
+逐个文件检查 13 个维度。同时记录：
+
+- **跨页面相同 el-\* 模式**（统计出现次数和位置）
+- **每个偏差所在文件的菜单位置**（从 koroFileHeader 文件头注释解析）
+
+### 步骤 4：追加写入两份报告
+
+#### 报告 A：`reports/规范审查报告.md`（追加，最新章节在顶）
+
+```markdown
+## 🕐 {YYYY-MM-DD HH:mm} | 范围：{范围} | 触发：{user / page-codegen / CI}
+
+### 概要
+
+| 指标     | 值  |
+| -------- | --- |
+| 扫描页面 | 12  |
+| 合规页面 | 8   |
+| 偏差页面 | 4   |
+| 🔴 严重  | 5   |
+| 🟡 轻微  | 7   |
+
+### 🔴 严重偏差（必须整改）
+
+#### {页面路径} — 违反规范 13（平台组件合规）
+
+- **菜单位置**（来自文件头）：销售管理 > 国内贸易订单
+- **现状**：使用 `<el-table>` 渲染数据
+- **应为**：使用 `<BaseTable render-type="agGrid" cid="...">`
+- **整改建议**：参考 templates/universal/TPL-LIST.md
+- **修复标记**：🔧 待修复
+
+（按规范条目分组列出全部偏差）
+
+### 🟡 轻微偏差（建议整改）
+
+（同格式）
+
+### ✅ 合规页面
+
+- src/views/produce/.../mmwr-customer-archive/
+- ...
+
+---
+
+（历史章节自然下沉）
+```
+
+#### 报告 B：`reports/组件提取建议.md`（追加）
+
+```markdown
+## 🕐 {YYYY-MM-DD HH:mm} | 范围：{范围}
+
+### 📦 组件提取建议（共 N 处）
+
+| 建议组件名    | 出现次数 | 页面路径                                 | 菜单位置              | 模式描述         |
+| ------------- | -------- | ---------------------------------------- | --------------------- | ---------------- |
+| c_statusBadge | 5 处     | src/views/sale/.../{a,b,c,d,e}/index.vue | 销售管理 > 多个子菜单 | 状态枚举彩色标签 |
+| c_priceFormat | 4 处     | src/views/.../...                        | ...                   | 千分位金额显示   |
+
+> ⚠️ 以上为建议，不自动提取。
+> 人工确认后，触发 `template-extract` Skill（页面级模板）或手动封装为 `c_*` 组件。
+```
+
+### 步骤 5：输出摘要
+
+```
+📦 审计完成
+─────────────────────────────────────────────────────
+✅ reports/规范审查报告.md   → 已追加章节（{N} 个偏差）
+✅ reports/组件提取建议.md  → 已追加 {M} 条提取建议
+─────────────────────────────────────────────────────
+📌 后续步骤：
+   1. 人工 review 报告，标记需要修复的条目
+   2. 严重偏差优先修复（用 page-codegen 重新生成）
+   3. [PLANNED] 触发 code-fix 自动整改 🟢/🟡 等级偏差
+   4. 提取建议人工评审 → template-extract 或手动封装
+─────────────────────────────────────────────────────
+```
+
+---
+
+## 偏差严重度定义
+
+| 级别 | 标记 | 定义                                       | 示例                                                  |
+| ---- | ---- | ------------------------------------------ | ----------------------------------------------------- |
+| 🔴   | 严重 | 架构性违反，影响可维护性 / 安全 / 团队协作 | 不用 AbstractPageQueryHook、用 el-table、import axios |
+| 🟡   | 轻微 | 风格 / 命名不统一，不影响功能              | for...in、目录名 camelCase、缺 api.md                 |
+| 🟢   | 提示 | 优化建议，可逐步改进                       | 重复表达式可抽 computed、超长函数可拆分               |
+
+---
+
+## 与其他 Skill 的关系
+
+| Skill                  | 关系                                                    |
+| ---------------------- | ------------------------------------------------------- |
+| **page-codegen**       | 审计发现偏差后，可调用 page-codegen 重新生成合规代码    |
+| **template-extract**   | 审计输出的"组件提取建议"，确认后可触发 template-extract |
+| **code-fix** [PLANNED] | 审计报告作为修复输入，自动整改 🟢🟡 等级偏差            |
+| **CI/CD**              | 审计可作为 PR 检查项，不合规 PR 阻断合并                |
+
+---
+
+## 注意事项
+
+1. **规范基线唯一**：以 `standards/index.md` 加载的 13 条文件为准，**不接受**"旧代码一直这么写"的辩解
+2. **追加不覆盖**：每次审计追加新章节到报告，**不删除历史**，便于追溯整改进度
+3. **菜单位置解析**：依赖 koroFileHeader 文件头注释，缺失文件头时标记 `菜单位置：未知`
+4. **AI 自我审计**：page-codegen 生成代码后，建议立即跑一次单页审计验证合规