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

package/files/.wl-skills/copilot-instructions-full.md

@@ -0,0 +1,233 @@
+# 产品化前端编码指令（完整地图）
+
+> 本文件是 wl-skills-kit 的**完整自包含指令文件**。AI 读完本文件即可知道：系统有什么、怎么触发、核心规则是什么、执行时去哪取详细内容。
+> **不需要追链读取其他文件来了解全貌。** 仅在执行具体 Skill 时才按路径读取详细定义。
+
+---
+
+## 一、架构
+
+- Vue 3.2 + Vite + TypeScript（strict: false）
+- Module Federation **子应用**，路由/权限/布局/Store 从主应用 `main` 远程加载
+- UI：Element Plus + @jhlc/jh-ui + @jhlc/common-core
+- 样式：Windi CSS + SCSS
+- 状态：Pinia
+- 页面注册：`vite/plugins/shared/pages.ts` 通过 `gProd()` / `gSale()` 声明
+- 菜单路由配置：后端菜单表是唯一数据源。pages.ts 注册组件后，需在系统管理后台 → 菜单管理 → 新增菜单。批量新增页面时可用后端 batchImport 接口
+
+## 二、页面标准结构（三文件分离 + 接口契约）
+
+```
+src/views/[域]/[模块]/[子模块]/[kebab-case目录]/
+├── index.vue    ← 纯模板+解构，不写业务逻辑
+├── data.ts      ← AbstractPageQueryHook 类 + API_CONFIG
+├── index.scss   ← 页面样式（可为空）
+└── api.md       ← 接口约定（前端预留 + 后端出接口依据）
+```
+
+弹窗组件处理策略：
+
+- **通用弹窗**（新增/编辑表单，2+ 页面可复用）→ 提取到 `.wl-skills/src/components/local/c_xxxModal/`
+- **极个性弹窗**（仅单页面使用，c_modal 无法满足）→ 放在页面 `components/xxxModal.vue`
+
+## 三、data.ts 核心模式
+
+- 继承 `AbstractPageQueryHook`，实现 `queryDef()` / `columnsDef()`
+- `API_CONFIG` 定义接口路径，与 `api.md` 一一对应
+- `API_CONFIG` 中禁止出现 `import axios`，只能用 `getAction` / `postAction`
+- `data.ts` 中禁止 `import Store`（Pinia Store 在组件层使用）
+
+## 四、页面模板硬约束
+
+生成业务表格时，必须同时满足：
+
+- 使用 `AbstractPageQueryHook + BaseQuery + BaseToolbar + BaseTable + jh-pagination`
+- `BaseTable` 显式 `render-type="agGrid"`
+- `BaseTable` 绑定全局唯一 `cid` / `:cid`
+- 列定义使用 `@agile-team/wk-skills-ui/runtime` 的 `defineColumns()`
+- 操作列使用 `renderOps()`，禁止 `operations: []`
+- 保留 `common-core` 平台骨架，不得生搬硬套 `wk-skills-ui` 通用模板里的 `usePageHook/el-form/el-pagination`
+- 生成后建议运行 `wl-skills validate-page <页面目录>` 和 `wl-skills doctor-ui`
+
+## 五、Mock 架构（与页面完全解耦）
+
+- **开关**：`.env.dev` 中 `ENV_MOCK=true/false`
+- **解耦**：mock 文件放在项目根 `mock/` 目录，不在 `src/views` 中 import 任何 mock
+- **URL 对齐**：`API_CONFIG` 保持真实路径，mock 端点带 `/dev-api` 前缀，关闭 mock 后无需改页面代码
+- **按模块自治**：删某业务 mock 只删对应文件，不影响其他模块
+- **一键清理**：`wl-skills mock-clean --domain [域]` 或 `--all`
+
+---
+
+## 六、Skill 完整路由表
+
+> 读完本表即知全部可用 Skill、触发词和读取路径。无需再去查其他文件。
+
+| 触发词 | Skill 名 | 读取路径 |
+|--------|---------|---------|
+| 扫描原型 / 解析原型 / 页面清单 / 口述需求 / 建个页面 / 根据截图 / 根据原型（非规范零散详设） | prototype-scan | `.wl-skills/skills/core/prototype-scan/SKILL.md` |
+| 解析说明书 / 规范文档转页面 / IPO 转页面 / 功能编码 / .wl-skills/docs/spec（wl-skills-design 标准说明书） | spec-doc-parse | `.wl-skills/skills/core/spec-doc-parse/SKILL.md` |
+| 接口约定 / api.md / 字段定义 / 前后端对齐 | api-contract | `.wl-skills/skills/core/api-contract/SKILL.md` |
+| 生成页面 / 创建页面 / 代码生成 / vue页面 / 列表页 / 管理页 / 台账 / mock / 假数据 | page-codegen | `.wl-skills/skills/core/page-codegen/SKILL.md` |
+| 规范审计 / 代码审计 / 规范检查 / 对齐规范 / 接手新项目 / 项目体检 | convention-audit | `.wl-skills/skills/core/convention-audit/SKILL.md` |
+| 用户提供原型/详设/字段资料，意图为业务梳理/模块沉淀 | business-doc-extract | `.wl-skills/skills/core/business-doc-extract/SKILL.md` |
+| 提取模板 / 沉淀模板 | template-extract | `.wl-skills/skills/core/template-extract/SKILL.md` |
+| 创建菜单 / 同步菜单 / 补菜单 / 页面点击进不来 | menu-sync | `.wl-skills/skills/sync/menu-sync/SKILL.md` |
+| 同步字典 / 创建字典 / 字典对比 / 字典审计 | dict-sync | `.wl-skills/skills/sync/dict-sync/SKILL.md` |
+| 创建角色 / 角色授权 / 挂动作 / 同步权限 / 权限码注册 | permission-sync | `.wl-skills/skills/sync/permission-sync/SKILL.md` |
+| 自动修复 / 整改偏差 / 修复报告 / 规范整改 / code fix | code-fix | `.wl-skills/skills/ops/code-fix/SKILL.md` |
+
+**执行规则**：
+1. 用户消息匹配上表触发词 → 用 `read_file` 加载对应 SKILL.md
+2. SKILL.md 中标注的"必读 standards"按本文件第七节映射加载
+3. 在 SKILL.md 指示下输出 **Pre-flight 声明**（强制）
+
+### 调度规则（强制）
+
+1. 首先匹配上表触发词，结合 `_best-practices.md` 场景索引判断用户意图
+2. 双线隔离：输入含 `.wl-skills/docs/spec/` / 功能编码 / IPO 表 → 强制路由 `spec-doc-parse`，禁止 `prototype-scan` 接管
+3. 匹配 2+ Skill 时必须列出候选并询问用户意图（误触发防护）
+4. `page-codegen` / `menu-sync` / `dict-sync` / `permission-sync` / `code-fix` 触发前二次确认
+5. `code-fix` 完成后必须自动 `wl-skills validate` 复扫（闭环强制）
+6. sync 类任务必须额外加载 `.wl-skills/skills/sync/_mcp-guardrail.md`
+
+---
+
+## 七、规范完整清单与路径
+
+> 14 条编码规范。执行代码生成或修改前，按任务类型映射加载对应规范。
+
+| 编号 | 规范名 | 读取路径 |
+|------|--------|---------|
+| 01 | 工具链就绪 | `.wl-skills/standards/01-toolchain.md` |
+| 02 | 三文件分离 + 接口契约 | `.wl-skills/standards/02-code-structure.md` |
+| 03 | 注释规范 | `.wl-skills/standards/03-comments.md` |
+| 04 | 基础编码（13 条） | `.wl-skills/standards/04-coding-basics.md` |
+| 05 | console 残留 | `.wl-skills/standards/05-logging.md` |
+| 06 | 安全规范 | `.wl-skills/standards/06-security.md` |
+| 07 | 配置管理 | `.wl-skills/standards/07-config.md` |
+| 08 | Git 规范 | `.wl-skills/standards/08-git.md` |
+| 09 | TypeScript | `.wl-skills/standards/09-typescript.md` |
+| 10 | Pinia | `.wl-skills/standards/10-pinia.md` |
+| 11 | 表单校验 | `.wl-skills/standards/11-form-validation.md` |
+| 12 | BaseTable + cid | `.wl-skills/standards/12-base-table.md` |
+| 13 | 平台组件合规 | `.wl-skills/standards/13-platform-components.md` |
+| 14 | 布局容器 | `.wl-skills/standards/14-layout-containers.md` |
+
+任务类型 → 必读规范映射以 `.wl-skills/standards/index.md` 为唯一数据源。执行前先 `read_file` 加载确认。
+
+---
+
+## 八、场景速查
+
+| # | 场景 | 推荐流程 |
+|---|------|---------|
+| 1 | 新建模块完整闭环 | prototype-scan → api-contract → page-codegen → menu-sync → convention-audit |
+| 2 | 补菜单 | menu-sync（MCP: wls_menu_sync_from_report） |
+| 3 | 补字典 | dict-sync |
+| 4 | 角色授权 / 加动作 | permission-sync |
+| 5 | 存量项目体检 | convention-audit → code-fix → validate 复扫 → 闭环确认 |
+| 6 | mock 跑通 | page-codegen mock-first |
+| 7 | 模板沉淀 | template-extract |
+| 8 | 业务文档维护 | business-doc-extract |
+| 9 | Git 提交 | pnpm cz / wl-skills validate |
+| 10 | 规范线闭环 | spec-doc-parse → api-contract → page-codegen → convention-audit --mode spec-align |
+
+---
+
+## 九、文档与模板路径
+
+| 类型 | 路径 |
+|------|------|
+| 平台组件文档（jh-select 等） | `.wl-skills/.wl-skills/docs/jh-{name}.md` |
+| 组件 README（BaseTable 等） | `.wl-skills/.wl-skills/src/components/remote/{Name}/README.md` |
+| 局部组件 README | `.wl-skills/.wl-skills/src/components/local/{c_xxx}/README.md` |
+| 页面模板 | `.wl-skills/templates/` |
+| 使用指南 | `.wl-skills/guides/usage.md` |
+| 架构设计 | `.wl-skills/guides/architecture.md` |
+| MCP 配置 | `.wl-skills/guides/mcp-setup.md` |
+| 审计报告 | `.wl-skills/reports/` |
+| 场景索引 | `.wl-skills/skills/_best-practices.md` |
+| I/O 契约 | `.wl-skills/skills/_pipeline.md` |
+
+---
+
+## 十、绝对禁止规则
+
+- ❌ index.vue 中写业务逻辑（逻辑全在 data.ts）
+- ❌ 使用 Vuex（用 Pinia）
+- ❌ `::v-deep` / `/deep/`（用 `:deep()`）
+- ❌ 直接用 axios（用 getAction/postAction）
+- ❌ 手写查询表单/工具栏/分页（用 BaseQuery/BaseToolbar/jh-pagination）
+- ❌ 每个页面重复写弹窗组件（优先用 `c_modal` 等局部公共组件）
+- ❌ 不在 index.vue 写业务逻辑 | 新加的方法/状态必须放在 data.ts
+- ❌ 不直接用 axios / getAction / sessionStorage | 这些只能出现在 data.ts
+- ❌ 不用 el-table / el-form 替代平台组件 | 用 BaseTable / BaseForm
+- ❌ 不引入新依赖不经团队确认 | 需在 PR 中说明理由
+- ✅ 改完即验证 | 触发 `wls_validate_page` 或 `wl-skills validate`
+- ✅ git cz 提交 | pre-commit 会自动检测规范，error 级别阻断提交
+
+**提交即验证**：`.husky/pre-commit` 自动运行 `wl-skills validate --pre-commit`，error 阻断提交。
+**CI 兜底**：`wl-skills validate --strict` 会再次拦截，error 和 warn 都导致 CI 失败。
+
+### 豁免标记
+
+```vue
+<!-- wl-skills:ignore R3 -->
+<el-table :data="dialogData">...</el-table>
+```
+
+- 必须带规则编号（R1~R12），精确豁免，不支持全局豁免
+- CI `--strict` 模式下豁免标记仍然生效
+
+---
+
+## 十一、AI 执行护栏（强制约定）
+
+以下规则对所有 AI 助手在本项目中执行任务时**强制生效**，不可被用户口头覆盖。
+
+### 1. 闭环强制约定
+
+| 触发场景 | 强制动作 | 不可跳过原因 |
+|----------|----------|-------------|
+| code-fix 执行完毕 | 自动执行 `wl-skills validate` 复扫 | 确保修复未引入新偏差 |
+| 复扫发现新问题 | 继续修复 → 再次复扫，直到通过 | 闭环不允许断开 |
+| 用户说"不用验证了" | **仍然执行**复扫，只是不再追问 | 规范高于口头指令 |
+
+### 2. 高风险 Skill 确认机制
+
+以下 Skill 触发前必须向用户**二次确认**，不可静默执行：
+
+- `page-codegen`（生成整页代码，不可逆）
+- `menu-sync` / `dict-sync` / `permission-sync`（跨系统同步，影响后端数据）
+- `code-fix`（批量修改源码文件，需确认范围）
+
+确认话术：`即将执行 [Skill名称]，影响范围：[文件列表 / 后端数据类型] 是否继续？(Y/n)`
+
+### 3. 误触发防护
+
+| 情况 | 处理方式 |
+|------|----------|
+| 用户意图匹配 2+ Skill | 必须列出候选并询问用户意图 |
+| 用户意图模糊无法映射 | 询问澄清，不猜测执行 |
+| 仅匹配 1 个 Skill 且置信度高 | 直接执行，无需确认 |
+
+### 4. Pre-flight 声明完整性
+
+AI 在执行任何 Skill 前必须输出：
+
+```
+📋 Pre-flight:
+- Skill: [skill-name]
+- 触发依据: [用户原话 / 管道上游输出]
+- 影响文件: [文件列表]
+- 预期结果: [一句话描述]
+```
+
+### 5. 修复建议输出规范
+
+当 `wl-skills validate` 阻断时，AI 必须：
+1. 完整展示阻断项（error + strict 模式下的 warn）
+2. 对每项给出**具体修复建议**（而非泛泛的"请修复"）
+3. 标注是否可自动修复（auto: true/false）
+4. 引导用户触发修复流程：`规范审计 → 自动修复 → 复扫验证`

