@agile-team/wl-skills-ui 1.6.2

package/skills/ops/scan/SKILL.md

@@ -0,0 +1,71 @@
+---
+description: |
+  wk-ui scan 扫描器使用指南 — 如何运行风格扫描、接入完整性检查，解读报告格式。
+applyTo: "**"
+---
+
+# 扫描器使用指南
+
+## 命令速查
+
+```bash
+# 一站式（推荐）：接入完整性 + 风格扫描 + 生成 Markdown 报告
+npx wk-ui all --project . --outFile report.md
+
+# 仅风格扫描
+npx wk-ui scan --target src
+
+# 仅接入完整性检查（I001~I004）
+npx wk-ui check --project .
+
+# JSON 格式输出（方便程序处理）
+npx wk-ui scan --target src --output json
+```
+
+## 参数说明
+
+| 参数              | 默认值                   | 说明                                           |
+| ----------------- | ------------------------ | ---------------------------------------------- |
+| `--target`        | `./src`                  | Vue 文件扫描根目录                             |
+| `--project`       | `.`                      | 项目根目录（用于接入完整性检查）               |
+| `--output`        | `markdown`               | 输出格式：`markdown` \| `json`                 |
+| `--exclude`       | `node_modules,dist,.git` | 排除目录（逗号分隔）                           |
+| `--outFile`       | `""`                     | 写入文件路径，为空则输出到 stdout              |
+| `--fail-on-error` | `false`                  | 存在 error 级别问题时以非零退出码退出（CI 用） |
+
+## CI 集成
+
+```yaml
+# .github/workflows/style-check.yml
+- name: wk-skills-ui 风格检查
+  run: npx wk-ui all --project . --fail-on-error
+```
+
+## 报告格式说明
+
+```
+一、接入完整性仪表盘
+  ✅ I001 — tokens.css 已在 index.html 引入
+  ✅ I002 — 全局 SCSS 已引入 wk-skills-ui 样式
+  ✅ I003 — runtime 已被引用
+  ✅ I004 — peerDependencies 版本满足要求
+
+二、风格扫描摘要
+  扫描文件数：43  总问题数：127
+
+三、按规则统计
+  | 规则 | 类别 | 严重级 | 问题数 |
+  ...
+
+四、问题明细（按严重级）
+  ### error
+  - src/views/check/list.vue:34 [R001] el-table-column 缺少 align="center"
+  ...
+```
+
+## 退出码
+
+| 退出码 | 含义                                             |
+| ------ | ------------------------------------------------ |
+| `0`    | 扫描完成（无论是否有问题，除非 --fail-on-error） |
+| `1`    | 存在 error 级别问题且设置了 --fail-on-error      |

package/skills/ops/scan/USAGE.md

@@ -0,0 +1,16 @@
+# USAGE — 扫描器 Skill
+
+## 调用方式
+
+```
+扫描一下这个项目的 UI 问题
+帮我检查接入是否完整
+生成一份扫描报告
+```
+
+## 一行命令
+
+```bash
+# 一站式扫描并保存报告
+npx wk-ui all --project . --outFile /tmp/wk-scan-$(date +%Y%m%d).md
+```

package/skills/runtime/design-tokens/SKILL.md

