@agile-team/wl-skills-ui 1.6.5 → 1.6.7

package/CHANGELOG.md

@@ -4,6 +4,57 @@ All notable changes to **@agile-team/wl-skills-ui** will be documented in this f
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.6.7] - 2026-05-11
+
+### Added
+
+- 新增 `standards/architecture/01-layer-boundaries.md`，明确 tokens、Element Plus、vendors、layouts、runtime、scanner、skills 的职责边界和扩展规则。
+- 新增 `npm run docs:check`，校验旧命名、旧命令、README 版本文案、CHANGELOG 版本记录和编辑器配置完整性。
+
+### Changed
+
+- CLI 编辑器安装配置改为读取 `skills/_meta/_compat/editors.json`，消除代码内第二份 `EDITOR_TARGETS` 路径映射。
+- `editors.json` 补齐 `ext`、`singleFile`、`headerFile` 等安装行为字段，使 AI 编辑器配置成为单一事实源。
+
+## [1.6.6] - 2026-05-11
+
+### Changed
+
+- README、主 `SKILL.md`、Flow、Standards、Templates 和多编辑器兼容文档同步到 `wl-ui` / `wl-skills-ui` 当前命名，移除旧版 `wk-ui` / `wk-skills-ui` 过期写法。
+- README 和多编辑器兼容文档补齐 `wl-ui update --editor all --force`、manifest 多编辑器刷新策略和 v1.6.5 规则分发说明。
+
+## [1.6.5] - 2026-05-11
+
+### Added
+
+- `wl-ui update --editor all --force`：支持一次性将同一套 `skills/**/*.md` 规则转换并覆盖写入全部支持的 AI 编辑器目录。
+- manifest 新增 `editors` 数组记录，兼容旧版 `editor` 字符串字段，便于多编辑器项目持续更新。
+
+### Changed
+
+- `wl-ui update` 未指定 `--editor` 时，会优先刷新 manifest 中记录的编辑器和项目里已存在的编辑器规则目录，避免团队不同 AI 编辑器 rules 漂移。
+
+## [1.6.4] - 2026-05-11
+
+### Fixed
+
+- 表单控件圆角统一使用 `--wk-form-control-radius`，覆盖 input、select、date、input-number、cascader、autocomplete、textarea、upload 等控件族。
+- Element Plus 上传拖拽区和上传列表项补齐圆角 token 与 fallback，避免局部硬编码导致视觉不一致。
+- `el-form`、`style-align` Skill 和 `standards/ui/03-form.md` 补齐表单圆角一致性规则，引导 AI 避免局部 patch。
+
+## [1.6.3] - 2026-05-11
+
+### Fixed
+
+- Element Plus 表格空状态改为在对应表格区域内自适应居中，嵌套表格不再依赖固定高度猜效果。
+- AG Grid 空状态提示文案改为更通用并支持 CSS 变量自定义。
+- 查询区和工具栏按钮补齐 CSS 变量 fallback，避免 token 未加载时按钮颜色丢失。
+- 禁用按钮增加独立样式约束，避免 hover/active 覆盖禁用态。
+
+### Changed
+
+- `el-table`、`base-table`、`style-align` 等 Skill 补充智能空状态修复规则，要求 AI 根据真实业务上下文判断空态文案与区域，而不是硬编码。
+
 ## [1.6.2] - 2026-05-09
 
 ### Changed

package/README.md

@@ -193,10 +193,16 @@ yarn add @agile-team/wl-skills-ui
 
 ## 版本亮点
 
