@agile-team/wl-skills-kit 2.2.0 → 2.3.1

package/files/.github/reports//350/247/204/350/214/203/345/256/241/346/237/245/346/212/245/345/221/212.md

@@ -1,44 +1,44 @@
-# 规范审查报告
-
-> 由 `convention-audit` Skill 自动追加写入。**最新章节在顶部**，历史章节自然下沉。
->
-> 整改优先级：🔴 严重 → 🟡 轻微 → 🟢 提示
-
----
-
-<!--
-追加格式示例（AI 生成时按此格式插入到文件顶部 ## 之前）：
-
-## 🕐 2026-04-26 14:30 | 范围：src/views/sale/ | 触发：user
-
-### 概要
-| 指标 | 值 |
-|------|---|
-| 扫描页面 | 12 |
-| 合规页面 | 8 |
-| 偏差页面 | 4 |
-| 🔴 严重 | 5 |
-| 🟡 轻微 | 7 |
-
-### 🔴 严重偏差（必须整改）
-
-#### src/views/sale/.../customer-list/index.vue — 违反规范 13（平台组件合规）
-- **菜单位置**（来自文件头）：销售管理 > 客户档案
-- **现状**：使用 `<el-table>` 渲染数据
-- **应为**：使用 `<BaseTable render-type="agGrid" cid="...">`
-- **整改建议**：参考 templates/universal/TPL-LIST.md
-- **修复标记**：🔧 待修复
-
-### 🟡 轻微偏差
-
-（同格式）
-
-### ✅ 合规页面
-- src/views/produce/.../mmwr-customer-archive/
-
----
-
-（旧报告章节）
--->
-
-> 本文件初始为空。首次执行 convention-audit 后，将自动填入审查内容。
+# 规范审查报告
+
+> 由 `convention-audit` Skill 自动追加写入。**最新章节在顶部**，历史章节自然下沉。
+>
+> 整改优先级：🔴 严重 → 🟡 轻微 → 🟢 提示
+
+---
+
+<!--
+追加格式示例（AI 生成时按此格式插入到文件顶部 ## 之前）：
+
+## 🕐 2026-04-26 14:30 | 范围：src/views/sale/ | 触发：user
+
+### 概要
+| 指标 | 值 |
+|------|---|
+| 扫描页面 | 12 |
+| 合规页面 | 8 |
+| 偏差页面 | 4 |
+| 🔴 严重 | 5 |
+| 🟡 轻微 | 7 |
+
+### 🔴 严重偏差（必须整改）
+
+#### src/views/sale/.../customer-list/index.vue — 违反规范 13（平台组件合规）
+- **菜单位置**（来自文件头）：销售管理 > 客户档案
+- **现状**：使用 `<el-table>` 渲染数据
+- **应为**：使用 `<BaseTable render-type="agGrid" cid="...">`
+- **整改建议**：参考 templates/universal/TPL-LIST.md
+- **修复标记**：🔧 待修复
+
+### 🟡 轻微偏差
+
+（同格式）
+
+### ✅ 合规页面
+- src/views/produce/.../mmwr-customer-archive/
+
+---
+
+（旧报告章节）
+-->
+
+> 本文件初始为空。首次执行 convention-audit 后，将自动填入审查内容。

package/files/.github/skills/_compat/README.md