@@ -0,0 +1,88 @@
+---
+description: |
+  设计 Token 使用规范 Skill — 确保颜色、间距、字体全部通过 CSS 变量引用，
+  不使用任何硬编码 hex 值。包含 Token 速查表、扫描规则 R016/R017/R018 详细说明。
+applyTo: "**/*.{vue,scss,css}"
+---
+
+# 设计 Token 使用规范
+
+## 核心原则
+
+**任何 hex 颜色值在业务代码中都是禁止的**，必须使用 `--el-color-*` CSS 变量。
+
+---
+
+## Token 速查表
+
+### 品牌色
+
+```css
+--el-color-primary        /* #4368ff — 主色：按钮/链接/激活 */
+--el-color-primary-light-9 /* #f0f3ff — 主色浅底：Tag背景 */
+--el-color-success        /* #0cc859 — 成功/正常/启用 */
+--el-color-warning        /* #ffaf27 — 警告/待处理 */
+--el-color-danger         /* #FB2323 — 危险/失败/停用 */
+--el-color-info           /* #909399 — 中性/辅助 */
+```
+
+### 文本色
+
+```css
+--el-text-color-primary    /* rgba(0,0,0,0.85) — 主要文本 */
+--el-text-color-regular    /* rgba(0,0,0,0.65) — 次要文本 */
+--el-text-color-secondary  /* rgba(0,0,0,0.45) — 辅助文本 */
+```
+
+### 边框/填充
+
+```css
+--el-border-color          /* #d9d9d9 */
+--el-fill-color-lighter    /* 表格 header 背景 */
+```
+
+---
+
+## 常见违规与修正
+
+```diff
+/* R016: style 块 */
+- color: #4368ff;
++ color: var(--el-color-primary);
+
+- background: #fb2323;
++ background: var(--el-color-danger);
+
+- border-color: #0cc859;
++ border-color: var(--el-color-success);
+
+/* R017: template 内联 style */
+- <span :style="{ color: '#ffaf27' }">
++ <span :style="{ color: 'var(--el-color-warning)' }">
+
+/* R018: script 中 ECharts 等配置 */
+- color: '#4368ff'
++ color: 'var(--el-color-primary)'  /* 或使用 CHART_COLORS.primary */
+```
+
+---
+
+## 扫描与自动修复
+
+```bash
+# 检测 hex 颜色违规
+npx wk-ui scan --target src --outFile color-report.md
+
+# 自动修复（仅修已知 Token 的 hex，不修 ECharts 等特殊场景）
+npx wk-ui fix --target src
+```
+
+## 已覆盖的 hex 映射
+
+| hex                           | → CSS Token                       |
+| ----------------------------- | --------------------------------- |
+| `#409eff` `#3a7afe` `#4368ff` | `var(--el-color-primary)`         |
+| `#fb2323` `#f56c6c`           | `var(--el-color-danger)`          |
+| `#0cc859` `#67c23a`           | `var(--el-color-success)`         |
+| `#ffaf27` `#e6a23c`           | `var(--el-color-warning)`         |
+| `#ecf5ff`                     | `var(--el-color-primary-light-9)` |

package/skills/runtime/design-tokens/USAGE.md

@@ -0,0 +1,19 @@
+# USAGE — 设计 Token Skill
+
+## 调用方式
+
+```
+帮我检查这个文件里有没有硬编码颜色
+把 src/views/ 下所有硬编码 hex 替换为 CSS Token
+```
+
+## 一行修复命令
+
+```bash
+# 扫描
+npx wk-ui scan --target src --output json | grep '"rule":"R01[678]"'
+
+# 修复（会替换所有已知映射的 hex）
+npx wk-ui fix --target src --dry-run   # 先 dry-run 看效果
+npx wk-ui fix --target src             # 确认后执行
+```

package/skills/runtime/migration/SKILL.md