-当前 v1.6.2 版本重点补齐 AI Skill 的安装、更新、清理和编辑器集成体验，并强化多组件样式覆盖精度：
-
-- vendors 层各组件样式精细化调整：`_base-components`、`_ag-grid`、`_portal`、`_jh-tree`、`_jh-pagination`、`_jh-drag-col`、`_c-components`、`_base-query-toolbar` 全面优化
-- design tokens（`base.css` / `dist/tokens.css`）同步更新，security preset 样式调整
+当前 v1.6.7 版本重点强化“统一规则源 + 多编辑器分发 + 分层边界治理 + UI 细节精准修复”的闭环：
+
+- `skills/**/*.md` 作为唯一规则源，`wl-ui init/update` 会按编辑器格式转换并覆盖写入目标 rules
+- `skills/_meta/_compat/editors.json` 作为 AI 编辑器安装配置唯一来源，CLI 不再维护第二份编辑器路径映射
+- `wl-ui update --editor all --force` 可一次性刷新全部支持编辑器；未指定编辑器时会刷新 manifest 与项目中已存在的编辑器规则目录
+- `standards/architecture/01-layer-boundaries.md` 固化 tokens、Element Plus、vendors、layouts、runtime、scanner、skills 的扩展边界，避免胶水补丁污染
+- `npm run docs:check` 校验旧命名、旧命令、版本文案和编辑器配置，防止规则文档回退
+- 表格空状态改为对应表格区域内自适应居中，避免嵌套表格靠固定高度猜效果
+- 查询区/工具栏按钮补齐 token fallback，禁用按钮独立保留清晰禁用态
+- 表单控件圆角统一使用 `--wk-form-control-radius`，覆盖 input/select/date/textarea/upload 等控件家族
 - `wl-ui init/update` 会安装 Skill、触发提示、MCP 配置和 manifest 清单
 - `wl-ui diff/clean/doctor/prompts` 覆盖升级前对比、卸载清理、环境体检和提示词查看
 - 内置 `wl-skills-ui` MCP Server，供 AI 编辑器调用扫描、检查和 dry-run 修复
@@ -303,8 +309,9 @@ npx wl-ui scan --target src --mode skin --outFile audit.md
 
 ```bash
 # 安装或更新 Skill 到当前业务项目
-npx wl-ui init --project . --editor auto
-npx wl-ui update --project .
+npx wl-ui init --project .
+npx wl-ui update --project . --force
+npx wl-ui update --project . --editor all --force
 
 # 查看 AI 触发提示
 npx wl-ui prompts
@@ -313,7 +320,7 @@ npx wl-ui prompts
 npx wl-ui doctor --project .
 ```
 
-安装后会写入 `.github/wl-skills-ui/TRIGGER_PROMPTS.md`、`.mcp.json` 和 `.wl-skills-ui-manifest.json`。支持的编辑器可以单独指定，例如 `--editor claude-code`、`--editor cline`、`--editor agents-generic`、`--editor qoder`。
+安装后会写入 `.github/wl-skills-ui/TRIGGER_PROMPTS.md`、`.mcp.json` 和 `.wl-skills-ui-manifest.json`。支持的编辑器可以单独指定，例如 `--editor kiro`、`--editor claude-code`、`--editor cline`、`--editor agents-generic`、`--editor qoder`；也可以使用 `--editor all` 一次性生成全部编辑器规则。
 
 ### 场景 D — 仅 CI 检查
 
@@ -335,7 +342,7 @@ npx wl-ui doctor --project .
 ```bash
 wl-ui init    [--project .] [--editor <e>] [--mode native|skin]
                             [--dry-run] [--skills-only]
-wl-ui update  [--project .] [--force] [--dry-run]
+wl-ui update  [--project .] [--editor <e|all>] [--force] [--dry-run]
 wl-ui diff    [--project .]
 wl-ui clean   [--project .] [--dry-run]
 wl-ui doctor  [--project .]
@@ -348,7 +355,7 @@ wl-ui all     --project .
 wl-ui add-preset <name>     # 脚手架新业务 preset
 ```
 
-支持的 AI 编辑器：`github-copilot` / `cursor` / `windsurf` / `kiro` / `trae` / `claude-code` / `cline` / `agents-generic` / `qoder`（自动检测）
+支持的 AI 编辑器：`github-copilot` / `cursor` / `windsurf` / `kiro` / `trae` / `claude-code` / `cline` / `agents-generic` / `qoder` / `all`。`update` 未指定编辑器时会优先刷新 manifest 与项目中已存在的编辑器规则目录。
 
 `init/update` 会同时写入：
 

package/SKILL.md

@@ -13,7 +13,8 @@ applyTo: "**/*.vue"
 ```bash
 # 安装/更新 AI Skill、触发提示、MCP 配置和 manifest
 npx wl-ui init --project . --mode native
-npx wl-ui update --project .
+npx wl-ui update --project . --force
+npx wl-ui update --project . --editor all --force
 
 # 查看差异、体检、清理
 npx wl-ui diff --project .
@@ -24,7 +25,7 @@ npx wl-ui clean --project . --dry-run
 npx wl-ui prompts
 ```
 
