npm - @agile-team/wl-skills-ui - Versions diffs - 1.6.2 - Mend

@agile-team/wl-skills-ui 1.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (150) hide show

package/CHANGELOG.md +207 -0
package/README.md +623 -0
package/SKILL.md +632 -0
package/bin/wl-ui.js +794 -0
package/design/spec/color.md +41 -0
package/design/spec/spacing.md +28 -0
package/design/spec/typography.md +29 -0
package/design/tokens/base.css +144 -0
package/design/tokens/index.css +8 -0
package/dist/ag-grid-override.scss +1 -0
package/dist/element.scss +1 -0
package/dist/index.scss +1 -0
package/dist/portal.scss +1 -0
package/dist/style-override.scss +1 -0
package/dist/tokens.css +144 -0
package/es/chunk-GBB7LDKQ.js +261 -0
package/es/chunk-MDI2SCUP.js +281 -0
package/es/chunk-QDTNMM7W.js +286 -0
package/es/chunk-YLNAFAWE.js +233 -0
package/es/common-preset.d.ts +38 -0
package/es/common-preset.js +157 -0
package/es/index.d.ts +32 -0
package/es/index.js +1 -0
package/es/presets/security.d.ts +16 -0
package/es/presets/security.js +99 -0
package/es/renderers-BFRSp2BH.d.ts +51 -0
package/es/renderers-DMZbi_Gs.d.ts +51 -0
package/es/renderers-DWhUlI2y.d.ts +47 -0
package/es/types-04qLKHMt.d.ts +62 -0
package/es/types-BrCPjAH6.d.ts +62 -0
package/es/types-QZ1gy9KX.d.ts +63 -0
package/examples/migration-operations-to-renderOps.md +107 -0
package/examples/wk-exempt.example.json +30 -0
package/mcp/server.js +394 -0
package/package.json +130 -0
package/reference/SelectPopupCom.vue +634 -0
package/reference/ag-cell-renders.ts +644 -0
package/reference/define-columns.ts +185 -0
package/reference/jhlc.d.ts +1 -0
package/scanner/coverage.mjs +287 -0
package/scanner/exempt.mjs +127 -0
package/scanner/fix.mjs +216 -0
package/scanner/index.mjs +403 -0
package/scanner/integration.mjs +155 -0
package/scanner/report.mjs +459 -0
package/scanner/rules/_shared.mjs +134 -0
package/scanner/rules/button.mjs +97 -0
package/scanner/rules/color.mjs +118 -0
package/scanner/rules/componentFamily.mjs +184 -0
package/scanner/rules/dialog.mjs +42 -0
package/scanner/rules/form.mjs +86 -0
package/scanner/rules/index.mjs +58 -0
package/scanner/rules/table.mjs +170 -0
package/scanner/rules/tag.mjs +245 -0
package/scanner/snapshot.mjs +198 -0
package/skills/_flows/full-audit.md +65 -0
package/skills/_flows/legacy-skin-align.md +71 -0
package/skills/_flows/new-project-init.md +80 -0
package/skills/_flows/progressive-migrate.md +49 -0
package/skills/_meta/_compat/README.md +47 -0
package/skills/_meta/_compat/editors.json +76 -0
package/skills/_meta/_compat/headers/agents.txt +7 -0
package/skills/_meta/_compat/headers/claude-code.txt +7 -0
package/skills/_meta/_compat/headers/cline.txt +7 -0
package/skills/_meta/_compat/headers/cursor-mdc.txt +5 -0
package/skills/_meta/_compat/headers/github-copilot.txt +5 -0
package/skills/_meta/_compat/headers/kiro.txt +4 -0
package/skills/_meta/_compat/headers/qoder.txt +4 -0
package/skills/_meta/_compat/headers/trae.txt +3 -0
package/skills/_meta/_compat/headers/windsurf.txt +5 -0
package/skills/_meta/_detection.md +81 -0
package/skills/_meta/_registry.md +96 -0
package/skills/element/component-family/SKILL.md +71 -0
package/skills/element/el-dialog/SKILL.md +124 -0
package/skills/element/el-form/SKILL.md +84 -0
package/skills/element/el-table/SKILL.md +86 -0
package/skills/element/el-tag/SKILL.md +127 -0
package/skills/layouts/detail-page/SKILL.md +99 -0
package/skills/layouts/form-dialog/SKILL.md +128 -0
package/skills/layouts/list-page/SKILL.md +111 -0
package/skills/layouts/tree-list/SKILL.md +108 -0
package/skills/ops/audit/SKILL.md +109 -0
package/skills/ops/fix/SKILL.md +52 -0
package/skills/ops/fix/USAGE.md +24 -0
package/skills/ops/migrate/SKILL.md +157 -0
package/skills/ops/scan/SKILL.md +71 -0
package/skills/ops/scan/USAGE.md +16 -0
package/skills/runtime/design-tokens/SKILL.md +88 -0
package/skills/runtime/design-tokens/USAGE.md +19 -0
package/skills/runtime/migration/SKILL.md +106 -0
package/skills/runtime/migration/USAGE.md +34 -0
package/skills/runtime/style-align/SKILL.md +124 -0
package/skills/runtime/style-align/USAGE.md +52 -0
package/skills/vendors/ag-grid/SKILL.md +94 -0
package/skills/vendors/base-table/SKILL.md +57 -0
package/skills/vendors/c-components/SKILL.md +36 -0
package/skills/vendors/custom-wrappers/SKILL.md +45 -0
package/skills/vendors/jh-components/SKILL.md +42 -0
package/skills/vendors/unknown-wrapper/SKILL.md +44 -0
package/standards/engineering/01-import-order.md +46 -0
package/standards/engineering/02-naming.md +54 -0
package/standards/engineering/03-scss-structure.md +59 -0
package/standards/ui/01-table.md +111 -0
package/standards/ui/02-button.md +83 -0
package/standards/ui/03-form.md +118 -0
package/standards/ui/04-tag-status.md +110 -0
package/standards/ui/05-dialog-pagination.md +118 -0
package/styles/element/_card.scss +26 -0
package/styles/element/_descriptions.scss +22 -0
package/styles/element/_dialog.scss +43 -0
package/styles/element/_drawer.scss +22 -0
package/styles/element/_feedback.scss +52 -0
package/styles/element/_form.scss +22 -0
package/styles/element/_navigation.scss +36 -0
package/styles/element/_overlay.scss +32 -0
package/styles/element/_pagination.scss +16 -0
package/styles/element/_steps.scss +32 -0
package/styles/element/_table.scss +13 -0
package/styles/element/_tabs.scss +40 -0
package/styles/element/_tree.scss +27 -0
package/styles/element/_upload.scss +34 -0
package/styles/element/index.scss +17 -0
package/styles/index.scss +21 -0
package/styles/layouts/_detail-page.scss +27 -0
package/styles/layouts/_form-dialog.scss +19 -0
package/styles/layouts/_list-page.scss +47 -0
package/styles/layouts/_tree-list.scss +33 -0
package/styles/layouts/index.scss +6 -0
package/styles/presets/element-only.scss +6 -0
package/styles/presets/full.scss +12 -0
package/styles/presets/security.scss +37 -0
package/styles/presets/skin.scss +14 -0
package/styles/presets/tokens-only.scss +7 -0
package/styles/tokens/index.scss +79 -0
package/styles/vendors/_ag-grid.scss +273 -0
package/styles/vendors/_base-components.scss +480 -0
package/styles/vendors/_base-query-toolbar.scss +253 -0
package/styles/vendors/_base-table.scss +41 -0
package/styles/vendors/_c-components.scss +34 -0
package/styles/vendors/_custom-wrappers.scss +30 -0
package/styles/vendors/_jh-drag-col.scss +63 -0
package/styles/vendors/_jh-pagination.scss +81 -0
package/styles/vendors/_jh-tree.scss +196 -0
package/styles/vendors/_portal.scss +114 -0
package/styles/vendors/index.scss +17 -0
package/templates/ag-grid-page/TPL-AG-GRID.md +76 -0
package/templates/form-dialog/TPL-FORM-DIALOG.md +165 -0
package/templates/list-page/TPL-LIST.md +139 -0
package/templates/tree-list/TPL-TREE-LIST.md +176 -0
package/templates/ui-optimization-report/TPL-UI-OPTIM-REPORT.md +343 -0