@@ -0,0 +1,106 @@
+---
+description: |
+  历史项目 UI 全量迁移 Skill — 针对从旧版本（无 wk-skills-ui）升级到标准规范的完整改造流程。
+  包含：依赖安装、tokens 接入、SCSS 替换、runtime 注册、columnsDef 迁移、全量扫描验证。
+applyTo: "**"
+---
+
+# 历史项目 UI 迁移 Skill
+
+## 适用场景
+
+- 已有业务系统从零接入 wk-skills-ui
+- 旧版 jh-ui 系统升级到新规范
+- 统一多个历史项目到同一 UI 标准
+
+---
+
+## 迁移五步法
+
+### Step 1 — 安装依赖
+
+```bash
+pnpm add @agile-team/wk-skills-ui
+```
+
+### Step 2 — 接入 CSS Tokens
+
+在 `index.html` `<head>` 最顶部追加（必须在所有样式之前）：
+
+```html
+<link
+  rel="stylesheet"
+  href="/node_modules/@agile-team/wk-skills-ui/design/tokens/base.css"
+/>
+```
+
+### Step 3 — 替换 SCSS 入口
+
+在全局 SCSS 入口（`src/assets/style/main.scss` 或 `src/styles/index.scss`）追加：
+
+```scss
+@use "@agile-team/wk-skills-ui/styles" as *;
+// 可选 portal 视觉增强：
+// @use '@agile-team/wk-skills-ui/styles/portal';
+```
+
+> 注意：如果项目有旧的 element-plus 覆盖样式，确认无冲突后可删除旧样式。
+
+### Step 4 — 注册运行时预设
+
+在 `src/main.ts` 中（`app.mount` 之前）：
+
+```typescript
+import { installCommonPreset } from "@agile-team/wk-skills-ui/runtime/common-preset";
+installCommonPreset();
+```
+
+这会把所有通用业务字段（riskLevel / permitStatus / trainStatus 等）
+注册进 COLUMN_AUTO_MAP，之后使用 `defineColumns()` 包裹的列定义会自动渲染。
+
+### Step 5 — 迁移 columnsDef
+
+将所有 `defineColumns()` 调用从本地 `src/util/define-columns.ts` 改为 package：
+
+```typescript
+// ❌ 旧写法
+import { defineColumns } from "@/util/define-columns";
+import { renderOps } from "@/util/ag-cell-renders";
+
+// ✅ 新写法
+import { defineColumns, renderOps } from "@agile-team/wk-skills-ui/runtime";
+```
+
+然后运行扫描：
+
+```bash
+npx wk-ui all --project . --outFile migration-report.md
+```
+
+按报告逐步修复 R001~R018 违规项。
+
+---
+
+## 验收检查清单
+
+```bash
+npx wk-ui check --project .
+```
+
+所有 I001~I004 必须全部通过：
+
+- ✅ I001：`index.html` 中存在 `tokens.css` link 标签
+- ✅ I002：全局 SCSS 中引入 wk-skills-ui 样式
+- ✅ I003：`runtime` 已被引用（ag-cell-renders 或 package import）
+- ✅ I004：peer dependencies 版本满足要求
+
+---
+
+## 常见迁移问题
+
+| 问题                          | 解决方案                                          |
+| ----------------------------- | ------------------------------------------------- |
+| 旧版 ag-cell-renders.ts 冲突  | 删除本地文件，全部改用 package import             |
+| SCSS `@use` vs `@import` 冲突 | 统一改为 `@use`，避免重复引入                     |
+| ElTagType 类型报错            | 确保 element-plus ≥ 2.2，不使用已废弃的 `""` type |
+| defineColumns 自动映射未生效  | 确认 `installCommonPreset()` 在 `mount` 前调用      |

package/skills/runtime/migration/USAGE.md

@@ -0,0 +1,34 @@
+# USAGE — 历史项目迁移 Skill
+
+## 调用方式
+
+```
+帮我把这个旧项目接入 wk-skills-ui
+这个项目还没有用统一风格库，帮我按标准接入
+```
+
+## 快速迁移命令序列
+
+```bash
+# 1. 安装
+pnpm add @agile-team/wk-skills-ui
+
+# 2. 接入完整性检查（看缺什么）
+npx wk-ui check --project .
+
+# 3. 按 check 输出逐步补齐 Step 2~5
+
+# 4. 全量扫描
+npx wk-ui all --project . --outFile report.md
+
+# 5. 批量修复 A 类问题
+npx wk-ui fix --target src
+```
+
+## 预计工作量参考
+
+| 项目规模           | Vue 文件数 | 预计迁移时间 |
+| ------------------ | ---------- | ------------ |
+| 小型               | < 50       | 1~2 小时     |
+| 中型               | 50~150     | 半天         |
+| 大型（如 wl-safe） | > 150      | 1~2 天       |