-可选编辑器：`github-copilot`、`cursor`、`windsurf`、`kiro`、`trae`、`claude-code`、`cline`、`agents-generic`、`qoder`。修复前优先使用 `--dry-run` 或 MCP 工具 `wks_ui_fix_dry_run`。
+可选编辑器：`github-copilot`、`cursor`、`windsurf`、`kiro`、`trae`、`claude-code`、`cline`、`agents-generic`、`qoder`、`all`。`update` 未指定编辑器时会刷新 manifest 与项目中已存在的编辑器规则目录；修复前优先使用 `--dry-run` 或 MCP 工具 `wks_ui_fix_dry_run`。
 
 
 ## 一、适用场景
@@ -101,8 +102,8 @@ npx wl-ui check --project [项目根目录]
 ### Category A：表格（el-table / AG Grid）
 
 #### R001 — el-table-column 缺少居中对齐【高危】
-**检测**：`<el-table-column` 没有 `align="center"`，或有 `align="left"`  
-**标准**：所有列必须 `align="center"`，selection 列 width=55，index 列 width=60  
+**检测**：`<el-table-column` 没有 `align="center"`，或有 `align="left"`
+**标准**：所有列必须 `align="center"`，selection 列 width=55，index 列 width=60
 ```diff
 - <el-table-column label="名称" prop="name">
 + <el-table-column align="center" label="名称" prop="name">
@@ -112,16 +113,16 @@ npx wl-ui check --project [项目根目录]
 > ⚠️ `selection` 列必须同时加 `align="center"` **和** `header-align="center"`，否则表头复选框与数据行复选框会出现垂直错位。
 
 #### R002 — el-table 缺少空状态文本【中危】
-**检测**：`<el-table` 没有 `empty-text` 属性  
-**标准**：统一 `empty-text="暂无数据"`  
+**检测**：`<el-table` 没有 `empty-text` 属性
+**标准**：统一 `empty-text="暂无数据"`
 ```diff
 - <el-table :data="list">
 + <el-table :data="list" empty-text="暂无数据">
 ```
 
 #### R003 — BaseTable 缺少空状态文本【中危】
-**检测**：`<BaseTable` 没有 `empty-text` 属性  
-**标准**：统一 `empty-text="暂无数据"`  
+**检测**：`<BaseTable` 没有 `empty-text` 属性
+**标准**：统一 `empty-text="暂无数据"`
 ```diff
 - <BaseTable :hook="page">
 + <BaseTable :hook="page" empty-text="暂无数据">
@@ -148,11 +149,11 @@ npx wl-ui check --project [项目根目录]
 ### Category B：按钮（el-button）
 
 #### R004 — 操作列使用文字按钮【高危】
-**检测**：列定义模板中有 `jh-op-btn` 缺失的操作按钮  
-**标准**：操作列必须用 `defaultSlot: ({ row }) => renderOps([...])` 图标按钮系统  
+**检测**：列定义模板中有 `jh-op-btn` 缺失的操作按钮
+**标准**：操作列必须用 `defaultSlot: ({ row }) => renderOps([...])` 图标按钮系统
 
 #### R013 — columnsDef 旧格式 operations:[] 文字按钮【高危】
-**检测**：script 块中 columnsDef 内有 `operations: [` 旧格式数组（由 scanner/index.mjs 单独检测）  
+**检测**：script 块中 columnsDef 内有 `operations: [` 旧格式数组（由 scanner/index.mjs 单独检测）
 **标准**：同 R004，改为 `defaultSlot: ({ row }) => renderOps([...])`
 
 **简单迁移（无条件显示）**：
@@ -181,15 +182,15 @@ npx wl-ui check --project [项目根目录]
 + ])
 ```
 
-**含 Upload / 自定义组件的操作（特殊案例，不能直接用 renderOps）**：  
+**含 Upload / 自定义组件的操作（特殊案例，不能直接用 renderOps）**：
 将 Upload 操作从 operations[] 中抽出，改为 toolbarDef() 中的 `renderNode:` 按钮，操作列仍用 renderOps 承载其他操作。
 
-**标签→type 映射**：查看→`view`，编辑/修改→`edit`，删除/移除→`del`，审核/审批→`ok`，提交→`send`，流程记录→`log`  
+**标签→type 映射**：查看→`view`，编辑/修改→`edit`，删除/移除→`del`，审核/审批→`ok`，提交→`send`，流程记录→`log`
 **参考**：`reference/ag-cell-renders.ts` - `renderOps` 函数
 
 #### R005 — 工具栏按钮缺少 icon【中危】
-**检测**：toolbarDef / 顶部 el-button 没有 `icon` 属性  
-**标准**：工具栏按钮必须带 icon + 文字  
+**检测**：toolbarDef / 顶部 el-button 没有 `icon` 属性
+**标准**：工具栏按钮必须带 icon + 文字
 ```diff
 - <el-button type="primary" @click="handleAdd">新增</el-button>
 + <el-button type="primary" icon="Plus" @click="handleAdd">新增</el-button>