package/skills/_flows/full-audit.md ADDED Viewed

@@ -0,0 +1,65 @@
+---
+description: |
+  全量审计流程 — 不修改任何文件，输出按 layer/vendor 分层的可读报告。
+  适用：项目接入前评估、CI 检查、季度健康度盘点。
+applyTo: "**/*.{vue,scss}"
+---
+# Flow: full-audit
+> 纯审计流程（read-only）
+## 触发短语
+- "用 wk-ui 全量审计当前项目"
+- "audit 流程跑一下"
+- "出一份风格健康度报告"
+## 执行步骤
+### Phase 1 — 扫描全量
+```bash
+npx wk-ui scan --target src --outFile audit-report.md
+```
+### Phase 2 — 按层分组统计
+报告按以下维度汇总：
+| 维度 | 说明 |
+|---|---|
+| **Layer** | L0 tokens / L1 element / L2 vendors / L3 layouts |
+| **Vendor** | element / base-table / jh / c-prefix / custom / ag-grid |
+| **Severity** | error / warn / info |
+| **File** | 按文件归集，便于点选跳转 |
+### Phase 3 — 探测未识别封装
+- 扫描 `src/components/` 下 `.vue` 文件
+- 输出"未匹配 vendor skill"清单
+- 给出"是否扩展 skills/vendors/_registry.md"建议
+### Phase 4 — 探测未覆盖布局
+- 扫描页面级容器 class（`.list-*` / `.tree-*` 等）
+- 对比 `styles/layouts/` 已有骨架
+- 输出"是否新增 layouts/<name>.scss" 建议
+### Phase 5 — 输出建议清单
+```
+[audit] 总计：123 处问题
+  L0 tokens:  45 处（颜色硬编码）
+  L1 element: 56 处（size/对齐/empty-text）
+  L2 vendors: 22 处（base-table 12 / jh 7 / custom 3）
+  L3 layouts: 0 处
+[扩展建议]
+  - 发现未识别封装组件 3 个：<MyChart>, <RichEditor>, <TableExport>
+    → 建议在 skills/vendors/custom-wrappers/ 追加识别规则
+  - 发现新页面骨架 1 个：.dashboard-grid（src/views/dashboard）
+    → 建议在 styles/layouts/ 新增 _dashboard.scss
+```
+## 不做的事
+- ❌ 不修改任何文件
+- ❌ 不触发 fix
+- ❌ 仅诊断和建议

