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

package/files/{.github → .wl-skills}/standards/13-platform-components.md

@@ -53,25 +53,25 @@ BaseQuery → BaseToolbar → BaseTable → jh-pagination
 
 ---
 
-## docs/ 文档前置读取清单
+## .wl-skills/docs/ 文档前置读取清单
 
 生成涉及以下场景的代码时，AI 必须先读取对应文档（按需，不全读）：
 
 | 涉及组件 / 模式             | 必读文档                                      |
 | --------------------------- | --------------------------------------------- |
-| `jh-date` / `jh-date-range` | `docs/jh-date.md` / `docs/jh-date-range.md`   |
-| `jh-file-upload`            | `docs/jh-file-upload.md`                      |
-| `jh-user-picker`            | `docs/jh-user-picker.md`                      |
-| `jh-dept-picker`            | `docs/jh-dept-picker.md`                      |
-| `jh-select`                 | `docs/jh-select.md`                           |
-| `jh-picker`                 | `docs/jh-picker.md`                           |
-| `jh-text`                   | `docs/jh-text.md`                             |
-| `jh-pagination`             | `docs/jh-pagination.md`                       |
-| `jh-drag-row`               | `docs/jh-drag-row.md`                         |
-| HTTP 请求方式               | `docs/request.md`                             |
-| 页面 Hook 模式              | `docs/page-query-hook-best-practices.md`      |
-| BaseQuery / BaseTable 等    | `src/components/remote/{Component}/README.md` |
-| c_formModal / c_listModal   | `src/components/local/{component}/README.md`  |
+| `jh-date` / `jh-date-range` | `.wl-skills/docs/jh-date.md` / `.wl-skills/docs/jh-date-range.md`   |
+| `jh-file-upload`            | `.wl-skills/docs/jh-file-upload.md`                      |
+| `jh-user-picker`            | `.wl-skills/docs/jh-user-picker.md`                      |
+| `jh-dept-picker`            | `.wl-skills/docs/jh-dept-picker.md`                      |
+| `jh-select`                 | `.wl-skills/docs/jh-select.md`                           |
+| `jh-picker`                 | `.wl-skills/docs/jh-picker.md`                           |
+| `jh-text`                   | `.wl-skills/docs/jh-text.md`                             |
+| `jh-pagination`             | `.wl-skills/docs/jh-pagination.md`                       |
+| `jh-drag-row`               | `.wl-skills/docs/jh-drag-row.md`                         |
+| HTTP 请求方式               | `.wl-skills/docs/request.md`                             |
+| 页面 Hook 模式              | `.wl-skills/docs/page-query-hook-best-practices.md`      |
+| BaseQuery / BaseTable 等    | `.wl-skills/src/components/remote/{Component}/README.md` |
+| c_formModal / c_listModal   | `.wl-skills/src/components/local/{component}/README.md`  |
 
 > AI 在 Pre-flight 声明中明确列出已读文档。
 