package/skills/runtime/style-align/SKILL.md

@@ -0,0 +1,124 @@
+---
+description: |
+  UI 风格对齐 Skill — 扫描业务系统 Vue SFC 文件，识别与 wk-skills-ui 标准不一致的写法，
+  生成整改清单，经用户确认后执行自动修复，最终验证归零。
+  覆盖：表格对齐/空状态、按钮图标化、表单控件尺寸、弹窗分页位置、颜色 Token。
+applyTo: "**/*.vue"
+---
+
+# UI 风格对齐 Skill
+
+## 一、工作流程（严格按顺序，不得跳过）
+
+### Phase 1 — 扫描（只读，不修改任何文件）
+
+```bash
+# 推荐：一站式扫描（接入完整性 + 风格 + 报告）
+npx wk-ui all --project [项目根目录] --outFile /tmp/scan-result.md
+
+# 单独风格扫描
+npx wk-ui scan --target [项目src目录] --outFile /tmp/scan-result.md
+
+# 接入完整性检查
+npx wk-ui check --project [项目根目录]
+```
+
+读取扫描输出，提取：
+
+- 接入完整性 I001~I004 通过情况
+- 总 issue 数、按规则分类统计（R001~R018）
+- 每个 issue：文件路径 + 行号 + 规则 + 建议
+
+### Phase 2 — 汇报
+
+向用户展示摘要：
+
+```
+扫描结果摘要
+- 扫描文件数：XX
+- 发现问题数：XX（高危 X / 中危 X / 低危 X）
+
+高危（直接影响视觉一致性）
+| 规则 | 说明 | 数量 | 代表文件 |
+...
+```
+
+### Phase 3 — 确认（强制门槛）
+
+询问用户：
+
+1. 是否全量修复？还是指定规则/文件？
+2. 无法自动修复的规则（R008/R009/R010/R013）是否手动处理？
+
+**未经用户确认，禁止修改任何文件。**
+
+### Phase 4 — 修复
+
+按确认范围执行：
+
+- **A 类（attr 缺失 / hex 颜色）** → `npx wk-ui fix --target [src] [--dry-run]`
+- **B 类（结构改造，R004/R013/R015）** → AI 逐文件编辑
+
+每修复一个文件，输出该文件修改摘要。
+
+### Phase 5 — 验证
+
+重新执行 Phase 1 扫描，验证 issue 数量归零或达到预期水平。
+
+---
+
+## 二、规则速查（R001—R018）
+
+### 表格类 → 详见 [skills/components/table/SKILL.md](../../components/table/SKILL.md)
+
+- **R001**【高危】el-table-column 缺少 `align="center"`
+- **R002**【中危】el-table 缺少 `empty-text="暂无数据"`
+- **R003**【中危】BaseTable 缺少 `empty-text="暂无数据"`
+- **R014**【中危】selection 列缺少 `header-align="center"`
+
+### 按钮类 → 详见 [skills/components/table/SKILL.md](../../components/dialog/SKILL.md)
+
+- **R004**【高危】操作列使用文字按钮（应改为 renderOps 图标系统）
+- **R005**【中危】工具栏按钮缺少 icon
+- **R015**【高危】弹窗嵌套表格操作列使用 el-button link
+
+### 表单类 → 详见 [skills/components/form/SKILL.md](../../components/form/SKILL.md)
+
+- **R006**【中危】el-input / el-select 缺少 `size="small"`
+- **R007**【中危】el-date-picker 缺少 `style="width:100%"`
+- **R008**【低危】el-form labelWidth < 150px
+
+### 弹窗类 → 详见 [skills/components/dialog/SKILL.md](../../components/dialog/SKILL.md)
+
+- **R011**【高危】弹窗内分页器未放在 `<template #footer>` 中
+
+### 颜色类
+
+- **R016**【中危】`<style>` 块存在硬编码 hex 颜色
+- **R017**【中危】`<template>` 块存在硬编码 hex 颜色
+- **R018**【中危】`<script>` 块存在硬编码 hex 颜色
+
+### 状态标签类 → 详见 [skills/components/tag-status/SKILL.md](../../components/tag-status/SKILL.md)
+
+- **R009**【高危】状态字段纯文本渲染（需人工确认）
+- **R010**【中危】分类字段使用填充色 Tag（需人工确认）
+
+---
+
+## 三、无法自动修复的规则
+
+| 规则                         | 原因                                         | AI 职责                            |
+| ---------------------------- | -------------------------------------------- | ---------------------------------- |
+| R008 labelWidth              | 可能有特殊布局需求                           | 标注疑似问题 + 给建议 + 等用户确认 |
+| R009 状态字段纯文本          | 需识别业务语义                               | 同上                               |
+| R010 分类 vs 状态判断        | 需结合字段业务含义                           | 同上                               |
+| R013（含 Upload 等特殊操作） | Upload 嵌入 operations[] 需抽离到 toolbarDef | 同上                               |
+
+---
+
+## 四、执行约束
+
+1. Phase 3 用户确认是强制门槛，未确认不得修改文件
+2. 每次只修改一类规则，修改后立即验证该类归零再继续
+3. 不修改路径：`node_modules/`、`dist/`、`*.min.js`、用户标注为"已手动调整"的文件
+4. 脚本幂等：已符合标准的不会被二次修改