package/skills/_flows/legacy-skin-align.md ADDED Viewed

@@ -0,0 +1,71 @@
+---
+description: |
+  老项目化妆对齐流程 — 不破坏业务代码，仅注入 tokens + element + vendors 三层覆盖。
+  适用：不可全面改造的存量项目，只想统一视觉。
+applyTo: "**/*.{vue,scss,html}"
+---
+# Flow: legacy-skin-align
+> 化妆模式（Skin Mode）— 最大覆盖、最小侵入
+## 触发短语
+- "用 wk-ui 给这个老项目化妆对齐"
+- "legacy-skin 流程跑一下"
+- "skin mode 接入"
+## 执行步骤
+### Phase 0 — 安装/更新 Skill 与 MCP 配置
+```bash
+npx wk-ui init --project . --mode skin
+npx wk-ui doctor --project .
+```
+该命令会写入 AI 编辑器规则、触发提示、`.mcp.json` 和 `.wk-skills-ui-manifest.json`。已安装项目可改用 `npx wk-ui update --project .`。
+（AI 严格按序）
+### Phase 1 — 接入 tokens
+1. 检查 `index.html`，在 `<head>` 内追加：
+   ```html
+   <link rel="stylesheet" href="/node_modules/@agile-team/wk-skills-ui/design/tokens/base.css" />
+   ```
+2. 检查 `vite.config.ts` / `webpack` 是否能解析 `node_modules` 路径
+### Phase 2 — 接入 skin 预设
+1. 找到全局 SCSS 入口（`src/main.scss` / `src/styles/index.scss`）
+2. 在文件最顶部追加：
+   ```scss
+   @use '@agile-team/wk-skills-ui/styles/presets/skin' as *;
+   ```
+3. **不**引入 `layouts/` 层（避免和老项目布局冲突）
+### Phase 3 — 触发 vendors 层 skill 修复
+按优先级顺序，逐个 skill 触发：
+1. `vendors/base-table` — 修 BaseTable* 的 R001/R002/R003/R014
+2. `vendors/jh-components` — 修 jh-* 的 R006/R007/R011
+3. `vendors/c-components` — 修 C_*/c_* 的对齐
+4. `vendors/custom-wrappers` — 兜底自封装
+5. `vendors/ag-grid` — 修 AG Grid 列对齐
+### Phase 4 — 触发 element 层 skill 修复
+针对原生使用的 el-* 控件：
+- `element/el-table` → R001/R002/R014
+- `element/el-form` → R006/R008
+- `element/el-dialog` → R011/R015
+- `element/el-tag` → R009/R010
+### Phase 5 — 触发 tokens 层修复
+- `runtime/design-tokens` → R016/R017/R018（颜色硬编码 → CSS 变量）
+### Phase 6 — 不做的事
+- ❌ **不要**重写业务代码逻辑
+- ❌ **不要**替换组件为 runtime API（那是 native mode 的事）
+- ❌ **不要**修改业务 layout 容器 class
+## 完成后输出
+- 报告：分层统计修复条目
+- 建议：哪些封装组件适合下一阶段"原生迁移"