@@ -200,24 +201,24 @@ npx wl-ui check --project [项目根目录]
 ### Category C：表单控件（el-input / el-select / el-date-picker）
 
 #### R006 — el-input / el-select 未统一 size【中危】
-**检测**：`<el-input` 或 `<el-select` 没有 `size="small"` 属性  
-**标准**：全局统一 `size="small"`  
+**检测**：`<el-input` 或 `<el-select` 没有 `size="small"` 属性
+**标准**：全局统一 `size="small"`
 ```diff
 - <el-input v-model="form.name" placeholder="请输入">
 + <el-input size="small" v-model="form.name" placeholder="请输入">
 ```
 
 #### R007 — el-date-picker 宽度未撑满【中危】
-**检测**：`<el-date-picker` 没有 `style` 包含 `width:100%`  
-**标准**：在 el-form-item 内必须 `style="width:100%"`  
+**检测**：`<el-date-picker` 没有 `style` 包含 `width:100%`
+**标准**：在 el-form-item 内必须 `style="width:100%"`
 ```diff
 - <el-date-picker v-model="form.date" type="date">
 + <el-date-picker style="width:100%" v-model="form.date" type="date">
 ```
 
 #### R008 — el-form labelWidth 不统一【低危】
-**检测**：`labelWidth` 小于 150px  
-**标准**：统一 `labelWidth="150px"`（最长标签"隐患排查内容及标准"9字=~126px+padding=142px，150px安全兜底）  
+**检测**：`labelWidth` 小于 150px
+**标准**：统一 `labelWidth="150px"`（最长标签"隐患排查内容及标准"9字=~126px+padding=142px，150px安全兜底）
 **注意**：此规则需人工确认，不自动修改（可能有特殊布局需求）
 
 ---
@@ -225,16 +226,16 @@ npx wl-ui check --project [项目根目录]
 ### Category D：状态标签（ElTag）
 
 #### R009 — 状态字段纯文本渲染【高危】
-**检测**：column 的 `name` 含 `Status/Level/State` 关键字，但 `defaultNode/defaultSlot` 没有 `renderTagNode` 或 `ElTag`  
+**检测**：column 的 `name` 含 `Status/Level/State` 关键字，但 `defaultNode/defaultSlot` 没有 `renderTagNode` 或 `ElTag`
 **标准**：
 - 动态状态（启停/审批/流程）→ `renderTagNode()` / 使用 `COLUMN_AUTO_MAP` 自动映射
-- 常用字段直接用 `defineColumns()` 包裹列定义，自动应用：`enableStatus/approvalStatus/riskLevel/permitStatus/trainStatus/credentialStatus/unifyQuestionStatus` 等  
-**参考**：`reference/define-columns.ts` COLUMN_AUTO_MAP 完整列表  
+- 常用字段直接用 `defineColumns()` 包裹列定义，自动应用：`enableStatus/approvalStatus/riskLevel/permitStatus/trainStatus/credentialStatus/unifyQuestionStatus` 等
+**参考**：`reference/define-columns.ts` COLUMN_AUTO_MAP 完整列表
 **注意**：此规则需人工确认，不自动修复
 
 #### R010 — 分类字段使用填充色 ElTag【中危】
-**检测**：`effect` 不是 `"plain"`，但字段语义是分类/归档属性  
-**标准**：分类字段统一 `effect="plain"`（outline 风格）  
+**检测**：`effect` 不是 `"plain"`，但字段语义是分类/归档属性
+**标准**：分类字段统一 `effect="plain"`（outline 风格）
 ```diff
 - h(ElTag, { type: 'warning' }, () => label)
 + h(ElTag, { type: 'warning', effect: 'plain' }, () => label)
@@ -245,8 +246,8 @@ npx wl-ui check --project [项目根目录]
 ### Category E：弹窗/分页
 
 #### R011 — 分页组件位置错误【高危】
-**检测**：`<pagination` 或 `<Pagination` 出现在 `<template #footer>` 内  
-**标准**：分页必须在内容区（el-col 内），footer 只放操作按钮  
+**检测**：`<pagination` 或 `<Pagination` 出现在 `<template #footer>` 内
+**标准**：分页必须在内容区（el-col 内），footer 只放操作按钮
 **参考**：`reference/SelectPopupCom.vue`
 
 #### R012 — 弹窗内 el-table 缺少空状态【中危】