@@ -120,4 +120,4 @@ export function createPage() {
 - [ ] 日期组件用了 jh-date 系列，没有用 el-date-picker？
 - [ ] HTTP 请求都走 `this.getAction / postAction`，没有 import axios？
 - [ ] data.ts 继承了 AbstractPageQueryHook？
-- [ ] 涉及 jh-_ 组件时已读取对应 docs/jh-_.md？
+- [ ] 涉及 jh-_ 组件时已读取对应 .wl-skills/docs/jh-_.md？

package/files/{.github → .wl-skills}/standards/14-layout-containers.md

@@ -1,4 +1,4 @@
-# 14 — 布局容器规范（C_Splitter 禁用 + jh-drag-col/row 唯一推荐）
+# 14 — 布局容器规范（C_Splitter 已删除 + jh-drag-col/row 唯一推荐）
 
 > **强制度**：🔴 必遵 + 阻断式（lint 命中即报错）。
 > **背景**：2024 年 12 月一次真实事故，左树右表页面右侧面板永不刷新，最终定位为 `C_Splitter` 在 `onMounted` 中调用 `slots.default()` 冻结 vnode 快照，导致子树所有响应式绑定与父组件 ref 脱钩。
@@ -20,7 +20,7 @@
 
 ## 2. C_Splitter 为什么必须废弃（根因）
 
-`src/components/global/C_Splitter/index.vue` 内部实现：
+`.wl-skills/src/components/global/C_Splitter/index.vue` 内部实现：
 
 ```js
 onMounted(() => {
@@ -94,13 +94,13 @@ onMounted(() => {
 
 ---
 
-## 4. 兼容期处理
+## 4. 存量改造
 
-若现存项目仍引用 `C_Splitter`：
+`C_Splitter` 组件已从 kit 中**彻底删除**（不再随包分发）。若存量项目仍引用：
 
-1. **当前版本**：保留组件文件，在 `onMounted` 顶部加 `console.warn("[C_Splitter 已废弃] ...")` 提示
-2. **下一版本**：删除 `src/components/global/C_Splitter/`，全量替换为 `jh-drag-col/row`
-3. **lint 规则**：`wl-skills validate` / `wl-skills doctor-ui` 命中 `import C_Splitter` 或 `<C_Splitter` 时报 ERROR
+1. **必须替换**：所有 `import C_Splitter` / `<C_Splitter>` 全量替换为 `jh-drag-col` / `jh-drag-row`
+2. **lint 规则**：`wl-skills validate` / `wl-skills doctor-ui` / `lint-skills` 命中 `import C_Splitter` 或 `<C_Splitter` 一律报 ERROR，无任何豁免
+3. **删除残留组件目录**：若项目 `src/components/global/C_Splitter/` 仍存在，可直接删除
 
 ---
 
@@ -148,7 +148,7 @@ done
 不会。`jh-drag-col` / `jh-drag-row` 都是直接 `<slot />`，没有 vnode 缓存或额外 watcher，嵌套层数与原生 div 等价。
 
 **Q4：必须保留 `C_Splitter` 组件文件吗？**
-保留一段过渡期（带 deprecation warning）即可。等仓库扫描 0 命中后，下一个大版本直接删除 `src/components/global/C_Splitter/`。
+保留一段过渡期（带 deprecation warning）即可。等仓库扫描 0 命中后，下一个大版本直接删除 `.wl-skills/src/components/global/C_Splitter/`。
 
 ---
 
@@ -156,4 +156,4 @@ done
 
 - `12-base-table.md` — BaseTable 内部高度撑满依赖父容器有明确高度，jh-drag-col/row 已正确给子区设 `height: 100%`
 - `13-platform-components.md` — 平台组件对照表已同步移除 C_Splitter
-- 真实场景案例：`demo/produce/aiflow/mmwr-customer-detail/`（master-detail 使用 jh-drag-row）
+- 真实场景案例：`.wl-skills/templates/produce/aiflow/mmwr-customer-detail/`（master-detail 使用 jh-drag-row）

package/files/{demo → .wl-skills/templates}/README.md

@@ -18,13 +18,13 @@
 | `mmwr-customer-apply-change-history/` | CHANGE_HISTORY | 客户变更历史比对                    |
 | `mmwr-customer-detail/`               | DETAIL_TABS    | 客户详情（多 Tab）                  |
 
-## sale/demo/ — 销售域（平台默认样例，5 个页面）
+## sale/.wl-skills/templates/ — 销售域（平台默认样例，5 个页面）
 
 | 目录                     | 模板类型      | 说明                             |
 | ------------------------ | ------------- | -------------------------------- |
 | `domestic-trade-order/`  | LIST          | 标准内贸订单列表                 |
 | `metallurgical-spec/`    | MASTER_DETAIL | 冶金规范（jh-drag-row 上下分栏） |
-| `add-demo/`              | FORM_ROUTE    | 新增表单演示（c_formSections）   |
+| `add-.wl-skills/templates/`              | FORM_ROUTE    | 新增表单演示（c_formSections）   |
 | `billet-flame-cut-plan/` | LIST          | 坯料火焰切割计划列表             |
 | `heat-batch-return/`     | LIST + Modal  | 炉批退判（含自定义弹窗）         |
 
@@ -41,4 +41,4 @@
 
 ## 贡献
 
-新增样例请放在 `demo/{domain}/{submodule}/{page-name}/`，提 PR 到 wl-skills-kit 仓库。
+新增样例请放在 `.wl-skills/templates/{domain}/{submodule}/{page-name}/`，提 PR 到 wl-skills-kit 仓库。