package/skills/_flows/new-project-init.md ADDED Viewed

@@ -0,0 +1,80 @@
+---
+description: |
+  新项目原生接入流程 — 从零搭建一个符合团队规范的 Vue + Element Plus 项目。
+  接入完整 5 层（tokens + element + vendors + layouts + runtime），最大化业务代码精简。
+applyTo: "**/*.{vue,ts,scss,html}"
+---
+# Flow: new-project-init
+> 原生模式（Native Mode）— 完整接入
+## 触发短语
+- "用 wk-ui 给新项目接入"
+- "new-project 流程跑一下"
+- "native mode 完整接入"
+## 执行步骤
+### Phase 0 — 安装/更新 Skill 与 MCP 配置
+```bash
+npx wk-ui init --project . --mode native
+npx wk-ui doctor --project .
+```
+该命令会写入 AI 编辑器规则、触发提示、`.mcp.json` 和 `.wk-skills-ui-manifest.json`。已安装项目可改用 `npx wk-ui update --project .`。
+### Phase 1 — 安装包
+```bash
+pnpm add @agile-team/wk-skills-ui
+```
+### Phase 2 — 注入 tokens
+`index.html` `<head>`：
+```html
+<link rel="stylesheet" href="/node_modules/@agile-team/wk-skills-ui/design/tokens/base.css" />
+```
+### Phase 3 — 接入完整样式
+`src/styles/index.scss`：
+```scss
+@use '@agile-team/wk-skills-ui/styles' as *;   // 等价于 presets/full
+```
+### Phase 4 — 接入 runtime
+`src/main.ts`：
+```ts
+import { installCommonPreset } from '@agile-team/wk-skills-ui/runtime/common-preset';
+installCommonPreset();
+```
+### Phase 5 — 使用模板生成第一个页面
+- 列表页：参考 `templates/list-page/TPL-LIST.md`
+- 表单弹窗：参考 `templates/form-dialog/TPL-FORM-DIALOG.md`
+- 左树右表：参考 `templates/tree-list/TPL-TREE-LIST.md`
+- AG Grid 页：参考 `templates/ag-grid-page/TPL-AG-GRID.md`
+### Phase 6 — 业务定制 preset（按需）
+```bash
+npx wk-ui add-preset my-biz
+# 生成 runtime/presets/my-biz.ts，自定义业务字段映射
+```
+### Phase 7 — CI 接入
+`package.json` `scripts`：
+```json
+{
+  "ui:check": "wk-ui check --project .",
+  "ui:fix":   "wk-ui fix --target src --dry-run"
+}
+```
+## 完成后
+新项目应做到：
+- 业务代码不写颜色硬编码（用 CSS 变量）
+- 列表页用 `defineColumns()` + `renderOps()` 风格
+- 控件全部用 `size="small"`、日期 `width:100%`、表单 `label-width="150px"`

package/skills/_flows/progressive-migrate.md ADDED Viewed