@@ -273,8 +274,8 @@ npx wl-ui check --project [项目根目录]
 > 支持图标类型：`jh-op-del`（删除）、`jh-op-view`（查看/详情）、`jh-op-edit`（编辑）
 
 #### R016 — `<style>` 块存在硬编码 hex 颜色【中危】
-**检测**：`<style>` 块中直接写入已有 CSS Token 对应的 hex 颜色值  
-**标准**：使用 CSS 变量代替硬编码，确保品牌色切换生效  
+**检测**：`<style>` 块中直接写入已有 CSS Token 对应的 hex 颜色值
+**标准**：使用 CSS 变量代替硬编码，确保品牌色切换生效
 ```diff
 - color: #4368ff;
 + color: var(--el-color-primary);
@@ -284,11 +285,11 @@ npx wl-ui check --project [项目根目录]
 **已覆盖颜色**：`#409eff/#3a7afe/#4368ff`→primary，`#fb2323/#f56c6c`→danger，`#0cc859/#67c23a`→success，`#ffaf27/#e6a23c`→warning，`#ecf5ff`→primary-light-9
 
 #### R017 — 编号/工号/证件号列缺少 renderBadge【高危】
-**检测**：`columnsDef()` / `columns` 数组中，label 含“编号”“工号”“证件号”但没有 `renderBadge` / `defaultSlot`（脚本式列定义）  
-**标准**：所有标识符类字段（射5类）必须使用 `renderBadge(row.xxx)`，包括：  
-- label 含“编号”：门岗编号、主机编号、通道编号…  
-- label 含“工号”：上报人工号、处置人工号…  
-- label 含“证件号”：证件号码、驾驶员证件号码、车主证件号码…  
+**检测**：`columnsDef()` / `columns` 数组中，label 含“编号”“工号”“证件号”但没有 `renderBadge` / `defaultSlot`（脚本式列定义）
+**标准**：所有标识符类字段（射5类）必须使用 `renderBadge(row.xxx)`，包括：
+- label 含“编号”：门岗编号、主机编号、通道编号…
+- label 含“工号”：上报人工号、处置人工号…
+- label 含“证件号”：证件号码、驾驶员证件号码、车主证件号码…
 ```diff
 - { label: "工号", name: "userNo", minWidth: 100 }
 + { label: "工号", name: "userNo", minWidth: 100,
@@ -300,8 +301,8 @@ npx wl-ui check --project [项目根目录]
 > **答疑解惑：证件号码要用 badge 吗？** 是的。证件号码是唧18位的唯一标识字符串，badge 的等宽字体让长串数字更易辨识，视觉上传达“这是个标识码”的语义。
 
 #### R018 — `logicType:dict` 列缺少 defaultSlot【高危】
-**检测**：`columnsDef()` / `columns` 中某列有 `logicType: BusLogicDataType.dict`，但没有 `defaultSlot` / `renderTag` / `renderDictClassifyTag`（脚本式列定义）  
-**标准**：`logicType:dict` 仅提供字符串渲染，必须换为标签渲染：  
+**检测**：`columnsDef()` / `columns` 中某列有 `logicType: BusLogicDataType.dict`，但没有 `defaultSlot` / `renderTag` / `renderDictClassifyTag`（脚本式列定义）
+**标准**：`logicType:dict` 仅提供字符串渲染，必须换为标签渲染：
 ```diff
 - { name: "trainLevel", label: "培训级别",
 -   logicType: BusLogicDataType.dict, logicValue: "trainLevel" }

package/bin/wl-ui.js

@@ -3,7 +3,7 @@
  * wl-ui — wl-skills-ui 统一 CLI
  *
  * 子命令：
- *   wl-ui init   [--project <path>] [--editor copilot|cursor|windsurf|kiro|trae] [--dry-run]
+ *   wl-ui init   [--project <path>] [--editor <editor|all>] [--dry-run]
  *                把 skills/ 写入目标项目的 AI 编辑器规则目录
  *   wl-ui scan   → 委托给 scanner/index.mjs
  *   wl-ui check  → 委托给 scanner/index.mjs