@@ -1,108 +1,108 @@
-# \_compat — 多 AI 编辑器适配层
-
-> ⚠️ **本目录是配置层，不是说明文档。**
-> `bin/wl-skills.js` 在 `init` / `update` 时读取本目录的模板，**生成业务项目根目录下各 AI 编辑器需要的配置文件**。
-
----
-
-## 设计原则
-
-1. **解耦**：每个 AI 编辑器的配置文件**独立**，移除/新增任意编辑器不影响其他
-2. **零污染**：每个编辑器**只读自己的配置文件**，不会读到其他编辑器的内容
-3. **特化注入**：各编辑器的 frontmatter / 头部规范由对应模板决定（Cursor 需 `description+globs+alwaysApply`，Kiro 需 `inclusion`，Trae 需 `description`，Cline/Windsurf 无 frontmatter）
-4. **内容统一**：所有编辑器的"主体内容"来自 `copilot-instructions.md`，**单一数据源**修改一处全员同步
-
----
-
-## 目录结构
-
-```
-_compat/
-├── README.md            ← 本文件
-├── editors.json         ← 编辑器注册表（bin/wl-skills.js 读取）
-└── headers/             ← 各编辑器特化头部模板
-    ├── github-copilot.txt
-    ├── claude-code.txt
-    ├── cursor-rules.txt        （.cursorrules 用，无 frontmatter）
-    ├── cursor-mdc.txt          （.cursor/rules/conventions.mdc 用，含 frontmatter）
-    ├── windsurf.txt
-    ├── cline.txt
-    ├── kiro.txt                （.kiro/steering/conventions.md，含 frontmatter）
-    ├── trae.txt                （.trae/rules/conventions.md，含 frontmatter）
-    └── agents.txt              （AGENTS.md 通用代理）
-```
-
----
-
-## 工作流程
-
-```
-bin/wl-skills.js (init/update)
-    │
-    ├─ 读取 files/.github/copilot-instructions.md  → MAIN_BODY
-    │
-    ├─ 读取 _compat/editors.json                   → 编辑器列表
-    │
-    └─ 对每个 editor in editors.json:
-         ├─ 读取 headers/{editor.headerFile}        → HEADER（含特化 frontmatter）
-         ├─ 拼接：HEADER + AUTO_HEADER_NOTE + MAIN_BODY
-         └─ 写入到业务项目：editor.outputPath
-```
-
----
-
-## 解耦验证
-
-| 场景                                  | 受影响文件                    | 不受影响文件                |
-| ------------------------------------- | ----------------------------- | --------------------------- |
-| 团队不用 Cursor，从 editors.json 删除 | `.cursorrules`、`.cursor/`    | `.github/`、CLAUDE.md、其他 |
-| 团队新增某 AI 编辑器（如 Augment）    | 加 headers/augment.txt + 注册 | 其他文件不动                |
-| `copilot-instructions.md` 内容更新    | 全部 8 个根配置同步更新       | headers/ 不变（只是模板）   |
-
----
-
-## 修改 / 扩展示例
-
-### 添加新编辑器（如 Augment）
-
-1. 在 `headers/` 创建 `augment.txt`（含该编辑器要求的 frontmatter）
-2. 在 `editors.json` 追加：
-   ```json
-   {
-     "name": "augment",
-     "headerFile": "augment.txt",
-     "outputPath": ".augment/rules.md",
-     "enabled": true
-   }
-   ```
-3. `npm publish`，业务项目执行 `update` 即可
-
-### 临时禁用某编辑器
-
-```json
-{
-  "name": "kiro",
-  "headerFile": "kiro.txt",
-  "outputPath": ".kiro/...",
-  "enabled": false
-}
-```
-
-`enabled: false` 的编辑器**不生成**对应根配置文件，已存在的用户可手动删除。
-
----
-
-## 与官方机制的对应关系（截至 2026-04）
-
-| 编辑器         | 官方加载路径                           | 是否需要 frontmatter | 备注                             |
-| -------------- | -------------------------------------- | -------------------- | -------------------------------- |
-| GitHub Copilot | `.github/copilot-instructions.md`      | ❌                   | 唯一识别 .github/ 子目录的编辑器 |
-| Claude Code    | `CLAUDE.md` (root)                     | ❌                   | 自动加载根目录 CLAUDE.md         |
-| Cursor         | `.cursorrules` + `.cursor/rules/*.mdc` | ❌ / ✅              | 双形式，新版 mdc 需 frontmatter  |
-| Windsurf       | `.windsurfrules` (root)                | ❌                   | 单文件                           |
-| Cline          | `.clinerules` (root)                   | ❌                   | 单文件                           |
-| Kiro           | `.kiro/steering/*.md`                  | ✅                   | 需 inclusion 字段                |
-| Trae           | `.trae/rules/*.md`                     | ✅                   | 需 description 字段              |
-| 通用 Agent     | `AGENTS.md` (root)                     | ❌                   | 新兴跨平台规范                   |
-
-> 所有这些编辑器在加载完根配置后，**都支持按指令读取项目内任意文件**（含 `.github/standards/`、`.github/skills/`、`.github/guides/`），所以本架构的"懒加载门控 + 子目录规范"对所有编辑器**有效**。
+# \_compat — 多 AI 编辑器适配层
+
+> ⚠️ **本目录是配置层，不是说明文档。**
+> `bin/wl-skills.js` 在 `init` / `update` 时读取本目录的模板，**生成业务项目根目录下各 AI 编辑器需要的配置文件**。
+
+---
+
+## 设计原则
+
+1. **解耦**：每个 AI 编辑器的配置文件**独立**，移除/新增任意编辑器不影响其他
+2. **零污染**：每个编辑器**只读自己的配置文件**，不会读到其他编辑器的内容
+3. **特化注入**：各编辑器的 frontmatter / 头部规范由对应模板决定（Cursor 需 `description+globs+alwaysApply`，Kiro 需 `inclusion`，Trae 需 `description`，Cline/Windsurf 无 frontmatter）
+4. **内容统一**：所有编辑器的"主体内容"来自 `copilot-instructions.md`，**单一数据源**修改一处全员同步
+
+---
+
+## 目录结构
+
+```
+_compat/
+├── README.md            ← 本文件
+├── editors.json         ← 编辑器注册表（bin/wl-skills.js 读取）
+└── headers/             ← 各编辑器特化头部模板
+    ├── github-copilot.txt
+    ├── claude-code.txt
+    ├── cursor-rules.txt        （.cursorrules 用，无 frontmatter）
+    ├── cursor-mdc.txt          （.cursor/rules/conventions.mdc 用，含 frontmatter）
+    ├── windsurf.txt
+    ├── cline.txt
+    ├── kiro.txt                （.kiro/steering/conventions.md，含 frontmatter）
+    ├── trae.txt                （.trae/rules/conventions.md，含 frontmatter）
+    └── agents.txt              （AGENTS.md 通用代理）
+```
+
+---
+
+## 工作流程
+
+```
+bin/wl-skills.js (init/update)
+    │
+    ├─ 读取 files/.github/copilot-instructions.md  → MAIN_BODY
+    │
+    ├─ 读取 _compat/editors.json                   → 编辑器列表
+    │
+    └─ 对每个 editor in editors.json:
+         ├─ 读取 headers/{editor.headerFile}        → HEADER（含特化 frontmatter）
+         ├─ 拼接：HEADER + AUTO_HEADER_NOTE + MAIN_BODY
+         └─ 写入到业务项目：editor.outputPath
+```
+
+---
+
+## 解耦验证
+
+| 场景                                  | 受影响文件                    | 不受影响文件                |
+| ------------------------------------- | ----------------------------- | --------------------------- |
+| 团队不用 Cursor，从 editors.json 删除 | `.cursorrules`、`.cursor/`    | `.github/`、CLAUDE.md、其他 |
+| 团队新增某 AI 编辑器（如 Augment）    | 加 headers/augment.txt + 注册 | 其他文件不动                |
+| `copilot-instructions.md` 内容更新    | 全部 8 个根配置同步更新       | headers/ 不变（只是模板）   |
+
+---
+
+## 修改 / 扩展示例
+
+### 添加新编辑器（如 Augment）
+
+1. 在 `headers/` 创建 `augment.txt`（含该编辑器要求的 frontmatter）
+2. 在 `editors.json` 追加：
+   ```json
+   {
+     "name": "augment",
+     "headerFile": "augment.txt",
+     "outputPath": ".augment/rules.md",
+     "enabled": true
+   }
+   ```
+3. `npm publish`，业务项目执行 `update` 即可
+
+### 临时禁用某编辑器
+
+```json
+{
+  "name": "kiro",
+  "headerFile": "kiro.txt",
+  "outputPath": ".kiro/...",
+  "enabled": false
+}
+```
+
+`enabled: false` 的编辑器**不生成**对应根配置文件，已存在的用户可手动删除。
+
+---
+
+## 与官方机制的对应关系（截至 2026-04）
+
+| 编辑器         | 官方加载路径                           | 是否需要 frontmatter | 备注                             |
+| -------------- | -------------------------------------- | -------------------- | -------------------------------- |
+| GitHub Copilot | `.github/copilot-instructions.md`      | ❌                   | 唯一识别 .github/ 子目录的编辑器 |
+| Claude Code    | `CLAUDE.md` (root)                     | ❌                   | 自动加载根目录 CLAUDE.md         |
+| Cursor         | `.cursorrules` + `.cursor/rules/*.mdc` | ❌ / ✅              | 双形式，新版 mdc 需 frontmatter  |
+| Windsurf       | `.windsurfrules` (root)                | ❌                   | 单文件                           |
+| Cline          | `.clinerules` (root)                   | ❌                   | 单文件                           |
+| Kiro           | `.kiro/steering/*.md`                  | ✅                   | 需 inclusion 字段                |
+| Trae           | `.trae/rules/*.md`                     | ✅                   | 需 description 字段              |
+| 通用 Agent     | `AGENTS.md` (root)                     | ❌                   | 新兴跨平台规范                   |
+
+> 所有这些编辑器在加载完根配置后，**都支持按指令读取项目内任意文件**（含 `.github/standards/`、`.github/skills/`、`.github/guides/`），所以本架构的"懒加载门控 + 子目录规范"对所有编辑器**有效**。