@@ -0,0 +1,49 @@
+---
+description: |
+  渐进式迁移流程 — 把 vendor 封装组件逐步替换为 runtime API（拿到源码后的演进路径）。
+applyTo: "**/*.{vue,ts}"
+---
+# Flow: progressive-migrate
+> 从 L2 vendors 升级到 L4 runtime（业务代码大幅精简）
+## 触发短语
+- "用 wk-ui 把这个文件迁移到 runtime"
+- "progressive-migrate 流程跑一下"
+## 前置条件
+- 已经接入 wk-skills-ui
+- 已经拿到目标封装组件的源码控制权（或确认可改造）
+## 执行步骤
+### Phase 1 — 选定一个文件 / 一个组件
+- 优先选页面文件（小范围）
+- 列表页 / 表单 / 弹窗皆可
+### Phase 2 — 列定义改造
+- `<el-table-column prop="status" />` + 自定义 slot
+  → `defineColumns([{ name: 'status', ... }])` + 自动 COLUMN_AUTO_MAP
+### Phase 3 — 操作列改造
+- `<el-button @click="...">查看</el-button>` 串
+  → `renderOps([{ type: 'view', onClick: ... }, ...])`
+### Phase 4 — 字段映射改造
+- 业务自定义状态字段 → 注册到 `installCommonPreset` 之外的 `add-preset`
+  ```bash
+  npx wk-ui add-preset my-biz
+  ```
+### Phase 5 — 验证
+- 业务功能不变
+- DOM 类名继续匹配 vendors/* 全局样式
+- scanner 报告无 L1/L2 违规
+## 注意
+- 一次只迁一个文件，提交一次，方便回退
+- vendors/ 全局样式保留，确保未迁移的页面继续生效

package/skills/_meta/_compat/README.md ADDED Viewed

@@ -0,0 +1,47 @@
+# 多编辑器兼容指南
+wk-skills-ui 的 Skills 可通过 `wk-ui init/update` 安装到不同 AI 编辑器。兼容层只负责“把同一套 Skill 知识转换成编辑器可识别的规则文件”，不绑定任何具体业务项目。
+## 支持的编辑器
+| 编辑器 | 安装路径 | 形式 | 说明 |
+|---|---|---|---|
+| GitHub Copilot | `.github/instructions/wk-skills/*.instructions.md` | 多文件 | 使用 `applyTo` frontmatter |
+| Cursor | `.cursor/rules/*.mdc` | 多文件 | 使用 mdc frontmatter |
+| Windsurf | `.windsurf/rules/*.md` | 多文件 | 纯 Markdown 规则 |
+| Kiro | `.kiro/steering/*.md` | 多文件 | steering 文档 |
+| Trae | `.trae/rules/*.md` | 多文件 | description frontmatter |
+| Claude Code | `CLAUDE.md` | 单文件 | 合并全部 Skill，适合 Claude Code 自动加载 |
+| Cline | `.clinerules` | 单文件 | 合并全部 Skill |
+| Generic Agents | `AGENTS.md` | 单文件 | 通用 Agent 协议 |
+| Qoder | `.qoder/rules/*.md` | 多文件 | Qoder 项目规则 |
+## 常用命令
+```bash
+# 自动检测编辑器并安装
+npx wk-ui init --project .
+# 指定编辑器
+npx wk-ui init --project . --editor github-copilot
+npx wk-ui init --project . --editor claude-code
+npx wk-ui init --project . --editor cline
+npx wk-ui init --project . --editor agents-generic
+npx wk-ui init --project . --editor qoder
+# 增量更新 / 对比 / 清理
+npx wk-ui update --project .
+npx wk-ui diff --project .
+npx wk-ui clean --project . --dry-run
+```
+## 安装时还会写入
+- `.github/wk-skills-ui/TRIGGER_PROMPTS.md`：AI 触发提示
+- `.github/wk-skills-ui/README.md`：业务项目内说明
+- `.mcp.json`：`wk-skills-ui` MCP Server 配置
+- `.wk-skills-ui-manifest.json`：安装清单，供 `update/diff/clean/doctor` 使用
+## 格式模板
+各编辑器的头模板位于 `headers/`。`wk-ui init/update` 会读取对应 `headers/*.txt`，再拼接 Skill 主体内容生成目标文件。新增编辑器时只需增加 header 并在 CLI/注册表中声明安装路径。

package/skills/_meta/_compat/editors.json ADDED Viewed

@@ -0,0 +1,76 @@
+{
+  "editors": [
+    {
+      "id": "github-copilot",
+      "name": "GitHub Copilot",
+      "description": "VS Code GitHub Copilot Chat Agent 模式",
+      "skillFormat": "SKILL.md with YAML frontmatter (applyTo: glob)",
+      "installPath": ".github/instructions/wk-skills/",
+      "headerFile": "headers/github-copilot.txt"
+    },
+    {
+      "id": "cursor",
+      "name": "Cursor",
+      "description": "Cursor AI 编辑器 .mdc 规则文件",
+      "skillFormat": ".mdc files with YAML frontmatter (globs:)",
+      "installPath": ".cursor/rules/",
+      "headerFile": "headers/cursor-mdc.txt"
+    },
+    {
+      "id": "windsurf",
+      "name": "Windsurf",
+      "description": "Windsurf AI 编辑器规则文件",
+      "skillFormat": "Plain markdown, no frontmatter",
+      "installPath": ".windsurf/rules/",
+      "headerFile": "headers/windsurf.txt"
+    },
+    {
+      "id": "kiro",
+      "name": "Kiro",
+      "description": "Kiro AI 编辑器 steering 文档",
+      "skillFormat": "Markdown with YAML frontmatter (inclusion: manual)",
+      "installPath": ".kiro/steering/",
+      "headerFile": "headers/kiro.txt"
+    },
+    {
+      "id": "trae",
+      "name": "Trae",
+      "description": "Trae AI 编辑器规则文件",
+      "skillFormat": "Markdown with description frontmatter",
+      "installPath": ".trae/rules/",
+      "headerFile": "headers/trae.txt"
+    },
+    {
+      "id": "claude-code",
+      "name": "Claude Code",
+      "description": "Claude Code 项目规则文件",
+      "skillFormat": "Plain markdown",
+      "installPath": "./",
+      "headerFile": "headers/claude-code.txt"
+    },
+    {
+      "id": "cline",
+      "name": "Cline",
+      "description": "Cline 规则文件",
+      "skillFormat": "Plain markdown",
+      "installPath": "./",
+      "headerFile": "headers/cline.txt"
+    },
+    {
+      "id": "agents-generic",
+      "name": "Generic Agents",
+      "description": "AGENTS.md 通用代理协议",
+      "skillFormat": "Plain markdown",
+      "installPath": "./",
+      "headerFile": "headers/agents.txt"
+    },
+    {
+      "id": "qoder",
+      "name": "Qoder",
+      "description": "Qoder IDE 规则文件",
+      "skillFormat": "Markdown with description frontmatter",
+      "installPath": ".qoder/rules/",
+      "headerFile": "headers/qoder.txt"
+    }
+  ]
+}

package/skills/_meta/_compat/headers/agents.txt ADDED Viewed

@@ -0,0 +1,7 @@
+# AGENTS.md — UI 风格对齐代理协议
+> 此文件遵循 agents.md 跨编辑器协议，可被任意支持该协议的 AI 代理读取。
+> 由 @agile-team/wk-skills-ui 自动生成。更新方式：npx wk-ui update
+---

package/skills/_meta/_compat/headers/claude-code.txt ADDED Viewed

@@ -0,0 +1,7 @@
+# Claude Code UI 风格对齐规则
+> 由 @agile-team/wk-skills-ui 自动生成。请勿手动编辑。
+> 更新方式：npx wk-ui update
+---

package/skills/_meta/_compat/headers/cline.txt ADDED Viewed

@@ -0,0 +1,7 @@
+# Cline UI 风格对齐规则
+> 由 @agile-team/wk-skills-ui 自动生成。请勿手动编辑。
+> 更新方式：npx wk-ui update
+---

package/skills/_meta/_compat/headers/cursor-mdc.txt ADDED Viewed

@@ -0,0 +1,5 @@
+---
+description: {SKILL_DESCRIPTION}
+globs: {APPLY_GLOB}
+alwaysApply: false
+---

package/skills/_meta/_compat/headers/github-copilot.txt ADDED Viewed

@@ -0,0 +1,5 @@
+---
+description: |
+  {SKILL_DESCRIPTION}
+applyTo: "{APPLY_GLOB}"
+---

package/skills/_meta/_compat/headers/kiro.txt ADDED Viewed

@@ -0,0 +1,4 @@
+---
+inclusion: manual
+description: {SKILL_DESCRIPTION}
+---

package/skills/_meta/_compat/headers/qoder.txt ADDED Viewed

@@ -0,0 +1,4 @@
+---
+description: {SKILL_DESCRIPTION}
+---

package/skills/_meta/_compat/headers/trae.txt ADDED Viewed

@@ -0,0 +1,3 @@
+---
+description: {SKILL_DESCRIPTION}
+---

package/skills/_meta/_compat/headers/windsurf.txt ADDED Viewed

@@ -0,0 +1,5 @@
+# {SKILL_NAME}
+<!-- Windsurf 规则文件：直接放入 .windsurf/rules/ 目录，无需 frontmatter -->
+<!-- 文件名建议：wk-skills-{skill-id}.md -->

package/skills/_meta/_detection.md ADDED Viewed

@@ -0,0 +1,81 @@
+# Detection Cheatsheet — 全 vendor 识别特征速查表
+> 供 AI 快速判定一个组件标签属于哪个 layer / vendor
+## L1 — Element Plus 原生
+| 标签                                                                                               | Skill                                                  |
+| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
+| `<el-table>` `<el-table-column>`                                                                   | element/el-table                                       |
+| `<el-form>` `<el-form-item>`                                                                       | element/el-form                                        |
+| `<el-dialog>`                                                                                      | element/el-dialog                                      |
+| `<el-tag>`                                                                                         | element/el-tag                                         |
+| `<el-button>`                                                                                      | element/el-table（操作列） / element/el-button（独立） |
+| `<el-input>` `<el-select>` `<el-date-picker>`                                                      | element/el-form                                        |
+| `<el-pagination>`                                                                                  | element/el-dialog（位置约束）                          |
+| `<el-tree>`                                                                                        | element/el-tree                                        |
+| `<el-message-box>` `ElMessageBox.*`                                                                | element/el-dialog                                      |
+| `<el-card>`                                                                                        | element/el-card                                        |
+| `<el-tabs>` `<el-tab-pane>`                                                                        | element/el-tabs                                        |
+| `<el-descriptions>` `<el-descriptions-item>`                                                       | element/el-descriptions                                |
+| `<el-drawer>`                                                                                      | element/el-drawer                                      |
+| `<el-upload>`                                                                                      | element/el-upload                                      |
+| `<el-steps>` `<el-step>`                                                                           | element/el-steps                                       |
+| `<el-popover>` `<el-tooltip>` `<el-dropdown>`                                                      | element/el-overlay                                     |
+| `<el-menu>` `<el-menu-item>` `<el-sub-menu>` `<el-breadcrumb>`                                     | element/el-navigation                                  |
+| `<el-empty>` `<el-result>` `<el-alert>` `<el-badge>` `<el-avatar>` `<el-timeline>` `<el-collapse>` | element/el-feedback                                    |
+## L2 — Vendor 封装
+| 前缀 / 标签                                                            | 优先级 | Skill                                      |
+| ---------------------------------------------------------------------- | ------ | ------------------------------------------ |
+| `<BaseTable>` `<base-table>` `<BaseDataTable>`                         | #1     | vendors/base-table                         |
+| `<BaseQuery>` `<BaseToolbar>` `<base-*>` 其它                          | #1     | vendors/base-components（暂随 base-table） |
+| `<jh-table>` `<jh-form>` `<jh-tree>` `<jh-pagination>` `<jh-drag-col>` | #2     | vendors/jh-components                      |
+| `<C_*>` `<c-*>`                                                        | #3     | vendors/c-components                       |
+| `src/components/PascalCase.vue` 无前缀                                 | #4     | vendors/custom-wrappers                    |
+| `.ag-root-wrapper` / AG Grid API                                       | —      | vendors/ag-grid                            |
+| Portal/Popper 弹层（teleport）                                         | —      | 使用 styles/vendors/\_portal.scss          |
+| 不匹配以上任何一种                                                     | —      | vendors/unknown-wrapper（兜底）            |
+## L3 — Layout 骨架
+| 类名 / 容器                            | Skill                             |
+| -------------------------------------- | --------------------------------- |
+| `.list-page` 或 搜索+表格+分页结构     | layouts/list-page                 |
+| `.tree-list` 或 `.drag-col-container`  | layouts/tree-list                 |
+| `.form-dialog` 或 el-dialog 内 el-form | layouts/form-dialog               |
+| `.detail-page` 或 描述列表 + 卡片      | layouts/detail-page               |
+| 未匹配                                 | 输出"建议在 styles/layouts/ 新增" |
+## B 端业务场景
+| 结构特征                        | 场景              | 推荐 Skill               |
+| ------------------------------- | ----------------- | ------------------------ |
+| 查询表单 + 表格                 | query-table       | layouts/list-page        |
+| 工具栏 / 批量操作栏             | toolbar-actions   | layouts/list-page        |
+| 树 + 表格 / BaseTable           | tree-table        | layouts/tree-list        |
+| el-dialog + el-form             | dialog-form       | layouts/form-dialog      |
+| el-drawer + 表单/详情           | drawer-detail     | layouts/detail-page      |
+| el-card + el-descriptions       | detail-card       | layouts/detail-page      |
+| el-tabs + 表格/详情/表单        | tab-workbench     | element/component-family |
+| el-upload                       | attachment-upload | element/component-family |
+| el-steps / el-timeline          | process-flow      | element/component-family |
+| el-empty / el-result / el-alert | feedback-state    | element/component-family |
+## L0 — Tokens
+| 模式                     | Rule |
+| ------------------------ | ---- |
+| `<style>` 块内 hex 颜色  | R016 |
+| `<template>` 内 hex 颜色 | R017 |
+| `<script>` 内 hex 颜色   | R018 |
+## 扩展机制
+发现新模式时：
+1. 在本表追加一行
+2. 在 `styles/vendors/` 或 `styles/layouts/` 追加对应 SCSS
+3. 在 `skills/vendors/` 或 `skills/layouts/` 追加 SKILL.md
+4. 在 `scanner/rules/` 追加规则（带 layer + vendor 元数据）

package/skills/_meta/_registry.md ADDED Viewed

@@ -0,0 +1,96 @@
+# Skills Registry — wk-skills-ui v1.3
+> 全部可被 AI 编辑器加载的 skill 索引，按 5 层架构组织。
+## 五层架构总览
+```
+L0 tokens   → 设计令牌（颜色/间距/圆角/字号）
+L1 element  → Element Plus 控件对齐
+L2 vendors  → 封装组件化妆（Base / jh / C_/c_ / custom + AG Grid）
+L3 layouts  → 团队约定页面骨架
+L4 runtime  → 业务渲染 API（defineColumns / renderOps / preset）
+```
+## 入口（Flows · 组合流程）
+| Flow                                                            | 适用                 |
+| --------------------------------------------------------------- | -------------------- |
+| [\_flows/new-project-init](../_flows/new-project-init.md)       | 新项目从零接入       |
+| [\_flows/legacy-skin-align](../_flows/legacy-skin-align.md)     | 老项目化妆模式       |
+| [\_flows/full-audit](../_flows/full-audit.md)                   | 全量审计（不修）     |
+| [\_flows/progressive-migrate](../_flows/progressive-migrate.md) | 渐进式迁移到 runtime |
+## 单点 Skills（按层）
+### L1 element/
+| Skill                    | 处理规则                                                 |
+| ------------------------ | -------------------------------------------------------- |
+| element/el-table         | R001 R002 R003 R014                                      |
+| element/el-form          | R006 R007 R008                                           |
+| element/el-dialog        | R011 R015                                                |
+| element/el-tag           | R009 R010                                                |
+| element/component-family | R031-R037，首批 B 端高频 Element Plus 组件族聚合治理入口 |
+| element/el-card          | 卡片容器、详情卡片、统计卡片样式管控                     |
+| element/el-tabs          | Tab 详情页、配置页、主从切换样式管控                     |
+| element/el-descriptions  | 详情页、只读展示区样式管控                               |
+| element/el-tree          | 左树右表、组织树、区域树样式管控                         |
+| element/el-drawer        | 抽屉详情、抽屉编辑样式管控                               |
+| element/el-upload        | 附件上传、图片上传、文件列表样式管控                     |
+| element/el-steps         | 审批流、流程状态样式管控                                 |
+| element/el-overlay       | popover/tooltip/dropdown 弹层样式管控                    |
+| element/el-navigation    | menu/breadcrumb 导航样式管控                             |
+| element/el-feedback      | empty/result/alert/badge/timeline 反馈样式管控           |
+### L2 vendors/
+| Skill                   | 优先级 | 说明           |
+| ----------------------- | ------ | -------------- |
+| vendors/base-table      | #1     | Base\* 系列    |
+| vendors/jh-components   | #2     | jh-\* 系列     |
+| vendors/c-components    | #3     | C*/c* 前缀     |
+| vendors/custom-wrappers | #4     | 兜底（无前缀） |
+| vendors/unknown-wrapper | —      | 兜底探测       |
+| vendors/ag-grid         | —      | AG Grid        |
+### L3 layouts/
+| Skill               | 说明                                      |
+| ------------------- | ----------------------------------------- |
+| layouts/list-page   | 列表页骨架（搜索 + 工具栏 + 表格 + 分页） |
+| layouts/tree-list   | 左树右表双栏骨架（含 jh-drag-col）        |
+| layouts/form-dialog | 新增/编辑/详情三态表单弹窗                |
+| layouts/detail-page | 只读展示页（el-descriptions 为主）        |
+### L4 runtime/
+| Skill                 | 说明                         |
+| --------------------- | ---------------------------- |
+| runtime/style-align   | 主样式对齐 skill（聚合入口） |
+| runtime/design-tokens | R016 R017 R018 颜色 token    |
+| runtime/migration     | 从零迁入 / 渐进迁移指南      |
+### Ops/
+| Skill              | 用途                                                 |
+| ------------------ | ---------------------------------------------------- |
+| ops/scan           | 扫描诊断                                             |
+| ops/fix            | 自动修复                                             |
+| ops/audit          | 只读全量审计 + 报告                                  |
+| ops/migrate        | 渐进迁移（skin → native）                            |
+| ops/route-intent   | 自然语言意图识别，推荐 flow/tool/skill               |
+| ops/recommend-flow | 根据扫描 JSON 推荐 nextActions 与 wl-skills-kit 桥接 |
+## 多编辑器适配
+详见 [`_compat/README`](../_compat/README.md)：支持 GitHub Copilot / Cursor / Windsurf / Kiro / Trae。
+## 扩展机制
+新增 skill 步骤：
+1. 在对应 layer 目录建子目录 + `SKILL.md`
+2. 更新本文件索引
+3. 必要时更新 `_detection.md` 识别表
+4. 必要时更新 `scanner/rules/` 规则（带 layer + vendor 元数据）