package/files/{docs → .wl-skills/docs}/jh-pagination.md

@@ -436,7 +436,7 @@ const { page, select } = Page;
 
 ### 示例 1：内贸订单列表页
 
-**路径**: `src/views/sale/demo/domestic-trade-order/index.vue`
+**路径**: `src/views/sale/.wl-skills/templates/domestic-trade-order/index.vue`
 
 ```vue
 <jh-pagination
@@ -451,7 +451,7 @@ const { page, select } = Page;
 
 ### 示例 2：新增编辑页项次分页
 
-**路径**: `src/views/sale/demo/add-demo/index.vue`
+**路径**: `src/views/sale/.wl-skills/templates/add-.wl-skills/templates/index.vue`
 
 ```vue
 <jh-pagination

package/files/{docs → .wl-skills/docs}/page-query-hook-best-practices.md

@@ -163,9 +163,9 @@ class LadleUseQueryHook extends AbstractPageQueryHook {
 ```typescript
 import { AbstractPageQueryHook } from "@jhlc/common-core";
 import { BusLogicDataType } from "@jhlc/types/src/logical-data";
-import { BaseQueryItemDesc } from "@jhlc/common-core/src/components/form/base-query/type";
-import { TableColumnDesc } from "@jhlc/common-core/src/components/table/base-table/type";
-import { ActionButtonDesc } from "@jhlc/common-core/src/components/toolbar/type";
+import { BaseQueryItemDesc } from "@jhlc/common-core/.wl-skills/src/components/form/base-query/type";
+import { TableColumnDesc } from "@jhlc/common-core/.wl-skills/src/components/table/base-table/type";
+import { ActionButtonDesc } from "@jhlc/common-core/.wl-skills/src/components/toolbar/type";
 
 const API_CONFIG = {
   list: "/mmsm/mmsmRsltLadleUse/list",

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.1（2026-06-14）
+> **当前版本**：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`
@@ -153,7 +153,7 @@ wls_code_scan          ← 概览：页面目录、API_CONFIG、文件完整性
 
 **用户典型话术**："先 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/_pipeline.md

@@ -53,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 |
+| `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` | `.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` 复扫权限码使用 |
+| `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` 复用新模板 |
 
 ---

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` 任务类型映射加载
@@ -69,7 +69,7 @@ skills/
 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`
+9. `business-doc-extract` 不依赖关键词匹配，AI 必须按 `资料源 + 意图 + 范围` 三因素自行判断；缺资料时先询问用户提供原型/详设/字段资料路径，不要凭推断写入 `.wl-skills/docs/business`
 10. **闭环强制约定**：code-fix 完成后必须自动执行 `wl-skills validate` 复扫，不等待用户确认
 11. **高风险 Skill 确认机制**：以下 Skill 触发前必须二次确认用户意图（输出“即将执行 XX，确认继续？”）：
     - `page-codegen`（会创建/覆盖文件）