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

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

@@ -10,7 +10,7 @@
 把零散的业务资料（已发布原型、详设、字段表、字典表、现有页面）沉淀为：
 
 ```text
-docs/business/
+.wl-skills/docs/business/
 ├── index.md                # 项目业务全景 + 模块索引
 ├── open-questions.md       # 全局待确认问题汇总
 └── 01-xxx/                 # 模块文档
@@ -41,7 +41,7 @@ docs/business/
 2. 资料范围达到模块或项目级（不是单页面/单截图）。
 3. 你的目标是“梳理业务 / 沉淀文档 / 整理字段字典 / 确认待确认事项”。
 
-> 单页面口述、单截图、改样式、修 bug 等碎片化任务，**默认不会写 `docs/business`**，避免污染。
+> 单页面口述、单截图、改样式、修 bug 等碎片化任务，**默认不会写 `.wl-skills/docs/business`**，避免污染。
 
 ---
 
@@ -50,10 +50,10 @@ docs/business/
 下面这些自然表达 AI 会自动判断走 business-doc-extract：
 
 ```
-帮我梳理 docs/prototypes/客户管理 这个原型，按业务文档结构沉淀。
-基于 docs/spec/主数据需求.md 把模块文档生成出来，再聊页面。
-我把字段实体放在 字段/ 目录，帮我把模块字典和字段同步进 docs/business。
-现有 src/views/mdata 已经写完了，回过头帮我生成 docs/business 业务文档。
+帮我梳理 .wl-skills/docs/prototypes/客户管理 这个原型，按业务文档结构沉淀。
+基于 .wl-skills/docs/spec/主数据需求.md 把模块文档生成出来，再聊页面。
+我把字段实体放在 字段/ 目录，帮我把模块字典和字段同步进 .wl-skills/docs/business。
+现有 src/views/mdata 已经写完了，回过头帮我生成 .wl-skills/docs/business 业务文档。
 ```
 
 下面这些不会触发：
@@ -72,8 +72,8 @@ docs/business/
 
 ```
 你：
-docs/prototypes/客户管理/ 已发布的 Axure 原型在这里，
-请按业务文档最佳实践沉淀，目标是 docs/business/01-customer。
+.wl-skills/docs/prototypes/客户管理/ 已发布的 Axure 原型在这里，
+请按业务文档最佳实践沉淀，目标是 .wl-skills/docs/business/01-customer。
 
 AI：
 [识别资料源 → 输出 Pre-flight → 给出生成计划 → 等待你确认]
@@ -82,12 +82,12 @@ AI：
 确认后产物：
 
 ```text
-docs/business/index.md
-docs/business/open-questions.md
-docs/business/01-customer/index.md
-docs/business/01-customer/requirement.md
-docs/business/01-customer/dictionary.md
-docs/business/01-customer/field.md
+.wl-skills/docs/business/index.md
+.wl-skills/docs/business/open-questions.md
+.wl-skills/docs/business/01-customer/index.md
+.wl-skills/docs/business/01-customer/requirement.md
+.wl-skills/docs/business/01-customer/dictionary.md
+.wl-skills/docs/business/01-customer/field.md
 ```
 
 ### 4.2 增量补字段或字典
@@ -95,7 +95,7 @@ docs/business/01-customer/field.md
 ```
 你：
 后端补了 6 个字段，资料在 字段/MdmModelAttribute.md，
-帮我合并进 docs/business/01-model/field.md。
+帮我合并进 .wl-skills/docs/business/01-model/field.md。
 
 AI：
 [读取字段表 → 仅更新 field.md，新增标注“新增”或“更新”]
@@ -108,7 +108,7 @@ AI：
 ```
 你：
 src/views/mdata 已经全部写完了，但没有业务文档，
-帮我反向沉淀 docs/business 模块文档，标出待确认事项。
+帮我反向沉淀 .wl-skills/docs/business 模块文档，标出待确认事项。
 
 AI：
 [扫描 src/views + api.md + mock + 字段资料]