package/files/.github/skills/_compat/headers/agents.txt

@@ -1,8 +1,8 @@
-# AGENTS.md — 通用代理协议（项目编码规范）
-
-> 此文件遵循 [agents.md 跨编辑器协议](https://agents.md)，可被任意支持该协议的 AI 代理读取。
-> 由 @agile-team/wl-skills-kit 自动生成。源文件：`.github/copilot-instructions.md`
-> 更新方式：`npx @agile-team/wl-skills-kit@latest update`
-
----
-
+# AGENTS.md — 通用代理协议（项目编码规范）
+
+> 此文件遵循 [agents.md 跨编辑器协议](https://agents.md)，可被任意支持该协议的 AI 代理读取。
+> 由 @agile-team/wl-skills-kit 自动生成。源文件：`.github/copilot-instructions.md`
+> 更新方式：`npx @agile-team/wl-skills-kit@latest update`
+
+---
+

package/files/.github/skills/_compat/headers/claude-code.txt

@@ -1,7 +1,7 @@
-# Claude Code 项目编码规范
-
-> 此文件由 `@agile-team/wl-skills-kit` 自动生成。源文件：`.github/copilot-instructions.md`
-> 请勿手动编辑本文件，更新时执行：`npx @agile-team/wl-skills-kit@latest update`
-
----
-
+# Claude Code 项目编码规范
+
+> 此文件由 `@agile-team/wl-skills-kit` 自动生成。源文件：`.github/copilot-instructions.md`
+> 请勿手动编辑本文件，更新时执行：`npx @agile-team/wl-skills-kit@latest update`
+
+---
+

package/files/.github/skills/_compat/headers/cline.txt

@@ -1,7 +1,7 @@
-# Cline 项目编码规范（.clinerules）
-
-> 由 @agile-team/wl-skills-kit 自动生成。请勿手动编辑。
-> 更新方式：npx @agile-team/wl-skills-kit@latest update
-
----
-
+# Cline 项目编码规范（.clinerules）
+
+> 由 @agile-team/wl-skills-kit 自动生成。请勿手动编辑。
+> 更新方式：npx @agile-team/wl-skills-kit@latest update
+
+---
+

package/files/.github/skills/_compat/headers/cursor-mdc.txt

@@ -1,16 +1,16 @@
----
-description: "项目编码规范（13 条标准 + 8 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
-globs:
-  - "**/*.vue"
-  - "**/*.ts"
-  - "**/*.tsx"
-  - "**/*.js"
-  - "**/*.scss"
-alwaysApply: true
----
-
-<!-- Cursor MDC 规则文件。由 @agile-team/wl-skills-kit 自动生成。 -->
-<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
-
----
-
+---
+description: "项目编码规范（13 条标准 + 8 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
+globs:
+  - "**/*.vue"
+  - "**/*.ts"
+  - "**/*.tsx"
+  - "**/*.js"
+  - "**/*.scss"
+alwaysApply: true
+---
+
+<!-- Cursor MDC 规则文件。由 @agile-team/wl-skills-kit 自动生成。 -->
+<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
+
+---
+

package/files/.github/skills/_compat/headers/cursor-rules.txt

@@ -1,7 +1,7 @@
-# Cursor 项目编码规范（.cursorrules）
-
-> 由 @agile-team/wl-skills-kit 自动生成。请勿手动编辑。
-> 更新方式：npx @agile-team/wl-skills-kit@latest update
-
----
-
+# Cursor 项目编码规范（.cursorrules）
+
+> 由 @agile-team/wl-skills-kit 自动生成。请勿手动编辑。
+> 更新方式：npx @agile-team/wl-skills-kit@latest update
+
+---
+

package/files/.github/skills/_compat/headers/github-copilot.txt

@@ -1 +1 @@
-<!-- GitHub Copilot 自动加载 .github/copilot-instructions.md，无需特化 header。bin/wl-skills.js 对此编辑器实际是直接复制源文件，不附加任何头部。-->
+<!-- GitHub Copilot 自动加载 .github/copilot-instructions.md，无需特化 header。bin/wl-skills.js 对此编辑器实际是直接复制源文件，不附加任何头部。-->

package/files/.github/skills/_compat/headers/kiro.txt

@@ -1,10 +1,10 @@
----
-inclusion: always
-description: 项目编码规范（13 条标准 + 8 个 Skill 自动调度）
----
-
-<!-- Kiro Steering 规则。由 @agile-team/wl-skills-kit 自动生成。-->
-<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
-
----
-
+---
+inclusion: always
+description: 项目编码规范（13 条标准 + 8 个 Skill 自动调度）
+---
+
+<!-- Kiro Steering 规则。由 @agile-team/wl-skills-kit 自动生成。-->
+<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
+
+---
+

package/files/.github/skills/_compat/headers/trae.txt

@@ -1,11 +1,11 @@
----
-description: "项目编码规范（13 条标准 + 8 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
-globs: ["**/*.vue", "**/*.ts", "**/*.tsx", "**/*.js", "**/*.scss"]
-alwaysApply: true
----
-
-<!-- Trae Rules 规则。由 @agile-team/wl-skills-kit 自动生成。-->
-<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
-
----
-
+---
+description: "项目编码规范（13 条标准 + 8 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
+globs: ["**/*.vue", "**/*.ts", "**/*.tsx", "**/*.js", "**/*.scss"]
+alwaysApply: true
+---
+
+<!-- Trae Rules 规则。由 @agile-team/wl-skills-kit 自动生成。-->
+<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
+
+---
+

package/files/.github/skills/_compat/headers/windsurf.txt

@@ -1,7 +1,7 @@
-# Windsurf 项目编码规范（.windsurfrules）
-
-> 由 @agile-team/wl-skills-kit 自动生成。请勿手动编辑。
-> 更新方式：npx @agile-team/wl-skills-kit@latest update
-
----
-
+# Windsurf 项目编码规范（.windsurfrules）
+
+> 由 @agile-team/wl-skills-kit 自动生成。请勿手动编辑。
+> 更新方式：npx @agile-team/wl-skills-kit@latest update
+
+---
+

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

@@ -1,81 +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/
-│   └── permission-sync/  [PLANNED]
-│
-├── ops/                 运维/构建类
-│   └── code-fix/
-│
-└── 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        | ✅ 启用    | `skills/sync/dict-sync/SKILL.md`             | 同步字典 / 创建字典 / 刷新字典基线 / 字典对比 / 字典审计                           |
-| permission-sync  | ⏳ PLANNED | `skills/sync/permission-sync/SKILL.draft.md` | （草稿，不参与调度）                                                       |
-| code-fix         | ✅ 启用    | `skills/ops/code-fix/SKILL.md`               | 自动修复 / 整改偏差 / 修复报告 / 规范整改 / 修复偏差 / code fix               |
-
----
-
-## 调度规则
-
-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/` 目录） |
+# 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/
+│   └── permission-sync/  [PLANNED]
+│
+├── ops/                 运维/构建类
+│   └── code-fix/
+│
+└── 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        | ✅ 启用    | `skills/sync/dict-sync/SKILL.md`             | 同步字典 / 创建字典 / 刷新字典基线 / 字典对比 / 字典审计                           |
+| permission-sync  | ⏳ PLANNED | `skills/sync/permission-sync/SKILL.draft.md` | （草稿，不参与调度）                                                       |
+| code-fix         | ✅ 启用    | `skills/ops/code-fix/SKILL.md`               | 自动修复 / 整改偏差 / 修复报告 / 规范整改 / 修复偏差 / code fix               |
+
+---
+
+## 调度规则
+
+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/` 目录） |