package/skills/runtime/style-align/USAGE.md

@@ -0,0 +1,52 @@
+# USAGE — UI 风格对齐 Skill
+
+## 调用方式
+
+在 AI 对话中，触发本 Skill 的典型问法：
+
+```
+帮我检查一下这个项目的 UI 风格是否符合规范
+扫描 src/ 目录，找出所有不符合 wk-skills-ui 标准的地方
+对 src/views/safety/ 下的文件做风格对齐修复
+```
+
+## 完整执行流程（示例）
+
+```
+用户：帮我对 src/views/check/ 目录做完整的风格扫描修复
+
+AI 执行：
+  1. [Phase 1] npx wk-ui all --project . --outFile /tmp/scan.md
+  2. [Phase 2] 展示摘要（文件数、问题数、按规则分类）
+  3. [Phase 3] 询问：是否全量修复？哪些文件需要跳过？
+  4. [Phase 4] 执行修复（A 类 → wk-ui fix；B 类 → 逐文件编辑）
+  5. [Phase 5] 重新扫描，展示 before/after 对比
+```
+
+## 期望输出格式
+
+```markdown
+## 扫描结果（Phase 2）
+
+- 扫描文件数：43
+- 发现问题数：127（高危 38 / 中危 64 / 低危 25）
+
+| 规则 | 类型 | 数量 | 代表文件 |
+| R001 | 高危 | 23 | src/views/check/list.vue:34 |
+...
+
+## 修复摘要（Phase 4）
+
+- src/views/check/list.vue：R001×3, R006×2, R016×1
+  ...
+
+## 验证结果（Phase 5）
+
+- 剩余问题：12（仅含需人工确认的 R009/R013）✅
+```
+
+## 相关 Skills
+
+- 首次接入新项目 → [core/migration/SKILL.md](../migration/SKILL.md)
+- 仅修复颜色 Token → [core/design-tokens/SKILL.md](../design-tokens/SKILL.md)
+- 仅修复表格问题 → [components/table/SKILL.md](../../components/table/SKILL.md)

package/skills/vendors/ag-grid/SKILL.md

