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

package/files/{.github → .wl-skills}/skills/sync/permission-sync/SKILL.md

@@ -7,13 +7,13 @@ description: "Use when: managing roles, authorizing menus to roles, attaching ac
 
 将系统的**角色 → 菜单授权 → 动作按钮 → `data.ts` 权限码字段**串成一条链路，覆盖从权限注册到代码落地的全流程。
 
-> **与 menu-sync / dict-sync 的关系**：完全对称，统一从 `.github/skills/sync/env.local.json` 读取配置。`menu-sync` 负责页面菜单（type=M/C），`permission-sync` 负责其上的角色与动作（type=A）。
+> **与 menu-sync / dict-sync 的关系**：完全对称，统一从 `.wl-skills/skills/sync/env.local.json` 读取配置。`menu-sync` 负责页面菜单（type=M/C），`permission-sync` 负责其上的角色与动作（type=A）。
 
 ---
 
 ## 配置（统一配置文件，复用 menu-sync 的配置）
 
-读取 `.github/skills/sync/env.local.json`：
+读取 `.wl-skills/skills/sync/env.local.json`：
 
 ```json
 {
@@ -231,7 +231,7 @@ permission-sync 通过 6 个 MCP 工具完成所有操作（无需手动 fetch
 
 ## 8. 报告输出（reports/PERMISSION_SYNC_<日期>.md）
 
-每次执行在 `.github/reports/PERMISSION_SYNC_YYYYMMDD.md` 追加：模式（role-manage/role-assign/action-attach）、变更摘要（新增/已存在/失败）、data.ts 修改行位置、回滚提示。
+每次执行在 `.wl-skills/reports/PERMISSION_SYNC_YYYYMMDD.md` 追加：模式（role-manage/role-assign/action-attach）、变更摘要（新增/已存在/失败）、data.ts 修改行位置、回滚提示。
 
 ---
 

package/files/{.github → .wl-skills}/skills/sync/permission-sync/USAGE.md

@@ -94,7 +94,7 @@ AI ： [触发 permission-sync]
 
 ## 配置要点
 
-只需 `.github/skills/sync/env.local.json` 的根字段：
+只需 `.wl-skills/skills/sync/env.local.json` 的根字段：
 
 ```json
 {

package/files/{src → .wl-skills/src}/components/global/C_Splitter/index.vue

@@ -28,14 +28,14 @@ import { ref, reactive, onMounted, useSlots, onUnmounted } from "vue";
 //   上下分栈 → <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
+//      ref 赋值不触发重渲染。详见 .wl-skills/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"
+    "详见：.wl-skills/standards/14-layout-containers.md"
   );
 }
 

package/files/{src → .wl-skills/src}/components/local/c_formModal/README.md

@@ -32,7 +32,7 @@ c_formModal/
 
 ```typescript
 // src/views/your-module/data.ts
-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: "内贸订单", // 标题前缀

package/files/{src → .wl-skills/src}/components/local/c_formSections/README.md

@@ -462,7 +462,7 @@ const defaultForm = generateDefaultFormData(sectionsConfig);
 
 ### 新增编辑页示例
 
-**路径**: `src/views/sale/demo/add-demo/`
+**路径**: `src/views/sale/.wl-skills/templates/add-.wl-skills/templates/`
 
 **特性**:
 
@@ -485,7 +485,7 @@ const defaultForm = generateDefaultFormData(sectionsConfig);
 **关键代码结构**:
 
 ```
-add-demo/
+add-.wl-skills/templates/
 ├── index.vue      # 视图层（176行）- 组件使用和布局
 ├── data.ts        # 逻辑层（400+行）- 配置和业务逻辑
 ├── index.scss     # 样式层（207行）- 页面样式

package/files/{src → .wl-skills/src}/components/remote/BaseForm/README.md

@@ -11,7 +11,7 @@ BaseForm 是一个功能强大的表单组件，支持多列布局、数据验
 // 直接使用 <BaseForm /> 即可
 
 // 类型导入
-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";
 ```
 
 ## 🚀 基本用法
@@ -341,7 +341,7 @@ import { h } from "vue";
 
 <script setup lang="ts">
 import { ref, reactive, computed } from "vue";
-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";
 
 const formRef = ref();
 

package/files/{src → .wl-skills/src}/components/remote/BaseQuery/README.md

@@ -11,7 +11,7 @@ BaseQuery 是一个功能强大的查询条件组件，支持多列布局、条
 // 直接使用 <BaseQuery /> 即可
 
 // 类型导入
-import type { BaseQueryItemDesc } from "@jhlc/common-core/src/components/form/base-query/type";
+import type { BaseQueryItemDesc } from "@jhlc/common-core/.wl-skills/src/components/form/base-query/type";
 ```
 
 ## 🚀 基本用法
