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

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/mcp/config.js

@@ -4,7 +4,7 @@ const fs = require('fs')
 const path = require('path')
 
 /**
- * 从项目的 .github/skills/sync/env.local.json 加载 MCP 运行配置
+ * 从项目的 .wl-skills/skills/sync/env.local.json 加载 MCP 运行配置
  * 项目根目录通过环境变量 WL_PROJECT_ROOT 传入（由 .cursor/mcp.json 注入）
  */
 function loadConfig() {
@@ -12,12 +12,12 @@ function loadConfig() {
     ? path.resolve(process.env.WL_PROJECT_ROOT)
     : process.cwd()
 
-  const configPath = path.join(projectRoot, '.github', 'skills', 'sync', 'env.local.json')
+  const configPath = path.join(projectRoot, '.wl-skills', 'skills', 'sync', 'env.local.json')
 
   if (!fs.existsSync(configPath)) {
     throw new Error(
       `配置文件不存在: ${configPath}\n` +
-      `请先执行 npx @agile-team/wl-skills-kit init，然后填写 .github/skills/sync/env.local.json`
+      `请先执行 pnpm dlx @agile-team/wl-skills-kit init，然后填写 .wl-skills/skills/sync/env.local.json`
     )
   }
 

package/mcp/tools/projectTools.js

@@ -5,6 +5,7 @@ const path = require("path");
 const { execFileSync } = require("child_process");
 const https = require("https");
 const { runAstRules } = require("../../lib/ast-rules");
+const { alignPage } = require("../../lib/page-spec");
 
 function getProjectRoot() {
   return process.env.WL_PROJECT_ROOT
@@ -203,6 +204,15 @@ async function handleValidatePage(args) {
     }
   }
 
+  // ── page-spec 比对（v2.11.1+，"约定 vs 代码"确定性核对 S1~S5）───────
+  for (const page of pages) {
+    const absDir = path.join(root, page.dir);
+    const { issues: specIssues } = alignPage(absDir, page.dir);
+    for (const iss of specIssues) {
+      issues.push([iss.dir, iss.level, `[${iss.rule}] ${iss.text}`]);
+    }
+  }
+
   const errors = issues.filter((item) => item[1] === "error").length;
   const lines = [
     `✅ 页面校验完成：${scanPath}`,

package/package.json

@@ -1,8 +1,9 @@
 {
   "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.1",
+  "description": "AI Skill 模板包 v2.11.1 — 14 条编码规范 + 11 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目（.wl-skills/ 统一隔离架构）",
   "main": "./bin/wl-skills.js",
+  "packageManager": "pnpm@11.5.3",
   "bin": {
     "wl-skills": "bin/wl-skills.js"
   },
@@ -37,28 +38,29 @@
     "url": "git+https://github.com/ChenyCHENYU/wl-skills-kit.git"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=18.0.0"
   },
   "scripts": {
-    "standards:init": "npx @robot-admin/git-standards init",
+    "standards:init": "pnpm dlx @robot-admin/git-standards init",
     "prepare": "husky",
     "cz": "git-cz",
     "lint": "eslint .",
     "lint:skills": "node scripts/lint-skills.js",
     "test": "vitest run",
     "version:verify": "node scripts/verify-version.js",
+    "verify": "pnpm version:verify && pnpm lint:skills && pnpm test",
+    "ci": "pnpm install --frozen-lockfile && pnpm verify",
+    "pack:dry": "npm pack --dry-run --ignore-scripts",
+    "release:check": "pnpm verify && npm pack --dry-run --ignore-scripts",
     "prepublishOnly": "node scripts/verify-version.js && node scripts/lint-skills.js && vitest run"
   },
-  "dependencies": {
-    "xlsx": "^0.18.5"
-  },
   "optionalDependencies": {
-    "@vue/compiler-sfc": "^3.2.0",
-    "@babel/parser": "^7.20.0"
+    "@babel/parser": "^7.20.0",
+    "@vue/compiler-sfc": "^3.2.0"
   },
   "peerDependencies": {
-    "@vue/compiler-sfc": "^3.2.0",
-    "@babel/parser": "^7.20.0"
+    "@babel/parser": "^7.20.0",
+    "@vue/compiler-sfc": "^3.2.0"
   },
   "peerDependenciesMeta": {
     "@vue/compiler-sfc": {
@@ -91,5 +93,8 @@
     "src/**/*.{js,jsx,ts,tsx,vue}": [
       "eslint --fix --no-cache"
     ]
+  },
+  "dependencies": {
+    "write-excel-file": "^4.1.1"
   }
 }

package/files/src/components/global/C_Splitter/index.scss

@@ -1,61 +0,0 @@
-.my-splitter-container {
-  display: flex;
-  width: 100%;
-  height: 100%;
-  overflow: hidden;
-}
-
-.is-horizontal {
-  flex-direction: row;
-}
-.is-vertical {
-  flex-direction: column;
-}
-
-.splitter-item {
-  overflow: auto;
-}
-
-.splitter-trigger {
-  background-color: #f0f2f5;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  transition: background-color 0.2s;
-  z-index: 10;
-}
-
-.splitter-trigger:hover {
-  background-color: #409eff;
-}
-
-/* 水平线 */
-.is-horizontal > .splitter-trigger {
-  width: 4px;
-  cursor: col-resize;
-}
-.is-horizontal .trigger-line {
-  width: 1px;
-  height: 20px;
-  background: #dcdfe6;
-}
-
-/* 垂直线 */
-.is-vertical > .splitter-trigger {
-  height: 8px;
-  cursor: row-resize;
-  background-color: #f5f5f5;
-  flex-shrink: 0;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-}
-.is-vertical .trigger-line {
-  width: 30px;
-  height: 3px;
-  background: #d9d9d9;
-  border-radius: 2px;
-}
-.is-vertical > .splitter-trigger:hover .trigger-line {
-  background: #409eff;
-}

package/files/src/components/global/C_Splitter/index.vue

@@ -1,149 +0,0 @@
-<template>
-  <div
-    ref="containerRef"
-    class="my-splitter-container"
-    :class="[`is-${direction}`]"
-  >
-    <template v-for="(item, index) in vnodes" :key="index">
-      <div class="splitter-item" :style="getItemStyle(index)">
-        <component :is="item" />
-      </div>
-
-      <div
-        v-if="index < vnodes.length - 1"
-        class="splitter-trigger"
-        @mousedown="(e) => onMouseDown(e, index)"
-      >
-        <div class="trigger-line"></div>
-      </div>
-    </template>
-  </div>
-</template>
-
-<script setup>
-import { ref, reactive, onMounted, useSlots, onUnmounted } from "vue";
-
-// ⚠️ [DEPRECATED] C_Splitter 已废弃，请改用：
-//   左右分割 → <jh-drag-col :leftWidth="260"> #left / #right </jh-drag-col>
-//   上下分栈 → <jh-drag-row :topHeight="200"> #top / #bottom </jh-drag-row>
-// 原因：C_Splitter 在 onMounted 中调用 slots.default() 冻结 vnode 快照，
-//      导致子树响应式绑定（v-if / v-show / 插值）与父组件 ref 完全解耦，
-//      ref 赋值不触发重渲染。详见 .github/standards/14-layout-containers.md
-if (typeof window !== "undefined" && !window.__C_SPLITTER_WARNED__) {
-  window.__C_SPLITTER_WARNED__ = true;
-  // eslint-disable-next-line no-console
-  console.warn(
-    "[C_Splitter 已废弃] 已检测到 C_Splitter 使用。请改用 jh-drag-col / jh-drag-row。\n" +
-    "原因：slots.default() 被冻结为 vnode 快照，导致子树响应式失效。\n" +
-    "详见：.github/standards/14-layout-containers.md"
-  );
-}
-
-const props = defineProps({
-  direction: {
-    type: String,
-    default: "horizontal" // horizontal | vertical
-  },
-  minSize: {
-    type: Number,
-    default: 50
-  }
-});
-
-const slots = useSlots();
-const containerRef = ref(null);
-const vnodes = ref([]); // 存储虚拟节点
-const paneConfigs = ref([]); // 存储每个面板的 minSize 等配置
-const sizes = reactive([]);
-const isDragging = ref(false);
-let currentTriggerIndex = -1;
-
-// 初始化：获取插槽并分配初始平均尺寸
-onMounted(() => {
-  const defaultSlots = slots.default ? slots.default() : [];
-  // 过滤掉注释节点(Symbol(v-cmt))和Fragment，只保留真正的元素
-  const children = defaultSlots.filter((v) => {
-    // 排除 Symbol 类型（注释节点）和 Fragment
-    if (typeof v.type === "symbol") return false;
-    // 保留 string（原生HTML元素）和 object（组件）
-    return typeof v.type === "string" || typeof v.type === "object";
-  });
-  vnodes.value = children;
-
-  const rect = containerRef.value.getBoundingClientRect();
-  const totalAvailable =
-    props.direction === "horizontal" ? rect.width : rect.height;
-  // vertical 模式 trigger 高度是 8px，horizontal 模式宽度是 4px
-  const triggerSize = props.direction === "horizontal" ? 4 : 8;
-  const triggerTotalSize = (children.length - 1) * triggerSize;
-
-  let remainingSize = totalAvailable - triggerTotalSize;
-  let autoCount = 0;
-
-  // 1. 第一次遍历：解析 initialSize (支持 200 或 "30%")
-  const tempSizes = children.map((vnode) => {
-    const initSize = vnode.props?.initialSize;
-    if (initSize === undefined || initSize === null) {
-      autoCount++;
-      return null;
-    }
-    const sizePx =
-      typeof initSize === "string" && initSize.endsWith("%")
-        ? (parseFloat(initSize) / 100) * (totalAvailable - triggerTotalSize)
-        : parseFloat(initSize);
-    remainingSize -= sizePx;
-    return sizePx;
-  });
-
-  // 2. 第二次遍历：填充 sizes 和 paneConfigs
-  tempSizes.forEach((size, idx) => {
-    sizes.push(size === null ? remainingSize / autoCount : size);
-    paneConfigs.value.push({
-      minSize: children[idx].props?.minSize || props.minSize
-    });
-  });
-});
-
-const getItemStyle = (index) => {
-  const prop = props.direction === "horizontal" ? "width" : "height";
-  return { [prop]: `${sizes[index]}px` };
-};
-
-// 拖拽逻辑
-const onMouseDown = (e, index) => {
-  isDragging.value = true;
-  currentTriggerIndex = index;
-  document.body.style.userSelect = "none";
-  document.body.style.cursor =
-    props.direction === "horizontal" ? "col-resize" : "row-resize";
-
-  window.addEventListener("mousemove", onMouseMove);
-  window.addEventListener("mouseup", onMouseUp);
-};
-
-const onMouseMove = (e) => {
-  if (!isDragging.value) return;
-  const i = currentTriggerIndex;
-  const movement = props.direction === "horizontal" ? e.movementX : e.movementY;
-
-  const minCurr = paneConfigs.value[i].minSize;
-  const minNext = paneConfigs.value[i + 1].minSize;
-
-  if (sizes[i] + movement >= minCurr && sizes[i + 1] - movement >= minNext) {
-    sizes[i] += movement;
-    sizes[i + 1] -= movement;
-  }
-};
-
-const onMouseUp = () => {
-  isDragging.value = false;
-  document.body.style.userSelect = "";
-  document.body.style.cursor = "";
-  window.removeEventListener("mousemove", onMouseMove);
-  window.removeEventListener("mouseup", onMouseUp);
-};
-
-onUnmounted(() => onMouseUp())
-</script>
-
-<style scoped src="./index.scss"></style>