@@ -0,0 +1,94 @@
+---
+description: |
+  AG Grid 列渲染规范 Skill — 使用 defineColumns + renderOps + renderTagNode 等运行时函数
+  实现 AG Grid 表格列的自动化配置、状态彩色 Tag、操作列图标按钮。
+applyTo: "**/*.{ts,vue}"
+---
+
+# AG Grid 列渲染规范
+
+## 核心原则
+
+1. 所有列定义用 `defineColumns()` 包裹 — 自动应用已注册字段映射
+2. 操作列统一用 `renderOps([...])` — 图标按钮系统，自动分隔线 + stopPropagation
+3. 状态字段用 `renderTagNode()` / `renderClassifyTag()` — 彩色 Tag，见 tag-status/SKILL.md
+
+> 与 `wl-skills-kit` 协同说明：本 Skill 负责 AG Grid/列渲染/操作列 runtime 能力，也要服务非 kit 项目的通用 AG Grid 场景。若扫描发现项目希望升级为团队最佳实践，再提示使用 `wl-skills-kit` 进行页面结构和工作流规范化；在此之前，`wk-skills-ui` 仍应保证样式和渲染能力可独立生效。
+
+---
+
+## 标准列定义写法
+
+```typescript
+import { defineColumns, renderOps, renderTagNode, renderBadge } from '@agile-team/wk-skills-ui/runtime';
+
+columnsDef(): TableColumnDesc<any>[] {
+  return defineColumns([
+    // ── 序号/选择列 ──
+    { type: 'index',     label: '序号', width: 60,  align: 'center' },
+    { type: 'selection', label: '',     width: 55,  align: 'center', headerAlign: 'center', fixed: 'left' },
+
+    // ── 普通数据列 ──
+    { name: 'riskNo',  label: '风险编号', width: 100 },   // renderBadge 已自动映射
+    { name: 'riskLevel', label: '风险分级', width: 90 }, // renderRiskLevel 已自动映射
+
+    // ── 自定义渲染列 ──
+    { name: 'status', label: '状态', width: 90,
+      defaultNode: ({ row }) => renderTagNode(row.status, MY_STATUS_MAP) },
+
+    // ── 操作列 ──
+    { label: '操作', width: 120, fixed: 'right',
+      defaultSlot: ({ row }) => renderOps([
+        { type: 'view', onClick: () => modal.view(row.id) },
+        { type: 'edit', show: !isReadonly.value, onClick: () => modal.edit(row.id) },
+        { type: 'del',  show: !isReadonly.value, onClick: () => handleDel(row.id) },
+      ])
+    },
+  ]);
+}
+```
+
+---
+
+## renderOps 操作类型
+
+| type   | 图标        | CSS 类       | 默认 title |
+| ------ | ----------- | ------------ | ---------- |
+| `view` | View        | `jh-op-view` | 查看       |
+| `edit` | Edit        | `jh-op-edit` | 编辑       |
+| `del`  | Delete      | `jh-op-del`  | 删除       |
+| `log`  | Document    | `jh-op-log`  | 记录       |
+| `ok`   | CircleCheck | `jh-op-ok`   | 审核       |
+| `send` | Upload      | `jh-op-send` | 提交       |
+
+---
+
+## COLUMN_AUTO_MAP 已注册字段
+
+使用 `defineColumns()` 包裹后，以下字段**无需手写 defaultNode**，自动渲染：
+
+| 字段名               | 渲染效果       | 需调用                       |
+| -------------------- | -------------- | ---------------------------- |
+| `enableStatus`       | 启用/停用 Tag  | `installCommonPreset()` 后自动 |
+| `riskLevel`          | 风险分级 Tag   | `installCommonPreset()` 后自动 |
+| `permitStatus`       | 作业票状态 Tag | 同上                         |
+| `trainStatus`        | 培训状态 Tag   | 同上                         |
+| `credentialStatus`   | 证书状态 Tag   | 同上                         |
+| `riskNo` / `checkNo` | 蓝色编号徽标   | 同上                         |
+| `ratingLevel`        | 彩色评级徽标   | 同上                         |
+
+完整列表见 `runtime/core/registry.ts` + `runtime/presets/common.ts`。
+
+---
+
+## 条件显示操作按钮
+
+```typescript
+renderOps([
+  { type: 'edit', show: canEdit.value,        onClick: ... },  // 响应式
+  { type: 'del',  show: row.status !== '3',   onClick: ... },  // 行级条件
+  { type: 'ok',   show: () => row.status === '2', onClick: ... }, // 函数形式
+])
+```
+
+> `show: false` 时按钮不渲染（不占位）。`show` 支持 `boolean | Ref<boolean> | () => boolean`。