@@ -369,7 +369,7 @@ interface BaseQueryItemDesc<T = any> {
 
 <script setup lang="ts">
 import { ref, reactive, computed, onMounted } from "vue";
-import type { BaseQueryItemDesc } from "@jhlc/common-core/src/components/form/base-query/type";
+import type { BaseQueryItemDesc } from "@jhlc/common-core/.wl-skills/src/components/form/base-query/type";
 
 const queryRef = ref();
 
@@ -546,7 +546,7 @@ BaseQuery 支持复杂的联动查询场景，通过 `customProps`、`disabled`
 
 <script setup lang="ts">
 import { reactive, computed } from "vue";
-import type { BaseQueryItemDesc } from "@jhlc/common-core/src/components/form/base-query/type";
+import type { BaseQueryItemDesc } from "@jhlc/common-core/.wl-skills/src/components/form/base-query/type";
 
 // 省市区数据
 const regionOptions = [
@@ -607,7 +607,7 @@ const handleSearch = () => {
 
 <script setup lang="ts">
 import { ref, reactive, computed } from "vue";
-import type { BaseQueryItemDesc } from "@jhlc/common-core/src/components/form/base-query/type";
+import type { BaseQueryItemDesc } from "@jhlc/common-core/.wl-skills/src/components/form/base-query/type";
 import request from "@/utils/request";
 
 // 动态选项数据

package/files/{src → .wl-skills/src}/components/remote/BaseTable/README.md

@@ -11,7 +11,7 @@ BaseTable 是一个功能强大的表格组件，支持数据展示、排序、
 // 直接使用 <BaseTable /> 即可
 
 // 类型导入
-import type { TableColumnDesc } from "@jhlc/common-core/src/components/table/base-table/type";
+import type { TableColumnDesc } from "@jhlc/common-core/.wl-skills/src/components/table/base-table/type";
 ```
 
 ## 🚀 基本用法
@@ -708,7 +708,7 @@ interface TableRowOperation {
 
 <script setup lang="ts">
 import { ref, computed, onMounted, h } from "vue";
-import type { TableColumnDesc } from "@jhlc/common-core/src/components/table/base-table/type";
+import type { TableColumnDesc } from "@jhlc/common-core/.wl-skills/src/components/table/base-table/type";
 
 const tableRef = ref();
 const list = ref([]);

package/files/{src → .wl-skills/src}/components/remote/BaseToolbar/README.md

@@ -11,7 +11,7 @@ BaseToolbar 是一个灵活的工具栏组件，用于放置操作按钮，支
 // 直接使用 <BaseToolbar /> 即可
 
 // 类型导入
-import type { ActionButtonDesc, ActionType } from "@jhlc/common-core/src/components/toolbar/type";
+import type { ActionButtonDesc, ActionType } from "@jhlc/common-core/.wl-skills/src/components/toolbar/type";
 ```
 
 ## 🚀 基本用法

package/files/{.github → .wl-skills}/standards/02-code-structure.md

@@ -50,7 +50,7 @@ src/views/[域]/[模块]/[子模块]/[kebab-case目录]/
 
 | 场景                    | 位置                                 |
 | ----------------------- | ------------------------------------ |
-| 通用弹窗（2+ 页面复用） | `src/components/local/c_xxxModal/`   |
+| 通用弹窗（2+ 页面复用） | `.wl-skills/src/components/local/c_xxxModal/`   |
 | 极个性弹窗（仅单页面）  | 页面目录下 `components/xxxModal.vue` |
 
 ---

package/files/{.github → .wl-skills}/standards/08-git.md

@@ -11,7 +11,7 @@
 feat/xxx       新功能
 fix/xxx        Bug 修复
 refactor/xxx   重构
-docs/xxx       文档更新
+.wl-skills/docs/xxx       文档更新
 chore/xxx      构建/工具变更
 perf/xxx       性能优化
 test/xxx       测试相关

package/files/{.github → .wl-skills}/standards/11-form-validation.md

@@ -14,7 +14,7 @@ open → 数据回填 → validate → submit → close / resetFields
 
 ✅ AI 直接按组件文档使用即可，**不需要重复写 validate / resetFields 逻辑**。
 
-参考：`src/components/local/c_formModal/README.md`
+参考：`.wl-skills/src/components/local/c_formModal/README.md`
 
 ---
 

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/{.github → .wl-skills}/standards/index.md

@@ -47,7 +47,7 @@
 ### 任务类型 C：规范审计（convention-audit）
 
 ```
-必读：全部 13 条（审计需要完整对照）
+  必读：全部 14 条（审计需要完整对照）
 ```
 
 ### 任务类型 D：模板提取（template-extract）

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/files/eslint.config.wl-skills.cjs

@@ -0,0 +1,123 @@
+/**
+ * ESLint Flat Config 模板 — wl-skills-kit 生成
+ *
+ * init/update 时复制到业务项目根目录作为 eslint.config.cjs
+ * 适用于 Vue 3 + TypeScript 项目，与 wl-skills validate 的规则互补：
+ *   - validate 负责"架构级"约束（页面结构、组件使用、AST 语义）
+ *   - ESLint 负责"代码级"约束（语法质量、安全、未使用变量、属性顺序）
+ *
+ * 对齐 wl-skills-kit 14 条 standards：
+ *   04 编码基础: eslint:recommended → no-var / prefer-const / no-redeclare / curly / no-restricted-syntax
+ *   05 日志:     no-console (warn)
+ *   06 安全:     vue/no-v-html (warn), no-eval, no-new-func
+ *   09 TS 质量:   @typescript-eslint/recommended
+ *   13 组件:     vue/attributes-order, vue/no-unused-components
+ *
+ * 依赖（业务项目需安装）：
+ *   pnpm add -D eslint eslint-plugin-vue @typescript-eslint/parser @typescript-eslint/eslint-plugin vue-eslint-parser
+ */
+
+const pluginVue = require("eslint-plugin-vue");
+const vueParser = require("vue-eslint-parser");
+const tsParser = require("@typescript-eslint/parser");
+const tsPlugin = require("@typescript-eslint/eslint-plugin");
+
+module.exports = [
+  {
+    ignores: [
+      "**/dist/**",
+      "**/node_modules/**",
+      "**/coverage/**",
+      "**/*.d.ts",
+      "src/auto-imports.d.ts",
+      "src/components.d.ts",
+      "src/env.d.ts",
+      "vite/**/*",
+      "scripts/**/*",
+      "mock/**/*",
+      "demo/**/*",
+      ".github/**/*",
+    ],
+  },
+
+  // ── JS 基础规则（standard 04: no-var / prefer-const / no-redeclare / curly 等）
+  // eslint:recommended 提供 no-var, prefer-const, no-redeclare, no-cond-assign, no-debugger, no-dupe-keys 等
+  {
+    rules: {
+      "no-var": "error",
+      "prefer-const": "error",
+      "no-redeclare": "error",
+      "no-cond-assign": "error",
+      "no-debugger": "error",
+      "no-dupe-keys": "error",
+      "no-duplicate-case": "error",
+      "no-empty": "warn",
+      "no-irregular-whitespace": "warn",
+      "no-sparse-arrays": "warn",
+      "no-unreachable": "error",
+      "use-isnan": "error",
+      "valid-typeof": "error",
+      "no-fallthrough": "error",
+      "curly": ["warn", "multi-line"],
+    },
+  },
+
+  // ── 安全规则（standard 06: eval / new Function / v-html）
+  {
+    rules: {
+      "no-eval": "error",
+      "no-implied-eval": "error",
+      "no-new-func": "error",
+      "no-script-url": "error",
+    },
+  },
+
+  // Vue 3 essential rules
+  ...pluginVue.configs["flat/essential"],
+
+  // TypeScript: parser + recommended rules
+  {
+    files: ["**/*.{ts,tsx,vue}"],
+    languageOptions: {
+      parser: vueParser,
+      parserOptions: {
+        parser: tsParser,
+        ecmaVersion: 2020,
+        sourceType: "module",
+        extraFileExtensions: [".vue"],
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin,
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+    },
+  },
+
+  // ── 项目专属规则（与 wl-skills-kit 14 条 standards 精确对齐）
+  {
+    rules: {
+      // 09 TS: strict: false 项目允许 any，但标记未使用变量
+      "no-undef": "off",
+      "no-unused-vars": "off",
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-unused-vars": [
+        "warn",
+        { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
+      ],
+
+      // 05 日志: console.log 残留（允许 warn/error）
+      "no-console": ["warn", { allow: ["warn", "error"] }],
+
+      // 06 安全: v-html 必须有注释说明（warn 级，让开发者留意）
+      "vue/no-v-html": "warn",
+
+      // Vue 组件质量
+      "vue/multi-word-component-names": ["error", { ignores: ["index"] }],
+      "vue/require-default-prop": "off",
+      "vue/attributes-order": "warn",
+      "vue/no-unused-components": "warn",
+    },
+  },
+];