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

package/files/{.github → .wl-skills}/guides/README.md

@@ -1,6 +1,6 @@
 # Guides 指南目录
 
-本目录下文档由 `wl-skills-kit` 安装到业务项目的 `.github/guides/`，作为团队成员人工维护的指南类文档。
+本目录下文档由 `wl-skills-kit` 安装到业务项目的 `.wl-skills/guides/`，作为团队成员人工维护的指南类文档。
 
 | 文件              | 内容                                           |
 | ----------------- | ---------------------------------------------- |

package/files/{.github → .wl-skills}/guides/architecture.md

@@ -2,7 +2,7 @@
 
 > **读者**：团队技术负责人 / wl-skills-kit 维护者 / 对体系设计感兴趣的团队成员
 > **更新方式**：重大架构变更后追加对应章节，旧章节原文保留（历史可溯）
-> **当前版本**：v2.10.0（2026-05-31）
+> **当前版本**：v2.11.0（2026-06-14）
 
 ---
 
@@ -135,16 +135,16 @@ AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae
   │   - Pre-flight 输出要求
   │
   ▼
-.github/skills/_registry.md
+.wl-skills/skills/_registry.md
   │ 触发词 → SKILL 路径映射
   │ "生成页面" → skills/core/page-codegen/SKILL.md
   │
   ▼
-.github/skills/core/page-codegen/SKILL.md
+.wl-skills/skills/core/page-codegen/SKILL.md
   │ 声明：必读 standards 列表 + 完整生成流程 + 输出规范
   │
   ▼
-.github/standards/（按 index.md 门控，按需加载）
+.wl-skills/standards/（按 index.md 门控，按需加载）
   │ page-codegen 需要：02/06/07/08/12/13 共 6 条
   │ convention-audit 需要：全部 13 条
   │
@@ -153,7 +153,7 @@ AI 生成代码/报告/api.md
   │
   └─ 写入到：
        src/views/<域>/<模块>/<子模块>/<page>/