@@ -40,21 +40,7 @@ const MANIFEST_NAME = ".wl-skills-ui-manifest.json";
 // 常量
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-/** 编辑器 → 安装目录映射 */
-const EDITOR_TARGETS = {
-  "github-copilot": {
-    dir: ".github/instructions/wk-skills",
-    ext: ".instructions.md",
-  },
-  cursor: { dir: ".cursor/rules", ext: ".mdc" },
-  windsurf: { dir: ".windsurf/rules", ext: ".md" },
-  kiro: { dir: ".kiro/steering", ext: ".md" },
-  trae: { dir: ".trae/rules", ext: ".md" },
-  "claude-code": { dir: ".", ext: ".md", singleFile: "CLAUDE.md" },
-  cline: { dir: ".", ext: ".md", singleFile: ".clinerules" },
-  "agents-generic": { dir: ".", ext: ".md", singleFile: "AGENTS.md" },
-  qoder: { dir: ".qoder/rules", ext: ".md" },
-};
+const EDITOR_TARGETS = loadEditorTargets();
 const EDITOR_IDS = Object.keys(EDITOR_TARGETS);
 
 // ── 参数解析 ─────────────────────────────────────────────────────────────────
@@ -265,6 +251,33 @@ function detectEditor(projectRoot) {
   return "github-copilot";
 }
 