@@ -133,7 +133,7 @@ src/views/mdata/model/mdata-model-config/api.md
 | 主数据模型配置 | src/views/mdata/model/mdata-model-config | src/views/mdata/model/mdata-model-config/api.md |
 ```
 
-不在 `docs/business` 里重复维护接口字段。
+不在 `.wl-skills/docs/business` 里重复维护接口字段。
 
 ---
 
@@ -141,8 +141,8 @@ src/views/mdata/model/mdata-model-config/api.md
 
 | 文件 | 给谁看 | 何时更新 |
 |---|---|---|
-| `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` | 模块 owner | 模块结构有调整时 |
 | `0X-xx/requirement.md` | 业务侧 + 实施侧 | 需求确认 / 流程调整 |
 | `0X-xx/dictionary.md` | 后端字典 + 前端 dict | 字典 code 确认 / 新增 |
@@ -154,7 +154,7 @@ src/views/mdata/model/mdata-model-config/api.md
 
 | 现象 | 原因 | 解法 |
 |---|---|---|
-| AI 把单页面口述写进了 `docs/business` | 资料源不足却被强制走 | 检查是否提供了模块级资料；只是做单页时直接走 page-codegen |
+| AI 把单页面口述写进了 `.wl-skills/docs/business` | 资料源不足却被强制走 | 检查是否提供了模块级资料；只是做单页时直接走 page-codegen |
 | 生成的字段表里有“推断字段”污染真实事实 | 资料缺失 | 让 AI 把推断字段全部标注 `待确认`，不要直接合并到 field.md 主表 |
 | open-questions 越来越多 | 没有定期与产品对齐 | 周会上集中确认后，把已确认项移除并在 requirement.md 落地业务规则 |
 | 模块目录命名混乱 | 没有按 `0X-` 顺序前缀 | 强制要求 `01-`、`02-`，与产品一级目录一致 |
@@ -163,8 +163,8 @@ src/views/mdata/model/mdata-model-config/api.md
 
 ## 8. FAQ
 
-**Q：小项目也要 `docs/business` 吗？**
-A：不强求。小项目可以把业务全景写在 README，不需要拆成 `docs/business`。本 Skill 不会主动给小项目写。
+**Q：小项目也要 `.wl-skills/docs/business` 吗？**
+A：不强求。小项目可以把业务全景写在 README，不需要拆成 `.wl-skills/docs/business`。本 Skill 不会主动给小项目写。
 
 **Q：原型目录必须发布成 HTML 吗？**
 A：推荐已发布的 Axure HTML，AI 可以读取具体页面。其他形式（pdf / docx / 截图集）也支持，但识别精度下降。

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

@@ -1,5 +1,5 @@
 <!--
-模板：docs/business/index.md（项目业务全景）
+模板：.wl-skills/docs/business/index.md（项目业务全景）
 使用：business-doc-extract Skill 在 project / module 模式下生成或刷新此文件。
 约束：表格中的页面数量 / 状态需基于真实资料填充，禁止凭空推断。
 -->

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

@@ -1,5 +1,5 @@
 <!--
-模板：docs/business/open-questions.md（全局待确认事项汇总）
+模板：.wl-skills/docs/business/open-questions.md（全局待确认事项汇总）
 使用：business-doc-extract Skill 在每次生成或更新模块 requirement.md 后，把模块底部的待确认事项汇总到本文件。
 约束：仅做汇总和索引；模块内详细规则不在此处展开。
 -->

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

@@ -1,5 +1,5 @@
 <!--
-模板：docs/business/0X-xxx/dictionary.md（模块字典枚举）
+模板：.wl-skills/docs/business/0X-xxx/dictionary.md（模块字典枚举）
 使用：business-doc-extract Skill 在 module / incremental 模式下生成或更新。
 约束：仅维护本模块涉及的字典 / 枚举 / 状态；跨模块共享的字典需在备注列说明。
      字典 code 推断未确认时，必须在 `状态` 列标 `待确认`，确认前不写入业务代码。

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

@@ -1,5 +1,5 @@
 <!--
-模板：docs/business/0X-xxx/field.md（模块字段清单）
+模板：.wl-skills/docs/business/0X-xxx/field.md（模块字段清单）
 使用：business-doc-extract Skill 在 module / incremental 模式下生成或更新。
 约束：以业务字段为主，配合后端实体、前端 data.ts、api.md 多端对齐。
      字段类型未确认时必须标 `待确认`，禁止凭推断写入。

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

@@ -1,5 +1,5 @@
 <!--
-模板：docs/business/0X-xxx/index.md（模块全景）
+模板：.wl-skills/docs/business/0X-xxx/index.md（模块全景）
 使用：business-doc-extract Skill 在 module 模式下生成或刷新。
 约束：仅放“模块定位 + 子功能清单 + 页面/API 索引 + 模块链路摘要”。
      详细需求 / 字段 / 字典放在 requirement.md / field.md / dictionary.md。
@@ -8,7 +8,7 @@
 # {{ModuleName}}
 
 > **代码目录**：`src/views/{{module-path}}`
-> **文档目录**：`docs/business/0X-{{module-kebab}}/`
+> **文档目录**：`.wl-skills/docs/business/0X-{{module-kebab}}/`
 > **最近更新**：{{UpdatedAt}}
 
 ---

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

@@ -1,5 +1,5 @@
 <!--
-模板：docs/business/0X-xxx/requirement.md（模块需求理解）
+模板：.wl-skills/docs/business/0X-xxx/requirement.md（模块需求理解）
 使用：business-doc-extract Skill 在 module / incremental 模式下生成或更新。
 约束：流程图、页面清单、模块待确认事项都放在本文件，不再单独建 flow.md / pages.md / open-questions.md。
      全局 open-questions.md 由 Skill 汇总，不在本文件维护汇总表。
@@ -86,7 +86,7 @@ flowchart TD
 
 ## 9. 模块待确认事项
 
-> 仅维护本模块的待确认事项；全局视图见 `docs/business/open-questions.md`。
+> 仅维护本模块的待确认事项；全局视图见 `.wl-skills/docs/business/open-questions.md`。
 
 | 编号 | 问题 | 影响 | 建议确认人 | 优先级 | 状态 |
 |---|---|---|---|---|---|

package/files/{.github → .wl-skills}/skills/core/convention-audit/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: convention-audit
-description: "Use when: auditing project source code against the 14 modular standards in .github/standards/. Outputs deviation report and component-extraction suggestions to reports/. Triggers on: 规范审计, 规范检查, 代码审计, 对齐规范, 规范偏差, 接手新项目, 存量代码分析, 项目体检, audit code, check conventions, onboard project."
+description: "Use when: auditing project source code against the 14 modular standards in .wl-skills/standards/. Outputs deviation report and component-extraction suggestions to reports/. Triggers on: 规范审计, 规范检查, 代码审计, 对齐规范, 规范偏差, 接手新项目, 存量代码分析, 项目体检, audit code, check conventions, onboard project."
 ---
 
 # Skill: 规范审计（convention-audit）v2
 
-以 `.github/standards/` 14 条规范为唯一基线，扫描项目源码，输出**偏差报告**和**组件提取建议**到 `reports/` 目录。
+以 `.wl-skills/standards/` 14 条规范为唯一基线，扫描项目源码，输出**偏差报告**和**组件提取建议**到 `reports/` 目录。
 
 > **核心理念**：审查全覆盖、结果强量化、规则场景化、新增严格 + 存量渐进。
 > 本 Skill 只负责发现偏差并给出整改建议，**不自动修复**（修复由 code-fix Skill 完成）。
@@ -45,6 +45,51 @@ description: "Use when: auditing project source code against the 14 modular stan
 
 ---
 
+## 复扫模式（--quick，v2.11+ 新增）
+
+> 闭环专用：code-fix 修复后快速验证，不做全量 14 条扫描，仅复查上次报告中的 🔴🟡 项。
+
+### 触发方式
+
+```
+复扫验证 / 复扫上次审计 / convention-audit --quick / 确认修复效果
+```
+
+### 执行逻辑
+
+1. 读取 `reports/规范审查报告.md` 最新章节中的 🔴🟡 偏差清单
+2. **仅对这些偏差涉及的文件**重新检测（不扫描全项目）
+3. 对比上次报告数据，输出变化矩阵
+4. 追加复扫结果到报告
+
+### 复扫报告格式
+
+```markdown
+## 🔄 复扫 {YYYY-MM-DD HH:mm} | 触发：code-fix 后自动复扫
+
+| 指标 | 修复前 | 修复后 | 变化 |
+|---|---:|---:|---|
+| 🔴 严重 | {N} | {N} | {-N} ✅ |
+| 🟡 警告 | {N} | {N} | {-N} ✅ |
+| 未解决 | - | {N} | 待处理 |
+
+### 结论
+- ✔ 闭环完成，可提交
+- 或：✖ 仍有 {N} 个未解决项，建议继续处理
+```
+
+### 与全量审计的区别
+
+| | 全量审计 | --quick 复扫 |
+|---|---|---|
+| 规范覆盖 | 14 条全部 | 仅上次报告中的偏差项 |
+| 扫描范围 | 指定目录或全项目 | 仅偏差涉及文件 |
+| token 消耗 | 高 | 低（约全量的 10%） |
+| 适用场景 | 首次体检/定期审计 | code-fix 后闭环验证 |
+| 输出 | 完整报告 12 章 | 复扫对比矩阵 |
+
+---
+
 ## 审计范围（14 条规范全覆盖）
 
 ### 审计方式分层
@@ -83,8 +128,8 @@ description: "Use when: auditing project source code against the 14 modular stan
 | 目录 | 规则强度 | 说明 |
 |---|---|---|
 | `src/views/**` | 最严格 | 业务页面，全规范覆盖 |
-| `src/components/local/**` | 中等 | 业务封装组件，检查复用性和命名 |
-| `src/components/**`（基础/历史） | 宽松 | 不套页面三文件原则；内部使用 el-* 需单独评审 |
+| `.wl-skills/src/components/local/**` | 中等 | 业务封装组件，检查复用性和命名 |
+| `.wl-skills/src/components/**`（基础/历史） | 宽松 | 不套页面三文件原则；内部使用 el-* 需单独评审 |
 
 ---
 
@@ -110,7 +155,7 @@ description: "Use when: auditing project source code against the 14 modular stan
 
 ### 步骤 2：加载规范基线 + 工具链检测
 
-1. 读取 `standards/01 ~ 13` 全部规范文件
+1. 读取 `standards/01 ~ 14` 全部规范文件
 2. 检测工具链状态：
    - ESLint：是否可执行
    - TypeScript：`tsc --noEmit` 是否可执行
@@ -389,7 +434,7 @@ description: "Use when: auditing project source code against the 14 modular stan
 ### 触发
 
 ```
-审计 {页面目录} --mode spec-align --spec docs/spec/{项目代号}/4.x-{子模块}.md
+审计 {页面目录} --mode spec-align --spec .wl-skills/docs/spec/{项目代号}/4.x-{子模块}.md
 ```
 或自然语言：「检查 {页面} 是否跟说明书对齐」。
 
@@ -409,7 +454,7 @@ description: "Use when: auditing project source code against the 14 modular stan
 ```markdown
 # Spec 对齐 GAP 报告
 - 生成时间：{YYYY-MM-DD HH:mm}
-- spec 来源：docs/spec/{项目代号}/4.x-{子模块}.md
+- spec 来源：.wl-skills/docs/spec/{项目代号}/4.x-{子模块}.md
 - 代码范围：src/views/.../{页面}/
 
 ## GAP 摘要

package/files/{.github → .wl-skills}/skills/core/convention-audit/USAGE.md

@@ -96,4 +96,4 @@ A：单个偏差可以让 AI 修，但**不要让它批量自动改**。建议
 A：AI 报告冗长（含每行修复建议），人读摘要简洁（只看趋势/优先级）。两者读者不同。
 
 **Q：自定义规范怎么加？**
-A：往 `.github/standards/` 加一份 `*.md`，更新 `standards/index.md`，convention-audit 自动 pickup。
+A：往 `.wl-skills/standards/` 加一份 `*.md`，更新 `standards/index.md`，convention-audit 自动 pickup。

package/files/{.github → .wl-skills}/skills/core/page-codegen/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: page-codegen
-description: "Use when: generating complete Vue 3 page code (index.vue + data.ts + modal components + api.md + pages.ts registration) from a prototype page inventory and API contract, strictly following the cx-ui-produce project conventions. Read SKILL.md first (rules+constraints), then read the matching TPL-*.md for the template code. Triggers on: generate page, create page, code generation, 生成页面, 页面代码, 代码生成, vue页面, 按原型生成, 口述需求, 建个页面, 写个页面, 帮我生成, natural language page generation."
+description: "Use when: generating complete Vue 3 page code (index.vue + data.ts + modal components + api.md + pages.ts registration) from a prototype page inventory and API contract, strictly following the cx-ui-produce project conventions. Read SKILL.md first (rules+constraints), then read the matching TPL-*.md for the template code. Triggers on: generate page, create page, code generation, 生成页面, 页面代码, 代码生成, vue页面, 帮我生成, natural language page generation. NOTE: 口述需求/建个页面/写个页面/按原型生成 belong to prototype-scan first (page-codegen chains from it via 模式 0)."
 ---
 
 # Skill: 页面代码生成（page-codegen）
@@ -20,7 +20,7 @@ description: "Use when: generating complete Vue 3 page code (index.vue + data.ts
 ✅ 已读取 standards/12-base-table.md         → AGGrid必用 + cid命名规范
 ✅ 已读取 standards/13-platform-components.md → 平台组件对照表 + docs前置读取清单
 ✅ 已读取 standards/14-layout-containers.md   → 布局容器（禁用 C_Splitter，必须用 jh-drag-row/jh-drag-col）
-✅ 已读取 docs/{涉及的jh-*文档}              → 当前页涉及组件的使用规范
+✅ 已读取 .wl-skills/docs/{涉及的jh-*文档}              → 当前页涉及组件的使用规范
 ✅ 工具链检测：.prettierrc.js ✓  eslint.config.ts ✓  .husky/ ✓  [全部就绪]
 ✅ cid 已生成：{value}（{首字母缩写说明}）
 ```
@@ -45,14 +45,34 @@ description: "Use when: generating complete Vue 3 page code (index.vue + data.ts
 ✅ src/views/.../{页面}/api.md
 ✅ reports/SYS_MENU_INFO.md  → 已追加菜单条目
 ────────────────────────────────────────────────
+🔍 强制自检（不可跳过）：
+   wl-skills validate src/views/{生成的页面目录}
+   → 结果：{0 error / N warn} 或列出 error 待修复
+────────────────────────────────────────────────
 📌 后续步骤：
    1. 在 router/pages.ts 注册路由
    2. 若本页 hiddenMenu=true → 在 src/util/navigate-hidden.ts 的 HIDDEN_ROUTE_MAP 追加一行
-   3. 提交：git cz（禁止直接 git commit）
-   4. 可选：触发 convention-audit 扫描本次生成文件
+   3. 提交：git cz（禁止直接 git commit，pre-commit 会自动检测规范）
 ────────────────────────────────────────────────
 ```
 
+### 生成后强制自检（不可跳过，不可标记为"可选"）
+
+> **v2.10.0+ 硬约束**：生成页面代码后，AI **必须**立即执行规范自检，不可跳过。
+
+1. **调用 MCP 工具** `wls_validate_page`，path 参数为**本次生成的页面目录**（精确到具体页面，不传 src/views 全局）
+2. 如有 **error**：
+   - 仅修复**本次生成的文件**中的 error（index.vue / data.ts / index.scss / api.md）
+   - 如 error 来自同目录下的**旧文件**（非本次生成），不要修改，在摘要中标注"已跳过 N 个旧文件 error"
+   - 修复后重新自检直到本次生成的文件 0 error
+3. 如有 **warn** → 尝试修复，确实无法修复的在摘要中说明原因
+4. 自检结果（error 数 / warn 数 / 跳过的旧文件数）写入上方"生成完成摘要"
+5. 自检范围为本次生成的**单个页面目录**，不对无关页面负责
+
+> 这条规则确保 AI 不会"写完就跑"——生成和验证形成闭环。
+> **作用域隔离原则**：AI 只对自己本次生成的文件负责，不强制修复历史遗留偏差。
+> git commit 时 pre-commit hook 会再次拦截，但 AI 应在生成阶段就消除本次生成的 error。
+
 ---
 
 ## 前置检查
@@ -86,14 +106,14 @@ src/views/[域]/[模块]/[子模块]/[kebab-case-目录名]/
 
 弹窗组件处理策略：
 
-- **通用弹窗**（新增/编辑表单，2+ 页面可复用）→ 提取到 `src/components/local/c_xxxModal/`
+- **通用弹窗**（新增/编辑表单，2+ 页面可复用）→ 提取到 `.wl-skills/src/components/local/c_xxxModal/`
 - **极个性弹窗**（仅单页面使用，c_modal 无法满足）→ 放在页面 `components/xxxModal.vue`
 
 附加输出：
 
 - `pages.ts` 注册片段
 - **`reports/SYS_MENU_INFO.md`** — 集中式菜单配置，**追加写入**（见下方 §SYS_MENU_INFO 生成规则）
-- `mock/[业务域]/[模块].ts`（项目根目录 `mock/` 下按域分目录，`vite-plugin-mock` 自动加载，与 api.md 的 URL 和字段完全一致；详见 `docs/mock-architecture.md`）
+- `mock/[业务域]/[模块].ts`（项目根目录 `mock/` 下按域分目录，`vite-plugin-mock` 自动加载，与 api.md 的 URL 和字段完全一致；详见 `.wl-skills/docs/mock-architecture.md`）
 
 ---
 
@@ -133,7 +153,7 @@ src/views/[域]/[模块]/[子模块]/[kebab-case-目录名]/
 
 ### 禁止事项（严格遵守）
 
-1. **❌ 禁止手写弹窗**：不可在页面 `components/` 下用 `el-dialog` + `el-form` + `el-row/col` 手写弹窗。必须使用 `c_formModal`（`src/components/local/c_formModal/`），通过 `modalConfig` 配置驱动。**例外**：纯只读详情弹窗（`jh-dialog` + `BaseForm :disabled="true"`）可不用 `c_formModal`，如工艺参数查看（参考 mmwr-process-parameters）
+1. **❌ 禁止手写弹窗**：不可在页面 `components/` 下用 `el-dialog` + `el-form` + `el-row/col` 手写弹窗。必须使用 `c_formModal`（`.wl-skills/src/components/local/c_formModal/`），通过 `modalConfig` 配置驱动。**例外**：纯只读详情弹窗（`jh-dialog` + `BaseForm :disabled="true"`）可不用 `c_formModal`，如工艺参数查看（参考 mmwr-process-parameters）
 2. **❌ 禁止在弹窗中使用原生 Element Plus 组件**：不可使用 `el-select`、`el-input`、`el-date-picker` 等原生组件，必须使用 `jh-select`、`jh-date`、`jh-user-picker` 等平台组件（通过 `BaseFormItemDesc` 的 `component` 属性配置）
 3. **❌ 禁止在 BaseToolbar 内使用 slot**：`BaseToolbar` 组件**不支持任何 slot**（源码中无 `<slot>` 标签），放入的内容会被丢弃不渲染。Tab/视角切换等额外 UI 必须放在 BaseToolbar **外部**
 4. **❌ 禁止用 el-radio-group 做 Tab/视角切换**：所有 Tab 式切换（视角切换、数据过滤 Tab、功能 Tab）**必须使用 `el-tabs`**（参考 `mmwr-steel-stripping-operations`）。不可用 `el-radio-group` + 手动 `handleViewChange` / `handleTabChange`
@@ -146,7 +166,7 @@ src/views/[域]/[模块]/[子模块]/[kebab-case-目录名]/
 11. **❌ 禁止表单控件宽度不统一**：`jh-select`、`jh-date`、`el-input-number`、`jh-file-upload` 默认宽度可能与 `el-input` 不一致，必须在 scoped style 中用 `:deep()` 统一设为 `width: 100%`（详见 §表单页 UI 细节规范）
 12. **❌ 禁止表单页无滚动**：独立路由表单页内容超出视口时必须可滚动，`.app-page-container` 须设 `overflow-y: auto`（**不要加 `height: 100%`，全局已有 `height: calc(100vh - 100px)`，叠加会导致双滚动条**）
 13. **❌ 禁止内联 style 散落**：所有页面/组件样式统一写在 `index.scss` 中（便于复用和移动），不可在 template 中大量使用内联 `style="..."`
-14. **❌ 禁止生成无 mock 的页面**：只写 `API_CONFIG` 但不写 `mock/[业务域]/*.ts` 属于生成失败。mock 文件必须按域分目录、import `_utils` 共享工具（详见 `docs/mock-architecture.md`）。
+14. **❌ 禁止生成无 mock 的页面**：只写 `API_CONFIG` 但不写 `mock/[业务域]/*.ts` 属于生成失败。mock 文件必须按域分目录、import `_utils` 共享工具（详见 `.wl-skills/docs/mock-architecture.md`）。
 15. **❌ 禁止生成空 onClick**：`onClick: () => {}` 属于生成失败；未知逻辑也必须用 `ElMessage.info(...)` 明示。
 16. **❌ 禁止忽略 wk-skills-ui**：项目已安装 `@agile-team/wk-skills-ui` 时，不使用 `defineColumns/renderOps` 属于生成失败。
 17. **❌ 禁止 BaseTable 非 AGGrid**：业务列表中 `<BaseTable>` 未写 `render-type="agGrid"` 或缺少 `cid/:cid` 属于生成失败。
@@ -154,13 +174,13 @@ src/views/[域]/[模块]/[子模块]/[kebab-case-目录名]/
 
 ### c_formModal 使用规范
 
-> 项目已有 `src/components/local/c_formModal/` 通用表单弹窗组件，支持 add/edit/view 三模式。
+> 项目已有 `.wl-skills/src/components/local/c_formModal/` 通用表单弹窗组件，支持 add/edit/view 三模式。
 > 所有标准 CRUD 弹窗**必须使用此组件**，不可重复编写。
 
 **data.ts 中定义 modalConfig：**
 
 ```typescript
-import type { BaseFormItemDesc } from "@jhlc/common-core/src/components/form/common/type";
+import type { BaseFormItemDesc } from "@jhlc/common-core/.wl-skills/src/components/form/common/type";
 
 export const modalConfig = {
   titlePrefix: "客户",       // 标题前缀：新增客户 / 编辑客户 / 查看客户
@@ -895,7 +915,7 @@ import {
 
 // ❌ 错误：直接从 common-core 深层路径导入
 import { AbstractPageQueryHook } from "@jhlc/common-core/src/page-hooks/page-query-hook.ts";
-import { BaseQueryItemDesc } from "@jhlc/common-core/src/components/form/base-query/type.ts";
+import { BaseQueryItemDesc } from "@jhlc/common-core/.wl-skills/src/components/form/base-query/type.ts";
 ```
 
 | 导出名                   | 说明                       |
@@ -907,7 +927,7 @@ import { BaseQueryItemDesc } from "@jhlc/common-core/src/components/form/base-qu
 | `BusLogicDataType`       | 业务逻辑类型枚举（如 dict）|
 
 > **例外**：`BaseFormItemDesc`（弹窗表单字段类型）仍直接从 common-core 导入：
-> `import type { BaseFormItemDesc } from "@jhlc/common-core/src/components/form/common/type";`
+> `import type { BaseFormItemDesc } from "@jhlc/common-core/.wl-skills/src/components/form/common/type";`
 > 因为 `src/types/page.ts` 当前未导出该类型。
 
 ---
@@ -983,7 +1003,7 @@ export default list;
 # 系统菜单配置 — [项目名] [业务模块]
 
 > **module 命名**：`[module]`
-> **父级菜单**：来自 `.github/skills/sync/env.local.json` 的 `menu.parentMenuId`
+> **父级菜单**：来自 `.wl-skills/skills/sync/env.local.json` 的 `menu.parentMenuId`
 
 ## 一级目录（type=M）
 

package/files/{.github → .wl-skills}/skills/core/page-codegen/USAGE.md

@@ -66,7 +66,7 @@ src/views/<域>/<模块>/<子模块>/<page-name>/
 └── mock/*.ts      mock-first 场景下生成，端点与 API_CONFIG 对齐
 ```
 
-外加生成报告：`.github/reports/PAGE_CODEGEN_<模块>_<YYYYMMDD>.md`
+外加生成报告：`.wl-skills/reports/PAGE_CODEGEN_<模块>_<YYYYMMDD>.md`
 
 ---
 

package/files/{.github → .wl-skills}/skills/core/page-codegen/templates/universal/TPL-DETAIL-TABS.md

@@ -4,7 +4,7 @@
 
 > 适用场景：编辑/维护页面，上半区为多 Tab 表单（基本信息/客户信息/其他信息），下半区为子项表格。
 > **布局核心**：`jh-drag-row :topHeight="..."` 垂直分割上下区域（严禁 `C_Splitter`，详 standards/14-layout-containers.md）。
-> **参考标杆**：`src/views/sale/demo/add-demo/`、`src/views/sale/demo/domestic-trade-order-mainten/`
+> **参考标杆**：`src/views/sale/.wl-skills/templates/add-.wl-skills/templates/`、`src/views/sale/.wl-skills/templates/domestic-trade-order-mainten/`
 
 #### index.vue
 
@@ -337,7 +337,7 @@ export async function initPage() {
 
 仅在“极个性弹窗”场景生成（c_modal 无法满足时），放在页面 `components/editModal.vue`：
 
-通用新增/编辑弹窗应优先使用 `src/components/local/c_modal/` 局部公共组件。
+通用新增/编辑弹窗应优先使用 `.wl-skills/src/components/local/c_modal/` 局部公共组件。
 
 ```vue
 <template>
@@ -526,9 +526,9 @@ onMounted(() => select());
 | 用户选择 | `component: () => ({ tag: "jh-user-picker" })`                                                                                                                |
 | 部门选择 | `component: () => ({ tag: "jh-dept-picker" })`                                                                                                                |
 
-详细组件 API：`docs/jh-date.md`、`docs/jh-select.md`、`docs/jh-user-picker.md`、`docs/jh-dept-picker.md`
-页面 Hook 最佳实践：`docs/page-query-hook-best-practices.md`
-HTTP 方法参考：`docs/request.md`
+详细组件 API：`.wl-skills/docs/jh-date.md`、`.wl-skills/docs/jh-select.md`、`.wl-skills/docs/jh-user-picker.md`、`.wl-skills/docs/jh-dept-picker.md`
+页面 Hook 最佳实践：`.wl-skills/docs/page-query-hook-best-practices.md`
+HTTP 方法参考：`.wl-skills/docs/request.md`
 
 ---
 
@@ -743,7 +743,7 @@ function genRecord() {
    - 「菜单路径」字段（camelCase）才是真正的路由 path 段
 2. **隐藏菜单 hidden: true**：独立表单/详情页**必须设为隐藏**，避免菜单栏多出无意义入口
 3. **pages.ts 变更需重启** dev server（fullImportPlugin 只在首次 transform 时读取）
-4. **local 组件必须显式 import**：`src/components/local/` 下的组件不会自动全局注册
+4. **local 组件必须显式 import**：`.wl-skills/src/components/local/` 下的组件不会自动全局注册
 
 ### FORM_ROUTE 格式
 
@@ -1065,7 +1065,7 @@ spec.features.hiddenMenu === true：
 
 ### 菜单配置
 
-> 菜单配置统一生成到 `.github/reports/SYS_MENU_INFO.md`（集中式），生成规则见 SKILL.md 主文件的「SYS_MENU_INFO 生成规则」章节。
+> 菜单配置统一生成到 `.wl-skills/reports/SYS_MENU_INFO.md`（集中式），生成规则见 SKILL.md 主文件的「SYS_MENU_INFO 生成规则」章节。
 
 ---
 

package/files/{.github → .wl-skills}/skills/core/page-codegen/templates/universal/TPL-DRIVEN.md

@@ -28,7 +28,7 @@ index.scss → 空文件或极少样式（模板组件内部已处理样式）
 生成 config 对象前，必须先读取该模板的类型定义文件：
 
 ```
-src/components/template/{XxxTemplate}/types.ts
+.wl-skills/src/components/template/{XxxTemplate}/types.ts
 ```
 
 `data.ts` 的 config 对象结构必须完全遵循 `types.ts` 的 interface 定义，不得猜测字段。
@@ -97,7 +97,7 @@ import { [camelPageName]Config } from "./data";
 
 **必须同时满足以下两个条件**：
 
-1. 项目 `src/components/template/` 目录下已存在可复用的 Template 组件
+1. 项目 `.wl-skills/src/components/template/` 目录下已存在可复用的 Template 组件
 2. 当前页面与该模板的交互骨架**完全一致**（查询/操作/表格结构均与模板期望的 config 结构匹配）
 
 **不确定时的决策**：
@@ -113,7 +113,7 @@ import { [camelPageName]Config } from "./data";
 ## 已知配置驱动模板一览（cx-ui-produce 项目特定）
 
 > ⚠️ 以下是 cx-ui-produce 项目已有的 Template 组件，仅在该项目中适用。
-> 其他项目需根据自己项目的 `src/components/template/` 目录确认。
+> 其他项目需根据自己项目的 `.wl-skills/src/components/template/` 目录确认。
 
 ### 1. ResultQueryTemplate（轧钢实绩查询类）
 
@@ -177,7 +177,7 @@ import { [pageName]Config } from "./data";
 - 有固定的查询区 + 实绩录入 + 汇总数据结构
 - 字段结构高度统一（同一套模板 7 个页面共用）
 
-**生成规则**：读 `src/components/template/FinishingAchievementTemplate/types.ts`，按 `FinishingAchievementConfig` interface 生成 config 对象。
+**生成规则**：读 `.wl-skills/src/components/template/FinishingAchievementTemplate/types.ts`，按 `FinishingAchievementConfig` interface 生成 config 对象。
 
 ---
 
@@ -278,7 +278,7 @@ import { [pageName]Config } from "./data";
 - 有固定的查询区 + 实绩录入 + 汇总数据结构
 - 字段结构高度统一（同一套模板 7 个页面共用）
 
-**生成规则**：参考 `src/components/template/FinishingAchievementTemplate/` 内的 `types.ts` 定义，只生成对应的 config 配置。
+**生成规则**：参考 `.wl-skills/src/components/template/FinishingAchievementTemplate/` 内的 `types.ts` 定义，只生成对应的 config 配置。
 
 ---
 

package/files/{.github → .wl-skills}/skills/core/page-codegen/templates/universal/TPL-FORM-ROUTE.md

@@ -369,13 +369,13 @@ onMounted(() => {
 
 | 条件                                            | 方式                                                         |
 | ----------------------------------------------- | ------------------------------------------------------------ |
-| 3+ 页面布局完全相同，仅 API/工序代码/列不同     | 提取 `src/components/template/XxxTemplate/`，页面仅传 config |
+| 3+ 页面布局完全相同，仅 API/工序代码/列不同     | 提取 `.wl-skills/src/components/template/XxxTemplate/`，页面仅传 config |
 | 页面布局有显著差异（不同 Tab 结构、不同表数量） | 独立页面，在 data.ts 中定义多个 `createXxxPage()`            |
 
 ### D-2 配置驱动模板组件结构（参考 FinishingAchievementTemplate）
 
 ```
-src/components/template/[TemplateName]/
+.wl-skills/src/components/template/[TemplateName]/
 ├── index.vue       ← 模板组件（接收 config prop）
 ├── data.ts         ← createXxxPage() 工厂函数
 ├── types.ts        ← 配置类型定义（ApiConfig, ColumnsConfig, UiConfig 等）

package/files/{.github → .wl-skills}/skills/core/page-codegen/templates/universal/TPL-RECORD-FORM.md

@@ -24,7 +24,7 @@ import {
   TableColumnDesc,
   BusLogicDataType,
 } from "@/types/page";
-import type { BaseFormItemDesc } from "@jhlc/common-core/src/components/form/common/type";
+import type { BaseFormItemDesc } from "@jhlc/common-core/.wl-skills/src/components/form/common/type";
 import c_spliterTitle from "@/components/local/c_spliterTitle/index.vue";
 import { getAction, postAction } from "@jhlc/common-core/src/api/action";
 import { debounce } from "lodash-es";

package/files/{.github → .wl-skills}/skills/core/page-codegen/templates/universal/TPL-TREE-LIST.md

@@ -205,6 +205,6 @@ export function createPage(editModalRef?: any) {
 
 > **C_Tree Props 速查**：`tabs`（标签页数组）、`treeData`（必填）、`showSearch`（默认 true）、`defaultExpandAll`（默认 true）。
 > **Events**：`@node-click`（节点点击）、`@tab-change`（标签页切换）。
-> 详见 `src/components/global/C_Tree/README.md`。
+> 详见 `.wl-skills/src/components/global/C_Tree/README.md`。
 
 ---