-       .github/reports/（追加写入）
+       .wl-skills/reports/（追加写入）
 ```
 
 ---

package/files/{.github → .wl-skills}/guides/mcp-setup.md

@@ -95,7 +95,7 @@
 
 ## 配置完成后
 
-确保已在 `.github/skills/sync/env.local.json` 中填写：
+确保已在 `.wl-skills/skills/sync/env.local.json` 中填写：
 
 ```json
 {

package/files/{.github → .wl-skills}/guides/usage.md

@@ -63,12 +63,12 @@ AI 会自动识别意图，触发对应的 Skill。
 | `menu-sync`        | 创建菜单 / 同步菜单            | 菜单数据同步到后端（MCP 自动 / prompt 手动两种模式） |
 | `dict-sync`        | 同步字典 / 创建字典 / 字典审计 | 字典基线同步到后端（MCP 自动 / prompt 手动两种模式） |
 | `convention-audit` | 规范审计 / 代码审计            | 14 条规范扫描 + 偏差报告                             |
-| `business-doc-extract` | 语义级智能触发（无关键词列表） | 原型/详设/字段/字典/现有页面 → docs/business 业务文档 |
+| `business-doc-extract` | 语义级智能触发（无关键词列表） | 原型/详设/字段/字典/现有页面 → .wl-skills/docs/business 业务文档 |
 | `template-extract` | 提取模板 / 抄取模板            | 从现有页面沉淀领域专属模板                         |
 | `permission-sync`  | 创建角色 / 角色授权 / 同步权限 | 角色+授权+动作权限同步（MCP）                        |
 | `code-fix`         | 自动修复 / 整改偏差 / 规范整改 | 受控自动修复审计报告中的偏差                         |
 
-完整调度规则见 `.github/skills/_registry.md`。
+完整调度规则见 `.wl-skills/skills/_registry.md`。
 
 ---
 
@@ -84,8 +84,8 @@ AI 会自动识别意图，触发对应的 Skill。
 │   ├── skills/                      10 个启用 Skill + 多编辑器适配
 │   ├── guides/                      使用指南 + 架构设计
 │   └── reports/                     AI 生成报告（SYS_MENU_INFO 等）
-├── docs/                            12 个组件 API 文档（jh-* / request 等）
-├── demo/                            13 个领域样例（生产 + 销售）
+├── .wl-skills/docs/                            12 个组件 API 文档（jh-* / request 等）
+├── .wl-skills/templates/                            13 个领域样例（生产 + 销售）
 └── src/
     ├── components/                  全局/局部/远程组件
     └── types/
@@ -148,15 +148,15 @@ A: 不会。`bin/wl-skills.js` 已自动生成 9 种主流 AI 编辑器配置文
 **Q: MCP Server 是什么？需要额外配置吗？**
 A: `wl-skills init` 会自动为 **Cursor**（`.cursor/mcp.json`）、**Claude Code**（`.mcp.json`）、**VS Code / GitHub Copilot**（`.vscode/mcp.json`）、**Kiro**（`.kiro/settings/mcp.json`）生成项目级 MCP 配置文件。
 
-Windsurf、Cline、Trae、Qoder 仅支持全局配置，需手动操作一次，详见 `.github/guides/mcp-setup.md`。
+Windsurf、Cline、Trae、Qoder 仅支持全局配置，需手动操作一次，详见 `.wl-skills/guides/mcp-setup.md`。
 
-配置完成后在 `.github/skills/sync/env.local.json` 中填好 `token`、`gatewayPath`、`menu.domainId`，重启编辑器，对 AI 说「扩展菜单」或「加字典」，AI 会自动调用 MCP 工具完成同步，无需手动粘贴接口响应。
+配置完成后在 `.wl-skills/skills/sync/env.local.json` 中填好 `token`、`gatewayPath`、`menu.domainId`，重启编辑器，对 AI 说「扩展菜单」或「加字典」，AI 会自动调用 MCP 工具完成同步，无需手动粘贴接口响应。
 
 **Q: 如何和 wk-skills-ui 一起用？**
 A: 两个包不互相依赖。先用 `wl-skills-kit` 做页面生成、规范审计、菜单字典权限同步；如需统一 UI 风格或老系统化妆层，再单独安装 `@agile-team/wk-skills-ui` 并执行 `wk-ui init/update`。
 
 **Q: 部署到生产环境前如何清理 AI 文件？**
-A: 执行 `npx @agile-team/wl-skills-kit clean`。会移除所有 AI 辅助文件，保留 `src/components/` 和 `src/types/`。
+A: 执行 `npx @agile-team/wl-skills-kit clean`。会移除所有 AI 辅助文件，保留 `.wl-skills/src/components/` 和 `src/types/`。
 
 ---
 
@@ -218,4 +218,4 @@ npx @agile-team/wl-skills-kit clean --dry-run
 ## 进一步阅读
 
 - 架构与决策记录：[architecture.md](architecture.md)
-- 编辑器适配说明：`.github/skills/_compat/README.md`
+- 编辑器适配说明：`.wl-skills/skills/_compat/README.md`

package/files/{.github → .wl-skills}/reports/SYS_MENU_INFO.md

@@ -241,7 +241,7 @@ aiflow: [
 
 - 客户档案详情通过页内 `c_formModal` 弹窗查看；临时客户详情通过路由跳转 `mmwrCustomerDetail` 查看
 - 新增/编辑弹窗复用平台 `c_formModal` 组件
-- 客户申请新增与客户申请变更共享 `src/components/local/c_applyDetailDialog/index.vue` 详情弹窗
+- 客户申请新增与客户申请变更共享 `.wl-skills/src/components/local/c_applyDetailDialog/index.vue` 详情弹窗
 - 变更历史查询通过路由跳转 `mmwrCustomerApplyChangeHistory` 查看，入口在申请表单页工具栏
 - **显示排序**：目录排 `6`（接在实绩统计查询后面），菜单从 `1` 开始
 - **mmwr- 前缀**：生产棒线材模块下所有页面统一使用 `mmwr-` 前缀（kebab）/ `mmwr` 前缀（camelCase）

package/files/{.github → .wl-skills}/reports/SYS_PERMISSION_INFO.md

@@ -2,7 +2,7 @@
 
 > ⚠️ 本文件为 [PLANNED] 状态。等 `permission-sync` Skill 转正后启用。
 >
-> 设计草稿：`.github/skills/sync/permission-sync/SKILL.draft.md`
+> 设计草稿：`.wl-skills/skills/sync/permission-sync/SKILL.draft.md`
 
 ---
 

package/files/{.github → .wl-skills}/reports//347/273/204/344/273/266/346/217/220/345/217/226/345/273/272/350/256/256.md

@@ -21,7 +21,7 @@
 
 **评审建议**：
 
-- c_statusBadge：模式简单且高频，建议立即封装到 `src/components/local/c_statusBadge/`
+- c_statusBadge：模式简单且高频，建议立即封装到 `.wl-skills/src/components/local/c_statusBadge/`
 - c_priceFormat：建议先评估是否可用现有 `jh-text` + 格式化指令实现
 - c_addressInput：业务耦合度高，建议保持现状，1 年后再评估
 

package/files/{.github → .wl-skills}/skills/_best-practices.md

@@ -17,7 +17,7 @@
 | 2 | 涉及 **sync 类**（菜单/字典/权限）操作时，**必读** `skills/sync/_mcp-guardrail.md`，调用失败不绕开 MCP，按 guardrail §2 自愈剧本引导用户 |
 | 3 | 每个场景都允许「单步执行」或「流水线执行」两种方式，由用户决定 |
 | 4 | 写文件 / 调写接口 / 修改代码前，输出 Pre-flight 声明并等待用户确认 |
-| 5 | 报告类产物统一写入 `.github/reports/`，**追加不覆盖** |
+| 5 | 报告类产物统一写入 `.wl-skills/reports/`，**追加不覆盖** |
 
 ---
 
@@ -45,7 +45,7 @@ prototype-scan
 
 **关键检查点**：
 - pages.ts 是否注册了新页面（否则路由不存在）
-- `.github/reports/SYS_MENU_INFO.md` 是否包含本次新增页面
+- `.wl-skills/reports/SYS_MENU_INFO.md` 是否包含本次新增页面
 - 同步菜单后端 4004 / 401 → 走 guardrail 引导用户改 env.local.json
 
 ---
@@ -66,7 +66,7 @@ wls_menu_sync_from_report  ← MCP 工具，自动读报告 + 查菜单树 + 一
 ```
 
 **前置**：
-- `.github/reports/SYS_MENU_INFO.md` 已生成（由 page-codegen 产出，或手工维护）
+- `.wl-skills/reports/SYS_MENU_INFO.md` 已生成（由 page-codegen 产出，或手工维护）
 - `env.local.json` 配齐：gatewayPath / token（纯 JWT）/ sysAppNo / menu.parentMenuId / menu.domainId
 
 **典型故障 → 处理**：
@@ -91,7 +91,7 @@ wls_menu_sync_from_report  ← MCP 工具，自动读报告 + 查菜单树 + 一
 2. 扫 data.ts 收集所有 logicValue（DICT_CODE）
 3. 差集 = 待新建 → 用户确认
 4. 逐个调 wls_dict_upsert（含 module + items）
-5. 更新 .github/reports/SYS_DICT_INFO.md
+5. 更新 .wl-skills/reports/SYS_DICT_INFO.md
 ```
 
 **配置依赖**：env.local.json → `dict.moduleId`
@@ -125,22 +125,35 @@ wls_menu_sync_from_report  ← MCP 工具，自动读报告 + 查菜单树 + 一
 - "接手新项目"
 - "项目体检"
 - "规范审计"
+- "确认修复效果" / "复扫验证"
 
-**推荐流程**：
+**推荐流程（完整闭环）**：
 
 ```
 wls_code_scan          ← 概览：页面目录、API_CONFIG、文件完整性
   → convention-audit   ← 14 条规范全量扫描，产出 AUDIT_*.md
-  → code-fix（可选）   ← 自动修复可整改项
+  → code-fix           ← 自动修复可整改项（用户确认 diff 后写入）
+  → wl-skills validate ← ★ 强制复扫（自动执行，不等确认）
+  → 闭环确认           ← 0 error = 可提交；有残余 = 继续处理
 ```
 
+**闭环强制规则**：
+- code-fix 完成后必须自动执行 `wl-skills validate` 复扫
+- 复扫未通过时，提示用户继续修复或标记人工处理
+- 大规模修复后可另触发 `convention-audit --quick` 进行轻量级复扫
+
+**关键检查点**：
+- convention-audit 报告是否包含所有页面
+- code-fix 仅修 🟡🟢，🔴 必须人工或 page-codegen
+- 复扫通过后才可 git commit
+
 ---
 
 ## 6. 场景：仅 mock 跑通 / 后端没好先能跑
 
 **用户典型话术**："先 mock 一下"、"假数据"、"后端没好先能跑"
 
-**推荐**：`page-codegen` 的 mock-first 规则。Mock 架构详见 `docs/mock-architecture.md`。
+**推荐**：`page-codegen` 的 mock-first 规则。Mock 架构详见 `.wl-skills/docs/mock-architecture.md`。
 
 ```
 mock/

package/files/{.github → .wl-skills}/skills/_compat/README.md

@@ -107,4 +107,4 @@ bin/wl-skills.js (init/update)
 | 通用 Agent     | `AGENTS.md` (root)                     | ❌                   | 新兴跨平台规范                   |
 | Qoder          | `.qoder/rules/conventions.md`          | ✅                   | 项目规则文件                     |
 
-> 所有这些编辑器在加载完根配置后，**都支持按指令读取项目内任意文件**（含 `.github/standards/`、`.github/skills/`、`.github/guides/`），所以本架构的"懒加载门控 + 子目录规范"对所有编辑器**有效**。
+> 所有这些编辑器在加载完根配置后，**都支持按指令读取项目内任意文件**（含 `.wl-skills/standards/`、`.wl-skills/skills/`、`.wl-skills/guides/`），所以本架构的"懒加载门控 + 子目录规范"对所有编辑器**有效**。

package/files/{.github → .wl-skills}/skills/_compat/editors.json

@@ -7,7 +7,7 @@
       "headerFile": "github-copilot.txt",
       "outputPath": ".github/copilot-instructions.md",
       "enabled": true,
-      "_note": "Copilot 唯一识别 .github/ 的编辑器。该文件实际就是 files/.github/copilot-instructions.md 直接复制，不加 header。"
+      "_note": "Copilot 唯一识别 .github/ 的编辑器。v2.11+ 薄壳入口，引导 AI 读取 .wl-skills/copilot-instructions-full.md 完整地图。"
     },
     {
       "name": "claude-code",

package/files/{.github → .wl-skills}/skills/_compat/headers/cursor-mdc.txt

@@ -1,5 +1,5 @@
 ---
-description: "项目编码规范（13 条标准 + 11 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
+description: "项目编码规范（14 条标准 + 11 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
 globs:
   - "**/*.vue"
   - "**/*.ts"

package/files/{.github → .wl-skills}/skills/_compat/headers/kiro.txt

@@ -1,6 +1,6 @@
 ---
 inclusion: always
-description: 项目编码规范（13 条标准 + 11 个 Skill 自动调度）
+description: 项目编码规范（14 条标准 + 11 个 Skill 自动调度）
 ---
 
 <!-- Kiro Steering 规则。由 @agile-team/wl-skills-kit 自动生成。-->

package/files/{.github → .wl-skills}/skills/_compat/headers/trae.txt

@@ -1,5 +1,5 @@
 ---
-description: "项目编码规范（13  条标准 + 11 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
+description: "项目编码规范（14 条标准 + 11 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
 globs: ["**/*.vue", "**/*.ts", "**/*.tsx", "**/*.js", "**/*.scss"]
 alwaysApply: true
 ---

package/files/{.github → .wl-skills}/skills/_pipeline.md

@@ -2,6 +2,7 @@
 
 > 本文件定义 Skill 间的输入/输出契约和推荐后续动作，是 Agent Pipeline 的调度依据。
 > Pipeline 只做**建议式串联**：AI 完成一步后提示下一步，是否继续由用户确认。
+> **例外**：code-fix → validate 复扫是**强制约定**，不需要用户确认即自动执行。
 
 ---
 
@@ -52,16 +53,16 @@ spec-doc-parse                       // 规范线：wl-skills-design 标准说
 
 | Skill | input_from | output_file | next_suggest |
 |---|---|---|---|
-| `prototype-scan` | 原型/非规范详设/口述需求 | `.github/reports/PROTOTYPE_SCAN_*.md` | `business-doc-extract`（资料达模块级）或 `api-contract` |
-| `spec-doc-parse` | wl-skills-design 标准说明书（`docs/spec/{项目代号}/ch1-3.md` + `4.x-*.md` + `4.N-data-report.md`） | `.github/reports/SPEC_PARSE_*.md`（含 page-spec JSON + 解析报告） | `api-contract`（处理完阻断/待确认项后） |
-| `business-doc-extract` | 已发布原型目录 / 详设 / 字段实体 / 字典资料 / 现有页面 + `api.md` / `prototype-scan` 输出 | `docs/business/index.md` + `docs/business/open-questions.md` + `docs/business/0X-xx/{index,requirement,dictionary,field}.md` | `api-contract` 或 `page-codegen`（项目需求依据） |
-| `api-contract` | `prototype-scan` 输出、`spec-doc-parse` 输出、`docs/business/0X-xx/requirement.md` + `field.md` 或用户口述接口信息 | `src/views/**/api.md` | `page-codegen` |
-| `page-codegen` | `api.md` / page-spec / 用户口述需求 | `src/views/**/{index.vue,data.ts,index.scss,api.md}` + `.github/reports/SYS_MENU_INFO.md` | `convention-audit`；如有菜单则 `menu-sync` |
-| `convention-audit` | 任意源码目录或文件；`--mode spec-align` 时额外入 `spec-doc-parse` 的 page-spec / 说明书 | `.github/reports/AUDIT_*.md`；`--mode spec-align` 输出 `SPEC_GAP_*.md` | 有可自动修复项时 `code-fix`；有菜单/字典/权限差异时对应 sync Skill |
-| `code-fix` | `convention-audit` 报告 | 源码 diff / 修复摘要 | `convention-audit` 复扫 |
-| `menu-sync` | `.github/reports/SYS_MENU_INFO.md` | 后端菜单数据 + 同步摘要 | `permission-sync`（如需角色授权/动作） |
-| `dict-sync` | `.github/reports/SYS_DICT_INFO.md` | 后端字典数据 + 同步摘要 | `convention-audit` 复扫（如页面依赖字典） |
-| `permission-sync` | `.github/reports/SYS_PERMISSION_INFO.md` 或用户口述权限需求 | 后端角色/授权/动作数据 + 同步摘要 | `convention-audit` 复扫权限码使用 |
+| `prototype-scan` | 原型/非规范详设/口述需求 | `.wl-skills/reports/PROTOTYPE_SCAN_*.md` | `business-doc-extract`（资料达模块级）或 `api-contract` |
+| `spec-doc-parse` | wl-skills-design 标准说明书（`.wl-skills/docs/spec/{项目代号}/ch1-3.md` + `4.x-*.md` + `4.N-data-report.md`） | `.wl-skills/reports/SPEC_PARSE_*.md`（含 page-spec JSON + 解析报告） | `api-contract`（处理完阻断/待确认项后） |
+| `business-doc-extract` | 已发布原型目录 / 详设 / 字段实体 / 字典资料 / 现有页面 + `api.md` / `prototype-scan` 输出 | `.wl-skills/docs/business/index.md` + `.wl-skills/docs/business/open-questions.md` + `.wl-skills/docs/business/0X-xx/{index,requirement,dictionary,field}.md` | `api-contract` 或 `page-codegen`（项目需求依据） |
+| `api-contract` | `prototype-scan` 输出、`spec-doc-parse` 输出、`.wl-skills/docs/business/0X-xx/requirement.md` + `field.md` 或用户口述接口信息 | `src/views/**/api.md` | `page-codegen` |
+| `page-codegen` | `api.md` / page-spec / 用户口述需求 | `src/views/**/{index.vue,data.ts,index.scss,api.md}` + `.wl-skills/reports/SYS_MENU_INFO.md` | `convention-audit`；如有菜单则 `menu-sync` |
+| `convention-audit` | 任意源码目录或文件；`--mode spec-align` 时额外入 `spec-doc-parse` 的 page-spec / 说明书 | `.wl-skills/reports/AUDIT_*.md`；`--mode spec-align` 输出 `SPEC_GAP_*.md` | 有可自动修复项时 `code-fix`；有菜单/字典/权限差异时对应 sync Skill |
+| `code-fix` | `convention-audit` 报告 | 源码 diff / 修复摘要 | **强制** `wl-skills validate` 复扫（自动执行，不等确认）；可选 `convention-audit --quick` |
+| `menu-sync` | `.wl-skills/reports/SYS_MENU_INFO.md` | 后端菜单数据 + 同步摘要 | `permission-sync`（如需角色授权/动作） |
+| `dict-sync` | `.wl-skills/reports/SYS_DICT_INFO.md` | 后端字典数据 + 同步摘要 | `convention-audit` 复扫（如页面依赖字典） |
+| `permission-sync` | `.wl-skills/reports/SYS_PERMISSION_INFO.md` 或用户口述权限需求 | 后端角色/授权/动作数据 + 同步摘要 | `convention-audit` 复扫权限码使用 |
 | `template-extract` | 成熟页面目录 | `templates/domains/**/TPL-*.md` 或模板草案 | `page-codegen` 复用新模板 |
 
 ---
@@ -75,13 +76,24 @@ AI 每完成一个 Skill，必须输出：
 - 产物：{output_file}
 - 关键数据：{counts / changed files / backend ids}
 - 风险：{manual review items}
+- 复扫结果：{code-fix 专属，其他 Skill 可省略}
 
 ## 建议下一步
 - next_suggest：{skill-name}
 - 原因：{why}
-- 是否需要用户确认：是
+- 是否需要用户确认：是 / 否（code-fix 复扫为"否"，自动执行）
 ```
 
+### 强制执行 vs 建议执行
+
+| 步骤 | 类型 | 说明 |
+|------|------|------|
+| code-fix → wl-skills validate | **强制** | 修复后自动复扫，不等用户确认 |
+| code-fix → convention-audit --quick | **建议** | 大规模修复后推荐 |
+| page-codegen → convention-audit | **建议** | 生成后建议审计 |
+| convention-audit → code-fix | **建议** | 有可修复项时推荐 |
+| 其他所有 next_suggest | **建议** | 用户确认后执行 |
+
 ---
 
 ## 5. MCP/CLI 辅助能力

package/files/{.github → .wl-skills}/skills/_registry.md

@@ -43,7 +43,7 @@ skills/
 | Skill 名         | 状态    | 路径                                    | MCP 工具依赖                                                                                                              | 触发关键词                                                                                                                              |
 | ---------------- | ------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
 | prototype-scan   | ✅ 启用 | `skills/core/prototype-scan/SKILL.md`   | —                                                                                                                          | 扫描原型 / 解析原型 / 页面清单 / 口述需求 / 建个页面 / 写个页面 / 根据截图 / 根据原型（**非规范零散详设**）                              |
-| spec-doc-parse   | ✅ 启用 | `skills/core/spec-doc-parse/SKILL.md`   | —                                                                                                                          | 解析说明书 / 解析需求文档 / 规范文档转页面 / 根据说明书生成 / IPO 转页面 / 功能编码 / docs/spec（**wl-skills-design 标准说明书**）       |
+| spec-doc-parse   | ✅ 启用 | `skills/core/spec-doc-parse/SKILL.md`   | —                                                                                                                          | 解析说明书 / 解析需求文档 / 规范文档转页面 / 根据说明书生成 / IPO 转页面 / 功能编码 / .wl-skills/docs/spec（**wl-skills-design 标准说明书**）       |
 | api-contract     | ✅ 启用 | `skills/core/api-contract/SKILL.md`     | —                                                                                                                          | 接口约定 / api.md / 字段定义 / 前后端对齐 / 接口设计                                                                                    |
 | page-codegen     | ✅ 启用 | `skills/core/page-codegen/SKILL.md`     | `wls_validate_page` / `wls_doctor_ui`                                                                                      | 生成页面 / 创建页面 / 代码生成 / vue页面 / 按原型生成 / 帮我生成 / 列表页 / 管理页 / 台账 / mock / 假数据 / 先能跑 / AGGrid / skills-ui |
 | convention-audit | ✅ 启用 | `skills/core/convention-audit/SKILL.md` | `wls_code_scan` / `wls_audit_report_push`                                                                                  | 规范审计 / 代码审计 / 规范检查 / 对齐规范 / 规范偏差 / 接手新项目 / 存量代码分析 / 项目体检                                             |
@@ -60,7 +60,7 @@ skills/
 
 ## 调度规则
 
-0. **优先级 0（最高）— 双线隔离**：若用户输入路径含 `docs/spec/`，或文档含功能编码 `/[A-Z]{2,6}[0-9]{3}/` / IPO 表「处理逻辑」/ 流程五要素，**强制路由 `spec-doc-parse`（规范线）**，跳过 `prototype-scan` 的所有模式匹配。反之，Axure HTML / 截图 / 口述 / 非规范零散详设走 `prototype-scan`（原型线）。两线最终汇聚到同一份 page-spec JSON。
+0. **优先级 0（最高）— 双线隔离**：若用户输入路径含 `.wl-skills/docs/spec/`，或文档含功能编码 `/[A-Z]{2,6}[0-9]{3}/` / IPO 表「处理逻辑」/ 流程五要素，**强制路由 `spec-doc-parse`（规范线）**，跳过 `prototype-scan` 的所有模式匹配。反之，Axure HTML / 截图 / 口述 / 非规范零散详设走 `prototype-scan`（原型线）。两线最终汇聚到同一份 page-spec JSON。
 1. **首先加载** `_best-practices.md`（场景索引，语义级路由依据），结合用户意图判断属于哪个场景
 2. 按场景指向的 Skill，`read_file` 加载对应 SKILL.md
 3. SKILL.md 中标注的 `必读 standards` 按 `standards/index.md` 任务类型映射加载
@@ -68,8 +68,14 @@ skills/
 5. 如用户表达连续交付/智能体/全流程意图，同时读取 `_pipeline.md` 获取 Skill I/O 与 `next_suggest`
 6. 在 SKILL.md 指示下输出 **Pre-flight 声明**（强制约定式输出）
 7. 页面生成任务必须额外读取 `standards/12-base-table.md`，并执行 `BaseTable + render-type="agGrid" + cid + defineColumns + renderOps` 硬约束
-8. 若消息包含"风格 / skills-ui / 状态标签 / 操作列 / AGGrid"，同时建议运行 `wl-skills doctor-ui`
-9. `business-doc-extract` 不依赖关键词匹配，AI 必须按 `资料源 + 意图 + 范围` 三因素自行判断；缺资料时先询问用户提供原型/详设/字段资料路径，不要凭推断写入 `docs/business`
+8. 若消息包含“风格 / skills-ui / 状态标签 / 操作列 / AGGrid”，同时建议运行 `wl-skills doctor-ui`
+9. `business-doc-extract` 不依赖关键词匹配，AI 必须按 `资料源 + 意图 + 范围` 三因素自行判断；缺资料时先询问用户提供原型/详设/字段资料路径，不要凭推断写入 `.wl-skills/docs/business`
+10. **闭环强制约定**：code-fix 完成后必须自动执行 `wl-skills validate` 复扫，不等待用户确认
+11. **高风险 Skill 确认机制**：以下 Skill 触发前必须二次确认用户意图（输出“即将执行 XX，确认继续？”）：
+    - `page-codegen`（会创建/覆盖文件）
+    - `menu-sync` / `dict-sync` / `permission-sync`（会调用后端接口写数据）
+    - `code-fix`（会修改源码）
+12. **误触发防护**：当用户消息同时匹配 2+ Skill 且非明确流水线意图时，必须先输出“检测到多个可能的 Skill，您的意图是？”并列出候选，而不是自行决定
 
 ---
 

package/files/{.github → .wl-skills}/skills/core/business-doc-extract/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: business-doc-extract
-description: "Use when: 用户提供原型目录（如已发布的 Axure HTML 文件夹）、详设/需求文档、字段或字典资料、已有页面目录等业务资料，并希望沉淀业务理解、对齐产品/后端、维护字段字典或维护待确认事项。Skill 不依赖固定关键词，依据资料源 + 用户意图 + 范围完整度智能判断；碎片化问答、单截图、小修小改默认不触发。Triggers on (语义级，仅作示例): 业务梳理 / 业务文档 / docs/business / 模块大纲 / 字段字典整理 / 待确认事项 / 产品确认 / 业务全景 / 原型转业务文档 / 详设转业务文档 / 业务闭环。"
+description: "Use when: 用户提供原型目录（如已发布的 Axure HTML 文件夹）、详设/需求文档、字段或字典资料、已有页面目录等业务资料，并希望沉淀业务理解、对齐产品/后端、维护字段字典或维护待确认事项。Skill 不依赖固定关键词，依据资料源 + 用户意图 + 范围完整度智能判断；碎片化问答、单截图、小修小改默认不触发。Triggers on (语义级，仅作示例): 业务梳理 / 业务文档 / .wl-skills/docs/business / 模块大纲 / 字段字典整理 / 待确认事项 / 产品确认 / 业务全景 / 原型转业务文档 / 详设转业务文档 / 业务闭环。"
 ---
 
 # Skill: 业务文档抽取（business-doc-extract）
 
-把 **原型 / 详设 / 字段字典 / 现有代码 / api.md / mock** 等业务资料沉淀为 **`docs/business`** 下的业务理解文档，作为 `api-contract` 和 `page-codegen` 的高质量输入，同时支撑产品/后端/前端的业务确认闭环。
+把 **原型 / 详设 / 字段字典 / 现有代码 / api.md / mock** 等业务资料沉淀为 **`.wl-skills/docs/business`** 下的业务理解文档，作为 `api-contract` 和 `page-codegen` 的高质量输入，同时支撑产品/后端/前端的业务确认闭环。
 
 > **核心理念**：固化但不僵化。本 Skill 不依赖死关键词；只在用户给出可识别的业务资料源、且范围达到模块/项目级时才会建议生成；碎片化任务默认不污染业务文档。
 
@@ -27,18 +27,18 @@ description: "Use when: 用户提供原型目录（如已发布的 Axure HTML
    - 在生成代码前先和产品/后端确认
 3. **范围识别**：资料覆盖范围是否达到模块级或项目级。
 
-满足“资料源 + 意图 + 范围”三者，才进入本 Skill 的生成态。否则只输出对话级的业务理解片段，**不写入 `docs/business`**。
+满足“资料源 + 意图 + 范围”三者，才进入本 Skill 的生成态。否则只输出对话级的业务理解片段，**不写入 `.wl-skills/docs/business`**。
 
 ---
 
 ## 2. 决策矩阵
 
-| 场景 | 默认行为 | 是否写入 `docs/business` |
+| 场景 | 默认行为 | 是否写入 `.wl-skills/docs/business` |
 |---|---|---|
 | 用户明确说“生成业务文档 / 梳理业务 / 沉淀模块” | 进入生成态，给出计划，确认后写入 | 是（需确认） |
 | 提供完整原型目录、完整详设、模块级页面集 | 建议生成 + 给出计划 | 否，先建议；用户确认后再写 |
 | 提供字段表 / 字典表，目标是更新字段字典 | 进入增量更新态 | 是（仅更新对应模块的 `field.md` / `dictionary.md`，其他不动） |
-| 已有 `docs/business`，用户提交新增需求 | 进入增量维护态 | 是（仅追加/更新涉及模块） |
+| 已有 `.wl-skills/docs/business`，用户提交新增需求 | 进入增量维护态 | 是（仅追加/更新涉及模块） |
 | 单页面口述需求 / 单截图 | 不触发本 Skill | 否（仅输出页面理解、`api.md` 草案、必要时 preview） |
 | 小修小改、报错调试、样式调整 | 不触发本 Skill | 否 |
 | 用户要求 “先 mock 能跑” | 不阻塞 page-codegen | 否（保持轻量路径） |
@@ -52,7 +52,7 @@ description: "Use when: 用户提供原型目录（如已发布的 Axure HTML
 ### 3.1 模块级（推荐，最常用）
 
 ```text
-docs/business/
+.wl-skills/docs/business/
 ├── index.md                         # 业务全景 + 模块索引 + 实现状态
 ├── open-questions.md                # 全局待确认问题汇总
 └── 0X-<module-kebab>/
@@ -68,8 +68,8 @@ docs/business/
 
 | 文件 | 职责 | 不放什么 |
 |---|---|---|
-| `docs/business/index.md` | 项目业务定位、一级模块总览、产品目录 ↔ 代码目录映射、整体实现状态、链接 | 详细需求、字段、字典 |
-| `docs/business/open-questions.md` | 跨模块待确认问题汇总表 | 模块内详细规则 |
+| `.wl-skills/docs/business/index.md` | 项目业务定位、一级模块总览、产品目录 ↔ 代码目录映射、整体实现状态、链接 | 详细需求、字段、字典 |
+| `.wl-skills/docs/business/open-questions.md` | 跨模块待确认问题汇总表 | 模块内详细规则 |
 | `0X-xx/index.md` | 模块定位、子功能清单、页面与 `api.md` 链接、模块链路摘要 | 详细需求与字段 |
 | `0X-xx/requirement.md` | 需求来源、业务目标、角色、功能范围、流程图、页面清单、业务规则、异常规则、**模块待确认** | 字典/字段大表 |
 | `0X-xx/dictionary.md` | 模块涉及字典 / 枚举 / 状态 | 与字典无关的字段 |
@@ -89,7 +89,7 @@ docs/business/
 |---|---|---|
 | `preview` | 仅在对话中输出业务理解、待确认点、推荐结构 | 否 |
 | `module` | 生成或增量更新单个 `0X-xx/` 模块文档 | 是（需用户确认） |
-| `project` | 生成或刷新 `docs/business/index.md` + `open-questions.md` 全局总览 | 是（需用户确认） |
+| `project` | 生成或刷新 `.wl-skills/docs/business/index.md` + `open-questions.md` 全局总览 | 是（需用户确认） |
 | `incremental` | 基于字段表 / 字典表 / 新需求局部增量更新已有模块文档 | 是（需用户确认） |
 
 > Skill 不要求显式传入模式；AI 应根据资料源和意图自动判断，并在 Pre-flight 中说明。
@@ -104,7 +104,7 @@ docs/business/
 ✅ 已判断范围：{preview / module / project / incremental}
 ✅ 已读取 standards/index.md       → 任务类型 D（参考结构与组件合规）
 ✅ 已读取 _pipeline.md              → 与 prototype-scan / api-contract / page-codegen 的衔接关系
-✅ 计划落盘：{是/否}，目标路径：{docs/business/...}
+✅ 计划落盘：{是/否}，目标路径：{.wl-skills/docs/business/...}
 ⚠ 涉及写文件：是/否；需要用户确认：是/否
 ```
 
@@ -134,25 +134,25 @@ docs/business/
    - `requirement.md`
    - `dictionary.md`
    - `field.md`
-4. 更新 `docs/business/index.md`：补充模块行、状态、链接。
-5. 更新 `docs/business/open-questions.md`：把模块 `requirement.md` 底部的待确认事项汇总到全局表，标注来源文件。
+4. 更新 `.wl-skills/docs/business/index.md`：补充模块行、状态、链接。
+5. 更新 `.wl-skills/docs/business/open-questions.md`：把模块 `requirement.md` 底部的待确认事项汇总到全局表，标注来源文件。
 6. 输出完成摘要 + `next_suggest`。
 
 ### 6.2 增量更新
 
-1. 检测 `docs/business` 已存在哪些模块。
+1. 检测 `.wl-skills/docs/business` 已存在哪些模块。
 2. 对应模块若已存在 `dictionary.md` / `field.md`：
    - 仅追加新增项，并标注 `新增` 或 `更新`。
    - 已废弃项标 `已废弃`，不直接删除。
 3. 对应模块若不存在：
    - 询问归属，确认后再创建模块目录。
-4. 同步刷新 `docs/business/index.md` 与 `open-questions.md`。
+4. 同步刷新 `.wl-skills/docs/business/index.md` 与 `open-questions.md`。
 
 ### 6.3 项目级刷新
 
-1. 重新扫描 `docs/business/0X-*`，重建：
-   - `docs/business/index.md` 模块表
-   - `docs/business/open-questions.md` 汇总表
+1. 重新扫描 `.wl-skills/docs/business/0X-*`，重建：
+   - `.wl-skills/docs/business/index.md` 模块表
+   - `.wl-skills/docs/business/open-questions.md` 汇总表
 2. 不删除模块文件本身。
 3. 给出本次新增 / 状态变更 / 已废弃模块清单。
 
@@ -164,8 +164,8 @@ docs/business/
 
 | 模板 | 路径 | 适用 |
 |---|---|---|
-| 项目业务全景 | `templates/business-index.md` | `docs/business/index.md` |
-| 全局待确认 | `templates/business-open-questions.md` | `docs/business/open-questions.md` |
+| 项目业务全景 | `templates/business-index.md` | `.wl-skills/docs/business/index.md` |
+| 全局待确认 | `templates/business-open-questions.md` | `.wl-skills/docs/business/open-questions.md` |
 | 模块全景 | `templates/module-index.md` | `0X-xx/index.md` |
 | 模块需求理解 | `templates/module-requirement.md` | `0X-xx/requirement.md` |
 | 模块字典 | `templates/module-dictionary.md` | `0X-xx/dictionary.md` |
@@ -199,12 +199,12 @@ docs/business/
 - 模式：preview / module / project / incremental
 - 资料源：{文件或目录列表}
 - 输出：
-  - docs/business/index.md（更新行：N）
-  - docs/business/open-questions.md（新增问题：N）
-  - docs/business/0X-xx/index.md
-  - docs/business/0X-xx/requirement.md
-  - docs/business/0X-xx/dictionary.md
-  - docs/business/0X-xx/field.md
+  - .wl-skills/docs/business/index.md（更新行：N）
+  - .wl-skills/docs/business/open-questions.md（新增问题：N）
+  - .wl-skills/docs/business/0X-xx/index.md
+  - .wl-skills/docs/business/0X-xx/requirement.md
+  - .wl-skills/docs/business/0X-xx/dictionary.md
+  - .wl-skills/docs/business/0X-xx/field.md
 - 风险：{产品需确认 N 项 / 后端需确认 N 项}
 
 ## 建议下一步
@@ -218,10 +218,10 @@ docs/business/
 ## 10. 边界与约束
 
 - **不替代页面级 `api.md`**：详细接口契约仍写在页面目录的 `api.md`，模块 `index.md` 只放链接。
-- **不写非业务文档**：本 Skill 不维护 `README.md`、`docs/agent-pipeline-runbook.md`、`docs/mcp-tool-risk-matrix.md`、`docs/全盘分析与智能体搭建指南.md`。
+- **不写非业务文档**：本 Skill 不维护 `README.md`、`.wl-skills/docs/agent-pipeline-runbook.md`、`.wl-skills/docs/mcp-tool-risk-matrix.md`、`.wl-skills/docs/全盘分析与智能体搭建指南.md`。
 - **不自动确认产品 / 后端问题**：所有 “待确认事项” 必须保留并汇总到 `open-questions.md`。
 - **不删除既有事实条目**：仅做追加 / 标注 `已废弃`。
-- **不污染碎片场景**：单截图、小修小改、口述简单页面默认不写 `docs/business`。
+- **不污染碎片场景**：单截图、小修小改、口述简单页面默认不写 `.wl-skills/docs/business`。
 - **不引入新关键词列表**：触发完全依赖资料源 + 意图 + 范围；不要在外部文件维护“关键词清单 → 触发”表。
 
 ---