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

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

@@ -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(() => {
@@ -99,7 +99,7 @@ onMounted(() => {
 若现存项目仍引用 `C_Splitter`：
 
 1. **当前版本**：保留组件文件，在 `onMounted` 顶部加 `console.warn("[C_Splitter 已废弃] ...")` 提示
-2. **下一版本**：删除 `src/components/global/C_Splitter/`，全量替换为 `jh-drag-col/row`
+2. **下一版本**：删除 `.wl-skills/src/components/global/C_Splitter/`，全量替换为 `jh-drag-col/row`
 3. **lint 规则**：`wl-skills validate` / `wl-skills doctor-ui` 命中 `import C_Splitter` 或 `<C_Splitter` 时报 ERROR
 
 ---
@@ -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 仓库。

package/lib/vite-plugin-wl-skills.js

@@ -0,0 +1,97 @@
+"use strict";
+
+/**
+ * lib/vite-plugin-wl-skills.js — wl-skills-kit Vite 构建时约束插件
+ *
+ * 这是不依赖业务项目配置 CI 的"第五层防线"：
+ *   dev 模式 → 启动时扫描 src/views，在终端输出 warning
+ *   build 模式 → 构建前全量扫描，有 error 级别违规时中断构建
+ *
+ * 使用方式（业务项目 vite.config.ts）：
+ *   import wlSkillsPlugin from "@agile-team/wl-skills-kit/lib/vite-plugin-wl-skills.js";
+ *   export default defineConfig({
+ *     plugins: [vue(), wlSkillsPlugin()],
+ *   });
+ *
+ * 或在 init/update 时自动注入到 vite.config.ts 的 plugins 数组（可选）。
+ *
+ * 约束层级定位：
+ *   ① AI 指令层（文字） → 可被忽略
+ *   ② validate 检测层 → 手动调用
+ *   ③ pre-commit 层 → --no-verify 可绕过
+ *   ④ CI 层 → 业务项目需手动配置
+ *   ⑤ Vite 插件层（本插件） → 构建时自动执行，无需额外配置 ← 不可绕开
+ */
+
+const path = require("path");
+
+let astRules = null;
+try {
+  astRules = require("./ast-rules.js");
+} catch {
+  astRules = null;
+}
+
+function wlSkillsPlugin(options) {
+  options = options || {};
+  const scanRel = options.scanRel || "src/views";
+  const failOnWarn = options.failOnWarn || false; // build 模式下 warn 也中断（等同 --strict）
+
+  return {
+    name: "wl-skills-guard",
+    apply: "all", // serve + build 都生效
+
+    configResolved(config) {
+      // 只在业务项目运行，跳过 kit 自身
+      if (!astRules || !astRules.hasAstAvailable()) return;
+
+      const root = config.root || process.cwd();
+      const isBuild = config.command === "build";
+
+      const result = astRules.runAstRules(root, scanRel);
+      if (!result.astAvailable) return;
+
+      const errors = result.issues.filter((i) => i.level === "error");
+      const warns = result.issues.filter((i) => i.level === "warn");
+
+      if (result.issues.length === 0) {
+        if (isBuild) {
+          console.log("\n  ✔ wl-skills-guard: 页面规范检查通过（" + result.pages + " 个页面）\n");
+        }
+        return;
+      }
+
+      // 输出所有问题
+      console.log("\n  wl-skills-guard: 发现 " + result.issues.length + " 个规范偏差（" + result.pages + " 页面）");
+      for (const issue of result.issues.slice(0, 30)) {
+        const icon = issue.level === "error" ? "✖" : "⚠";
+        console.log("  " + icon + " [" + issue.rule + "] " + issue.dir + " — " + issue.text);
+      }
+      if (result.issues.length > 30) {
+        console.log("  ... 还有 " + (result.issues.length - 30) + " 条");
+      }
+
+      // build 模式：error 中断构建
+      if (isBuild && errors.length > 0) {
+        console.log("\n  ✖ wl-skills-guard: 构建中断 — " + errors.length + " 个 error 级规范违规");
+        console.log("  → 修复后重新构建，或使用 wl-skills:ignore 标记豁免");
+        throw new Error(
+          "wl-skills-guard: " + errors.length + " 个 error 级规范违规，构建已中断",
+        );
+      }
+
+      // build 模式 + failOnWarn：warn 也中断
+      if (isBuild && failOnWarn && warns.length > 0) {
+        console.log("\n  ✖ wl-skills-guard: 构建中断 — " + warns.length + " 个 warn 级规范违规（failOnWarn）");
+        throw new Error(
+          "wl-skills-guard: " + warns.length + " 个 warn 级违规（failOnWarn 模式）",
+        );
+      }
+
+      console.log("");
+    },
+  };
+}
+
+module.exports = wlSkillsPlugin;
+module.exports.default = wlSkillsPlugin;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.10.1",
-  "description": "AI Skill 模板包 v2.10.1  — 14 条编码规范 + 11 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目",
+  "version": "2.11.0",
+  "description": "AI Skill 模板包 v2.11.0 — 14 条编码规范 + 11 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目（.wl-skills/ 统一隔离架构）",
   "main": "./bin/wl-skills.js",
   "bin": {
     "wl-skills": "bin/wl-skills.js"