+function loadEditorTargets() {
+  const configPath = join(
+    PKG_ROOT,
+    "skills",
+    "_meta",
+    "_compat",
+    "editors.json",
+  );
+  const config = JSON.parse(readFileSync(configPath, "utf8"));
+  return Object.fromEntries(
+    config.editors.map((editor) => [
+      editor.id,
+      {
+        dir: normalizeInstallDir(editor.installPath),
+        ext: editor.ext || ".md",
+        singleFile: editor.singleFile,
+        headerFile: editor.headerFile,
+      },
+    ]),
+  );
+}
+
+function normalizeInstallDir(installPath) {
+  const normalized = installPath.replace(/\\/g, "/").replace(/\/+$/, "");
+  return normalized === "." || normalized === "" ? "." : normalized;
+}
+
 function detectInstalledEditors(projectRoot) {
   return EDITOR_IDS.filter((editor) => {
     const target = EDITOR_TARGETS[editor];
@@ -338,13 +351,14 @@ function collectSkills(skillsDir) {
 
 /** 读取编辑器 frontmatter 模板 */
 function getHeaderTemplate(editor) {
+  const target = EDITOR_TARGETS[editor];
+  const headerFile = target?.headerFile;
   const headerPath = join(
     PKG_ROOT,
     "skills",
     "_meta",
     "_compat",
-    "headers",
-    `${editorHeaderName(editor)}.txt`,
+    headerFile || join("headers", `${editor}.txt`),
   );
   if (existsSync(headerPath)) return readFileSync(headerPath, "utf8");
   return "";
@@ -543,22 +557,6 @@ function capitalize(s) {
   return s.charAt(0).toUpperCase() + s.slice(1);
 }
 
-function editorHeaderName(editor) {
-  return (
-    {
-      cursor: "cursor-mdc",
-      "github-copilot": "github-copilot",
-      windsurf: "windsurf",
-      kiro: "kiro",
-      trae: "trae",
-      "claude-code": "claude-code",
-      cline: "cline",
-      "agents-generic": "agents",
-      qoder: "qoder",
-    }[editor] || editor
-  );
-}
-
 function installSupportFiles({ projectRoot, dryRun }) {
   const files = [
     {

package/examples/migration-operations-to-renderOps.md

@@ -27,7 +27,7 @@ const columnsDef = [
 ## 迁移后（新格式）
 
 ```ts
-import { renderOps } from "@agile-team/wk-skills-ui/runtime";
+import { renderOps } from "@agile-team/wl-skills-ui/runtime";
 
 const columnsDef = [
   { label: "名称", name: "name" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/wl-skills-ui",
-  "version": "1.6.5",
+  "version": "1.6.7",
   "description": "企业级 UI 风格对齐框架 — Vue + Element Plus 项目通用化妆/原生双模式（tokens / element / vendors / layouts / runtime / scanner / fixer / skills）",
   "type": "module",
   "main": "./es/index.js",
@@ -40,6 +40,7 @@
     "build": "tsup && npm run sync:tokens",
     "prepare": "npm run build",
     "sync:tokens": "node -e \"import('fs').then(fs=>fs.copyFileSync('design/tokens/base.css','dist/tokens.css'))\"",
+    "docs:check": "node scripts/check-docs.mjs",
     "scan": "node scanner/index.mjs scan",
     "check": "node scanner/index.mjs check",
     "fix": "node scanner/index.mjs fix",
@@ -58,6 +59,7 @@
     "skills",
     "templates",
     "bin",
+    "scripts",
     "mcp",
     "reference",
     "examples",

package/scripts/check-docs.mjs

@@ -0,0 +1,83 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const root = join(__dirname, "..");
+const pkg = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+const readme = readFileSync(join(root, "README.md"), "utf8");
+const changelog = readFileSync(join(root, "CHANGELOG.md"), "utf8");
+const editorConfig = JSON.parse(
+  readFileSync(
+    join(root, "skills", "_meta", "_compat", "editors.json"),
+    "utf8",
+  ),
+);
+
+const errors = [];
+const forbiddenPatterns = [
+  { pattern: /\bwk-ui\b/, message: "旧 CLI 名称 wk-ui" },
+  { pattern: /\bwk-skills-ui\b/, message: "旧包名 wk-skills-ui" },
+  {
+    pattern: /@agile-team\/wk-skills-ui/,
+    message: "旧 npm 包名 @agile-team/wk-skills-ui",
+  },
+  { pattern: /--editor auto/, message: "无效编辑器参数 --editor auto" },
+  { pattern: /当前 v1\.6\.2/, message: "过期 README 当前版本文案" },
+];
+
+function walk(dir) {
+  const files = [];
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (["node_modules", ".git", "dist", "es"].includes(entry.name)) continue;
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) files.push(...walk(full));
+    if (entry.isFile() && entry.name.endsWith(".md")) files.push(full);
+  }
+  return files;
+}
+
+for (const file of walk(root)) {
+  const rel = relative(root, file).replace(/\\/g, "/");
+  const content = readFileSync(file, "utf8");
+  for (const { pattern, message } of forbiddenPatterns) {
+    if (rel === "CHANGELOG.md") continue;
+    if (pattern.test(content)) errors.push(`${rel}: ${message}`);
+  }
+}
+
+if (!readme.includes(`当前 v${pkg.version}`)) {
+  errors.push(
+    `README.md: 当前版本文案未同步 package.json version ${pkg.version}`,
+  );
+}
+
+if (!changelog.includes(`## [${pkg.version}]`)) {
+  errors.push(`CHANGELOG.md: 缺少 ${pkg.version} 版本记录`);
+}
+
+for (const editor of editorConfig.editors) {
+  if (!editor.id) errors.push("editors.json: editor 缺少 id");
+  if (!editor.installPath)
+    errors.push(`editors.json: ${editor.id} 缺少 installPath`);
+  if (!editor.ext) errors.push(`editors.json: ${editor.id} 缺少 ext`);
+  if (!editor.headerFile)
+    errors.push(`editors.json: ${editor.id} 缺少 headerFile`);
+  if (
+    !existsSync(join(root, "skills", "_meta", "_compat", editor.headerFile))
+  ) {
+    errors.push(
+      `editors.json: ${editor.id} headerFile 不存在：${editor.headerFile}`,
+    );
+  }
+}
+
+if (errors.length > 0) {
+  console.error(
+    "docs:check failed:\n" + errors.map((error) => `- ${error}`).join("\n"),
+  );
+  process.exit(1);
+}
+
+console.log("docs:check passed");

package/skills/_flows/full-audit.md

@@ -11,7 +11,7 @@ applyTo: "**/*.{vue,scss}"
 
 ## 触发短语
 
-- "用 wk-ui 全量审计当前项目"
+- "用 wl-ui 全量审计当前项目"
 - "audit 流程跑一下"
 - "出一份风格健康度报告"
 
@@ -19,7 +19,7 @@ applyTo: "**/*.{vue,scss}"
 
 ### Phase 1 — 扫描全量
 ```bash
-npx wk-ui scan --target src --outFile audit-report.md
+npx wl-ui scan --target src --outFile audit-report.md
 ```
 
 ### Phase 2 — 按层分组统计

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

@@ -11,7 +11,7 @@ applyTo: "**/*.{vue,scss,html}"
 
 ## 触发短语
 
-- "用 wk-ui 给这个老项目化妆对齐"
+- "用 wl-ui 给这个老项目化妆对齐"
 - "legacy-skin 流程跑一下"
 - "skin mode 接入"
 
@@ -19,18 +19,18 @@ applyTo: "**/*.{vue,scss,html}"
 
 ### Phase 0 — 安装/更新 Skill 与 MCP 配置
 ```bash
-npx wk-ui init --project . --mode skin
-npx wk-ui doctor --project .
+npx wl-ui init --project . --mode skin
+npx wl-ui doctor --project .
 ```
 
-该命令会写入 AI 编辑器规则、触发提示、`.mcp.json` 和 `.wk-skills-ui-manifest.json`。已安装项目可改用 `npx wk-ui update --project .`。
+该命令会写入 AI 编辑器规则、触发提示、`.mcp.json` 和 `.wl-skills-ui-manifest.json`。已安装项目可改用 `npx wl-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" />
+   <link rel="stylesheet" href="/node_modules/@agile-team/wl-skills-ui/design/tokens/base.css" />
    ```
 2. 检查 `vite.config.ts` / `webpack` 是否能解析 `node_modules` 路径
 
@@ -38,7 +38,7 @@ npx wk-ui doctor --project .
 1. 找到全局 SCSS 入口（`src/main.scss` / `src/styles/index.scss`）
 2. 在文件最顶部追加：
    ```scss
-   @use '@agile-team/wk-skills-ui/styles/presets/skin' as *;
+   @use '@agile-team/wl-skills-ui/styles/presets/skin' as *;
    ```
 3. **不**引入 `layouts/` 层（避免和老项目布局冲突）
 

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

@@ -11,7 +11,7 @@ applyTo: "**/*.{vue,ts,scss,html}"
 
 ## 触发短语
 
-- "用 wk-ui 给新项目接入"
+- "用 wl-ui 给新项目接入"
 - "new-project 流程跑一下"
 - "native mode 完整接入"
 
@@ -19,35 +19,35 @@ applyTo: "**/*.{vue,ts,scss,html}"
 
 ### Phase 0 — 安装/更新 Skill 与 MCP 配置
 ```bash
-npx wk-ui init --project . --mode native
-npx wk-ui doctor --project .
+npx wl-ui init --project . --mode native
+npx wl-ui doctor --project .
 ```
 
-该命令会写入 AI 编辑器规则、触发提示、`.mcp.json` 和 `.wk-skills-ui-manifest.json`。已安装项目可改用 `npx wk-ui update --project .`。
+该命令会写入 AI 编辑器规则、触发提示、`.mcp.json` 和 `.wl-skills-ui-manifest.json`。已安装项目可改用 `npx wl-ui update --project .`。
 
 
 
 ### Phase 1 — 安装包
 ```bash
-pnpm add @agile-team/wk-skills-ui
+pnpm add @agile-team/wl-skills-ui
 ```
 
 ### Phase 2 — 注入 tokens
 `index.html` `<head>`：
 ```html
-<link rel="stylesheet" href="/node_modules/@agile-team/wk-skills-ui/design/tokens/base.css" />
+<link rel="stylesheet" href="/node_modules/@agile-team/wl-skills-ui/design/tokens/base.css" />
 ```
 
 ### Phase 3 — 接入完整样式
 `src/styles/index.scss`：
 ```scss
-@use '@agile-team/wk-skills-ui/styles' as *;   // 等价于 presets/full
+@use '@agile-team/wl-skills-ui/styles' as *;   // 等价于 presets/full
 ```
 
 ### Phase 4 — 接入 runtime
 `src/main.ts`：
 ```ts
-import { installCommonPreset } from '@agile-team/wk-skills-ui/runtime/common-preset';
+import { installCommonPreset } from '@agile-team/wl-skills-ui/runtime/common-preset';
 installCommonPreset();
 ```
 
@@ -59,7 +59,7 @@ installCommonPreset();
 
 ### Phase 6 — 业务定制 preset（按需）
 ```bash
-npx wk-ui add-preset my-biz
+npx wl-ui add-preset my-biz
 # 生成 runtime/presets/my-biz.ts，自定义业务字段映射
 ```
 
@@ -67,8 +67,8 @@ npx wk-ui add-preset my-biz
 `package.json` `scripts`：
 ```json
 {
-  "ui:check": "wk-ui check --project .",
-  "ui:fix":   "wk-ui fix --target src --dry-run"
+  "ui:check": "wl-ui check --project .",
+  "ui:fix":   "wl-ui fix --target src --dry-run"
 }
 ```