package/skills/vendors/base-table/SKILL.md

@@ -0,0 +1,57 @@
+---
+description: |
+  BaseTable / <base-table> 系列封装组件的识别、诊断和修复规则。
+  Base 前缀是团队约定的最高优先级封装组件，所有 Base* 表格的视觉一致性由本 skill 保障。
+applyTo: "**/*.vue"
+---
+
+# Skill: vendors/base-table
+
+> Layer L2 · Vendor priority **#1**（Base > jh > C_/c_ > custom）
+
+## Detect（识别）
+
+满足以下任一条件即视为 Base 系列封装表格组件：
+
+| 维度 | 模式 |
+|---|---|
+| 标签名 | `<BaseTable>` / `<base-table>` / `<BaseDataTable>` / `<BaseList>` |
+| Import | `from '@/components/Base*'` / `from '@/components/base-*'` |
+| 类名 | `.base-table-wrapper` / `.base-table-container` / `[class^='base-table-']` |
+| Props | 通常包含 `columns` / `data` / `hook` / `renderType` |
+
+## Diagnose（判定）
+
+底层基于 Element Plus `el-table`，所有 R001-R003、R014 规则同样生效，但需注意：
+
+- ❌ 直接给 `<BaseTable>` 加内联 hex 颜色（应通过 token 或全局类名）
+- ❌ 用 `<el-button type="primary">` 当操作按钮（应用 `is-text` 文字按钮，沿用 R004）
+- ❌ 列头未居中（同 R001）
+- ❌ 缺 `empty-text="暂无数据"`（同 R003）
+- ❌ 在 `<BaseTable>` 外层包裹自定义 padding 容器，破坏整体节奏
+
+## Repair（修复）
+
+### A 类（自动修）
+- 缺失 `empty-text` → 补 `empty-text="暂无数据"`
+- 操作列按钮 `type="primary"` → 改为 `link` + `is-text`
+- 内联 hex → CSS 变量
+
+### B 类（建议人工确认）
+- 替换为 `defineColumns(...)` 渲染（迁移到 L4 runtime，业务代码大幅精简）
+
+## 与 wl-skills-kit 的协同闭环
+
+本 Skill 必须保留对多种 BaseTable/封装表格写法的识别和样式覆盖能力，不要求老项目先改成 `wl-skills-kit` 最佳实践。扫描时先判断当前写法能否通过化妆层统一视觉；若用户希望进一步规范化业务代码，再提示可使用 `wl-skills-kit` 按团队模板重构为 `BaseTable render-type="agGrid" + cid + defineColumns/renderOps`。也就是说：`wk-skills-ui` 负责先统一样式，`wl-skills-kit` 负责可选的规范化生成/修复。
+
+## 全局样式来源
+
+`styles/vendors/_base-table.scss` — 已注入容器圆角、表头颜色、操作按钮间距。
+项目侧无需重复写样式，遵循 DOM 约定即可。
+
+## 未来源码迁移
+
+当 BaseTable 源码可用：
+1. 把 `_base-table.scss` 内容平迁到 `BaseTable.vue` 的 `<style scoped>`
+2. 在 `runtime/presets/` 新增 `base-table.ts` 提供原生 API
+3. 业务代码升级为 `<BaseTable :columns="defineColumns(...)" />`