@qilitt-mickey/vue3-temp-skill 1.1.34 → 1.1.35

package/references/design-handoff.md

@@ -1,5 +1,5 @@
 ---
-skill: design-handoff
+name: design-handoff
 description: 收到 design-handoff/v1 JSON 后，按逐文件修改清单执行。配置→令牌→框架组件→样式→页面代码，5 步 51 项。
 scope: project
 tags: [handoff, design-tokens, upstream, artifacts, json, modification-checklist]
@@ -7,11 +7,7 @@ tags: [handoff, design-tokens, upstream, artifacts, json, modification-checklist
 
 # 设计落地修改清单
 
-> 收到 `design-handoff/v1` JSON 后，AI 按本清单逐项执行修改。
-> 每一项标注：JSON 来源 → 项目文件 → 修改内容 → 验证点。
-> 模板源码保持出厂状态，所有修改在 AI 生成/修改代码时完成。
->
-> 1:1 还原要求见下方 F1-F27（框架组件）和 P1-P7（页面代码）步骤。
+> 收到 `design-handoff/v1` JSON 后逐项执行。每项标注「JSON 来源 → 项目文件 → 修改内容 → 验证」。模板源码保持出厂状态，修改在 AI 生成/修改代码时完成。
 
 ## 设计产出落盘范围
 
@@ -48,13 +44,9 @@ tags: [handoff, design-tokens, upstream, artifacts, json, modification-checklist
 4. **设计输出未覆盖的区域 → 保持项目已有实现**，仅同步令牌（色彩/字体/圆角等）
 5. **隐藏/移除功能性元素时**：在回复中明确列出被移除的元素，供用户确认是否需要补回
 
-## 触发
-
-会话中存在 `design-handoff/v1` JSON，或存在设计 HTML 且用户要求按设计适配工程代码 → 自动执行完整 C/T/F/Co/S/P，禁止只改主色或只改令牌。
-
 ## 规范识别回执（动手前必出）
 
-> 动手前先 init handoff session（保存当次 JSON 规格）；不在业务项目创建 `.handoff/`。
+> 动手前先 `handoff plan` 生成实施 diff（读 JSON + 扫描项目），可选 `handoff init` 保存当次规格；状态默认存于项目内 `.design-handoff/`（通用，不依赖宿主目录）。
 
 ```markdown
 ## 规范识别回执
@@ -65,8 +57,11 @@ tags: [handoff, design-tokens, upstream, artifacts, json, modification-checklist
 - 主色阶：完整 10 级
 - 侧栏：{shell.sidebar}
 - 顶栏元素（JSON）：{structureRequirements.frameworkShell.header 逐项列出}
+- 顶栏分组（JSON）：左 {frameworkShell.headerGroups.left} / 右 {frameworkShell.headerGroups.right}
+- 页签位置（JSON）：{shell.tabPlacement}（independent-row / inside-header）
+- 布局类型（JSON）：{meta.layoutKind}（admin / portal）→ 侧栏呈现 {frameworkShell.sider.present}
 - 交互规格（JSON）：tabsActive.underline / tableOperate.showIcon / menuActive.fullWidth 等
-- 将改文件：platform-config.json / design-tokens.scss / navbar / sidebar / tabs / ReTableBar / ReTableOperate / element-plus.scss / 业务页面
+- 将改文件：platform-config.json / design-tokens.scss / navbar / sidebar（若 present） / tabs / ReTableBar / ReTableOperate / element-plus.scss / 业务页面
 ```
 
 ---
@@ -123,9 +118,9 @@ tags: [handoff, design-tokens, upstream, artifacts, json, modification-checklist
 
 | # | JSON 来源 | 项目文件 | 修改内容 | 验证 |
 |---|---------|---------|---------|------|
-| F1 | `structureRequirements.frameworkShell.header` | `src/layout/components/lay-navbar/index.vue` | 顶栏组成：折叠按钮（左）+ 语言切换 + 功能图标组 + 分割线 + 欢迎区 + 头像（右）。**设计中未体现的元素必须移除**（设置/通知/全屏/搜索/面包屑等） | 元素与设计完全一致，不多不少 |
+| F1 | `structureRequirements.frameworkShell.header` + `frameworkShell.headerGroups.left` + `frameworkShell.headerGroups.right` | `src/layout/components/lay-navbar/index.vue` | 顶栏组成按 `headerGroups.left`/`right` 分左右两组（左组含折叠按钮，右组为语言/全屏/欢迎/头像等功能项）；**设计中未体现的元素必须移除**（设置/通知/全屏/搜索/面包屑等） | 元素与设计完全一致，不多不少 |
 | F2 | `interactionSpecs.languageSwitch` | navbar/ 语言切换组件 | **改为内联文字**（中 / EN），竖线分隔。激活态品牌色文字，非激活次要色。**禁止下拉框** | 语言切换为内联文字 |
-| F3 | `structureRequirements.frameworkShell.headerLayout` | navbar/index.vue | flex 两端对齐：左侧折叠按钮，右侧功能组 | 布局与设计一致 |
+| F3 | `frameworkShell.headerGroups.left` + `frameworkShell.headerGroups.right` + `structureRequirements.frameworkShell.headerLayout` | navbar/index.vue | flex 两端对齐：左组（含折叠按钮）flex-start，右组（语言/全屏/欢迎/头像）flex-end；`layoutKind=portal` 时无侧栏则**折叠按钮隐藏** | 顶栏左右分组与设计一致 |
 | F4 | `interactionSpecs.menuActive` → 头像区 | navbar/ 欢迎区 | 悬停态：头像微浮起 + 欢迎文字变品牌色 | hover 效果与设计一致 |
 | F5 | `frameworkShell.header` 元素清单 | navbar/index.vue | **设置按钮**：设计无则 `display:none` 或删除组件引用 | 设置按钮不出现 |
 | F6 | `frameworkShell.header` 元素清单 | navbar/index.vue | **通知/消息按钮**：设计无则隐藏 | 通知图标不出现 |
@@ -135,12 +130,14 @@ tags: [handoff, design-tokens, upstream, artifacts, json, modification-checklist
 
 ### 3.2 侧栏 sidebar
 
+> **条件守卫**：`frameworkShell.sider.present === false`（或 `meta.layoutKind === "portal"`）时，**跳过 F10-F18 全部侧栏步骤**，并同步：顶栏改为全宽（`left:0; right:100%`）、内容区 `margin-left:0`、折叠按钮隐藏（`headerGroups.left` 移除 `collapse`）。无侧栏布局不得残留任何侧栏 DOM/样式。
+
 | # | JSON 来源 | 项目文件 | 修改内容 | 验证 |
 |---|---------|---------|---------|------|
 | F10 | `structureRequirements.frameworkShell.sidebar.logoArea` | `src/layout/components/sidebar/` | Logo 区：品牌色方块 + 白字首字（尺寸/圆角按 JSON 值），非默认彩色图标 | Logo 风格统一 |
-| F11 | `structureRequirements.frameworkShell.sidebar.menuItemHeight` | sidebar/ + `element-plus.scss` | 菜单项高度按 JSON 值 | 间距有呼吸感 |
+| F11 | `geometry.menuItemHeight` | sidebar/ + `element-plus.scss` | 菜单项高度按 JSON 值 | 间距有呼吸感 |
 | F12 | `interactionSpecs.menuActive` | sidebar/ + `element-plus.scss` | **菜单激活态**：品牌色极浅底 + 右侧强调条 + 品牌色文字。**禁止纯蓝底白字** | 激活态视觉锚点清晰 |
-| F13 | `structureRequirements.frameworkShell.sidebar.collapsed` | sidebar/ 折叠态 | 仅图标，宽度按 `geometry.siderCollapsedWidth` | 折叠宽度与设计一致 |
+| F13 | `geometry.siderCollapsedWidth` | sidebar/ 折叠态 | 仅图标，宽度按 `geometry.siderCollapsedWidth` | 折叠宽度与设计一致 |
 | F14 | `shell.sidebar` → 深色侧栏 | `theme.scss` / `sidebar.scss` | 侧栏背景色按 JSON/令牌库值（深色），非出厂白色 | 侧栏深色 |
 | F15 | `frameworkShell.sidebar.collapseButtonPosition` | sidebar/ | **折叠按钮位置**：设计在顶部则放 Logo 区；设计在底部则放侧栏底部 | 折叠按钮位置与设计一致 |
 | F16 | `frameworkShell.sidebar.bottomCollapse` | sidebar/ | **底部折叠按钮**：设计无则 **必须隐藏**（`display:none` 或删除底部触发器），折叠功能移至顶部 | 侧栏底部无折叠按钮 |
@@ -152,10 +149,11 @@ tags: [handoff, design-tokens, upstream, artifacts, json, modification-checklist
 | # | JSON 来源 | 项目文件 | 修改内容 | 验证 |
 |---|---------|---------|---------|------|
 | F19 | `shell.showModel` | `src/layout/components/tabs/` + `element-plus.scss` | 页签风格按设计值实现（line: 底部强调线；card: 卡片式；chrome: 谷歌式） | 风格与设计一致 |
+| F19.1 | `shell.tabPlacement` | `src/layout/components/lay-tag/index.vue` + `element-plus.scss` | 页签位置由 JSON 驱动，禁止写死：**`independent-row`**=sticky 吸顶在顶栏正下方（`top: headerHeight`）、全宽（`left/right` 与顶栏一致），**禁止 `position:relative` 嵌入顶栏导致遮挡导航**；**`inside-header`**=嵌入顶栏右侧与功能组并排 | 页签位置与设计一致、不遮挡导航 |
 | F20 | `structureRequirements.frameworkShell.tabs.homeTab` | tabs/ | 首页页签固定左侧，**不可关闭** | 首页页签行为正确 |
 | F21 | `interactionSpecs.tabsActive` | `element-plus.scss` | 激活页签：品牌色文字 + 底部强调线（line 风格） | 激活态视觉与设计一致 |
-| F22 | `interactionSpecs.tabsUnderline` | `element-plus.scss` | **页签下划线居中**：`line` 模式下激活下划线与文字等宽、严格居中，禁止偏左/偏右 | 横线视觉居中 |
-| F23 | `frameworkShell.tabs.height` | tabs/ + `design-tokens.scss` | 页签高度严格按 `--tabs-height`，内部 flex 垂直居中 | 文字垂直居中 |
+| F22 | `interactionSpecs.tabsActive.underline` | `element-plus.scss` | **页签下划线居中**：`line` 模式下激活下划线与文字等宽、严格居中，禁止偏左/偏右 | 横线视觉居中 |
+| F23 | `geometry.tabsHeight` | tabs/ + `design-tokens.scss` | 页签高度严格按 `--tabs-height`，内部 flex 垂直居中 | 文字垂直居中 |
 | F24 | `interactionSpecs.tabsClose` | `element-plus.scss` | 关闭按钮始终可见，hover 变色（按 JSON `interactionSpecs.tabsClose` 值） | 关闭按钮行为正确 |
 | F25 | `frameworkShell.tabs.contextMenu` | tabs/ | 右键菜单：刷新/关闭/关闭其他/关闭左侧/关闭右侧/全部关闭 | 右键菜单项与设计一致 |
 
@@ -403,14 +401,14 @@ tags: [handoff, design-tokens, upstream, artifacts, json, modification-checklist
 | 输入框聚焦 | `interactionSpecs.inputFocus` | `.el-input__wrapper:focus-within` | 输入框聚焦有光环 |
 | 表格行 hover | `interactionSpecs.tableRowHover` | `.el-table tbody tr:hover` | 行 hover 有品牌色感 |
 | 表头 | `visual.tableHeaderBorderBottom` | `.el-table thead th` | 表头有层次感 |
-| 菜单激活 | `visual.menuActiveBorderRight` | `.el-menu-item.is-active` | 菜单激活有锚点 |
+| 菜单激活 | `visual.menuActiveIndicator` | `.el-menu-item.is-active` | 菜单激活有锚点 |
 | 分页激活 | `interactionSpecs.paginationActive` | `.el-pagination .is-active` | 分页激活页有品牌色 |
 | 全局过渡 | `visual.transitionBase` | `*` (transition) | 交互有平滑感 |
 | 暗色覆盖 | — | `html.dark` 下以上选择器 | 暗色模式完整 |
 | 展开收起 hover | `interactionSpecs.collapseBtnHover` | `.vts-collapse-btn:hover` | hover 文字不变浅 |
 | 操作列 hover | `interactionSpecs.actionBtnHover` | `.vts-table-area .el-button--text:hover` | 操作列 hover 文字加深 |
 | 页签关闭 hover | `interactionSpecs.tabsCloseHover` | `.el-tabs__item .el-icon-close:hover` | 关闭按钮 hover 有反馈 |
-| 页签下划线 | `interactionSpecs.tabsUnderline` | `.el-tabs__active-bar` | 横线居中 |
+| 页签下划线 | `interactionSpecs.tabsActive.underline` | `.el-tabs__active-bar` | 横线居中 |
 | 下拉选项 hover | `interactionSpecs.selectOptionHover` | `.el-select-dropdown__item.hover` | 下拉项 hover 有品牌色感 |
 | 复选框 hover | `interactionSpecs.checkboxHover` | `.el-checkbox__inner:hover` | 复选框 hover 有反馈 |
 | 开关过渡 | `interactionSpecs.switchTransition` | `.el-switch` | 开关切换有动画 |
@@ -509,6 +507,8 @@ tags: [handoff, design-tokens, upstream, artifacts, json, modification-checklist
 | 页面 | `structureRequirements.elementHideList` 项仍在代码中 | 硬失败：隐藏/删除 |
 | 页面 | 状态 Tag 与 `interactionSpecs.statusTag` 不一致 | 硬失败：按 JSON 修正 |
 | 页面 | `structureRequirements` 或 `interactionSpecs` 段未实现 | 硬失败：按 F1-F27 / P1-P7 + JSON 补充 |
+| 页签位置 | `shell.tabPlacement=independent-row` 但页签 `position:relative` 嵌入顶栏（遮挡导航） | 硬失败：改为 sticky 独立成行，禁止嵌入顶栏 |
+| 布局 | `meta.layoutKind=portal` / `frameworkShell.sider.present=false` 但侧栏仍呈现 | 硬失败：移除侧栏，顶栏全宽，内容区 `margin-left:0` |
 
 ### 8.3 配置 / 令牌 / 样式硬失败（与 JSON 字段对照）
 
@@ -760,18 +760,8 @@ tags: [handoff, design-tokens, upstream, artifacts, json, modification-checklist
 
 ---
 
-### 执行顺序（最终版）
-
-1. **配置修改**（C1-C8）
-2. **令牌写入**（T1-T12）
-3. **框架组件修改**（F1-F27）
-4. **共享组件修改**（Co1-Co12）
-5. **元素自查隐藏**（第四章）
-6. **样式修改**（S1）
-7. **页面代码生成**（P1-P7）
-8. **设计还原度验证** — 加载 `design-verify.md`，执行 10.1-10.7 区域级验证 + 10.7.5 CSS 冲突检测 + 10.8 逐属性 CSS 校验 + 10.9 设计变更同步（如有）
-9. **功能完整性核查**（第十一章）—— 检查功能坏没坏
-10. **code-quality 闸门**
-11. **输出报告**（设计还原度验证报告 + CSS 冲突检测报告 + 逐属性校验报告 + 功能完整性核查报告）
-
-> ⚠️ **四条腿走路**：区域级还原度（10.1-10.7）+ CSS 结构级冲突检测（10.7.5）+ 属性级逐条校验（10.8-10.9）+ 功能完整性（第十一章）缺一不可。只改对样式但功能坏了 = 失败；功能正常但样式有偏差 = 也失败；区域级通过但属性级有遗漏 = 同样失败；属性级通过但 CSS 冲突导致生效值不确定 = 同样失败。四者全部通过才算完成。
+### 执行顺序（单页 / 项目级通用）
+
+C1-C8 → T1-T12 → F1-F27 → Co1-Co12 → 第四章隐藏 → S1 → P1-P7 → 设计还原度验证（`design-verify.md`）→ 功能完整性核查（第十一章）→ code-quality 闸门 → 输出报告。项目级模式在 C/T/F/Co/隐藏/S 各步全局一次，再遍历全部路由逐页执行 P1-P7。
+
+> 还原度五支柱（缺一不可）：区域级还原（第十章）+ CSS 结构级冲突检测（10.7.5）+ 属性级逐条校验（10.8-10.9）+ 几何自洽校验（`handoff geometry` 第 5 条腿：页签是否独立成行/通栏、门户是否无侧栏）+ 功能完整性（第十一章）。

package/references/design-system.md

@@ -1,5 +1,5 @@
 ---
-skill: design-system
+name: design-system
 description: 项目设计系统静态说明。描述令牌体系、主题系统、暗色模式、布局框架、EP 定制规则、加载顺序和禁止清单，供 AI 查阅。落地流程见 design-handoff.md，还原度验证见 design-verify.md。
 scope: project
 tags: [design-system, design-tokens, element-plus, theme, css-variables, dark-mode]

package/references/design-verify.md

@@ -1,5 +1,5 @@
 ---
-skill: design-verify
+name: design-verify
 description: 设计还原度验证 — 区域级验证(10.1-10.7) + 逐属性CSS校验(10.8) + 设计变更增量同步(10.9)。C/T/F/Co/S/P 执行完成后按本文件逐项验证。
 scope: project
 tags: [handoff, verify, css-audit, design-sync, hard-fail]
@@ -27,6 +27,8 @@ tags: [handoff, verify, css-audit, design-sync, hard-fail]
 10.8       逐属性 CSS 校验（从设计源文件提取属性 → 逐条比对项目代码 → 回读校验）
     ↓
 10.9       设计变更增量同步（仅设计变更时执行）
+    ↓
+10.10      几何自洽校验（第 5 条腿：`handoff geometry` 断言盒子关系，不依赖截图）
 ```
 
 ---
@@ -35,7 +37,7 @@ tags: [handoff, verify, css-audit, design-sync, hard-fail]
 
 > **验证真相源顺序**：当次 handoff JSON（`structureRequirements` + `interactionSpecs`）> 设计 HTML > 设计 skill references > 模板出厂默认值。
 
-1. 读取 session 或会话中的 handoff JSON（业务项目不创建 `.handoff/`）
+1. 读取 session（项目内 `.design-handoff/handoff.json`）或会话中的 handoff JSON
 2. 从 JSON 展开**本次验证清单**（非 skill 静态表）：
    - `frameworkShell.header` → 顶栏元素逐项
    - `interactionSpecs.tabsActive.underline` → 决定是否检查下划线
@@ -420,6 +422,29 @@ AI 在执行设计还原度验证时，按以下步骤操作：
 - 变更项已正确落地
 - 未变项未被误改
 
+## 10.10 几何自洽校验（第 5 条腿 · 盒子关系，不依赖截图）
+
+> 区域级（10.2-10.7）+ 结构级（10.7.5）+ 属性级（10.8）检查的是"值对不对"，但**不检查盒子之间的重叠/通栏关系**——这正是用户截图里"页签遮挡导航""页签未通栏"这类毛病的来源。
+> 本节用 `handoff geometry` 纯静态断言（读 `design-tokens.scss` + 实际 CSS 的盒模型），**不依赖截图**，符合无多模态约束。
+
+**触发**：C/T/F/Co/S/P 完成后、功能核查前执行。
+
+```bash
+node scripts/handoff.mjs geometry --project <项目> [--design-json <handoff.json>]
+```
+
+**断言项**（以当次 JSON 为准）：
+
+| 断言 | 期望 | 命中失败含义 |
+|------|------|------|
+| 顶栏高度令牌 == 设计几何 | `--header-height` == `geometry.headerHeight` | 令牌未写或写错 |
+| 页签独立成行（independent-row） | 页签 `position: sticky` 且**非 `relative` 嵌入顶栏** | `position:relative` 嵌入顶栏 = 遮挡导航根因 |
+| 页签 top == 顶栏高度 | 吸顶贴顶栏正下方，不与导航重叠 | 页签压住导航 |
+| 门户布局：侧栏不呈现 | `layoutKind=portal`/`sider.present=false` 时无侧栏 DOM/样式 | 残留侧栏 |
+| 门户布局：内容区 margin-left==0 | 无侧栏时左偏移为 0 | 内容区被侧栏宽度挤偏 |
+
+**结论**：任一 ✗ = 硬失败，回到对应 F 步骤修正后重跑，直到零冲突。
+
 ### 10.9.4 同步报告
 
 ```markdown

package/references/detail-page.md

@@ -1,5 +1,5 @@
 ---
-skill: detail-page
+name: detail-page
 description: 列表→独立路由详情/编辑/查看。路由 meta、toDetail 写顶部 tag、activePath 保侧栏高亮、initToDetail。
 scope: project
 tags: [vue3, detail, toDetail, useDetail, activePath, showLink, multiTags, keepAlive]

package/references/directives-advanced.md

@@ -1,10 +1,10 @@
----
-skill: directives-advanced
-description: v-copy 一键复制、v-auto-font 标题字号自适应
-scope: project
-tags: [一键复制, 标题字号自适应, v-copy, v-auto-font, 复制, 字号自适应]
----
-
+---
+name: directives-advanced
+description: v-copy 一键复制、v-auto-font 标题字号自适应
+scope: project
+tags: [一键复制, 标题字号自适应, v-copy, v-auto-font, 复制, 字号自适应]
+---
+
 # 高级自定义指令（复制 / 自适应字号）
 
 > 按本文件示例编写，复用项目已有 `v-copy` / `v-auto-font`，勿另起一套复制或字号自适应实现。  

package/references/download-export.md

@@ -1,5 +1,5 @@
 ---
-skill: download-export
+name: download-export
 description: 导出/下载必须带 responseType blob，使用 blobDown 或项目已有下载工具
 scope: project
 tags: [导出, excel, blob, 下载文件, 下载, 导出Excel]

package/references/feedback-loading.md

@@ -1,5 +1,5 @@
 ---
-skill: feedback-loading
+name: feedback-loading
 description: Message、Loading、MessageBox、NoticeBar 反馈和加载
 scope: project
 tags: [message, loading, 确认框, 提示, 加载, 操作反馈, 骨架屏, skeleton]

package/references/feedback-ui.md

@@ -1,5 +1,5 @@
 ---
-skill: feedback-ui
+name: feedback-ui
 description: ReNoticeBar、水印、时间轴、打字机等展示类反馈组件
 scope: project
 tags: [通知栏, 水印, 时间轴, 打字机, 展示组件, 空状态, empty]

package/references/file-management.md

@@ -1,10 +1,10 @@
----
-skill: file-management
-description: ReAttachment 附件管理：上传、下载、删除、数据适配、表单校验
-scope: project
-tags: [附件, ReAttachment, ReFileViewer, 预览, 上传, 文件上传, 图片上传, 断点续传, 分片上传, 打印, 截图, 视频播放, 音频, 文件预览]
----
-
+---
+name: file-management
+description: ReAttachment 附件管理：上传、下载、删除、数据适配、表单校验
+scope: project
+tags: [附件, ReAttachment, ReFileViewer, 预览, 上传, 文件上传, 图片上传, 断点续传, 分片上传, 打印, 截图, 视频播放, 音频, 文件预览]
+---
+
 # 文件管理与预览
 
 > 按下列示例编写。

package/references/flowchart-g6.md

@@ -1,5 +1,5 @@
 ---
-skill: flowchart-g6
+name: flowchart-g6
 description: '@antv/g6 + g6-extension-vue 流程图，支持 Vue 节点'
 scope: project
 tags: [g6, 流程图, 拓扑图, antv, G6流程图, 自定义流程图, 流程设计, 拓扑]

package/references/form-advanced.md

@@ -1,5 +1,5 @@
 ---
-skill: form-advanced
+name: form-advanced
 description: 弹窗（ReDialog / ReDialogResize）、远程下拉、级联、锚点、卡片选择、地址解析等高级表单能力。图标选择完整规范见 icons 模块。
 scope: project
 tags: [form, dialog, ReDialog, ReDialogResize, ReSelectQuery, ReCascader, iconPicker, anchor, address-parse, 抽屉, 步骤条, 折叠面板, 穿梭框, 分步表单, 联动, 动态表单, 日历, 时间选择, 日期选择, 下拉选择, 拖动, 拖拽排序]

package/references/graph-relation.md

@@ -1,10 +1,10 @@
----
-skill: graph-relation
-description: relation-graph-vue3 知识图谱页面结构、节点/连线类型
-scope: project
-tags: [图谱, relation-graph, 关系图, 知识图谱, 关系网络]
----
-
+---
+name: graph-relation
+description: relation-graph-vue3 知识图谱页面结构、节点/连线类型
+scope: project
+tags: [图谱, relation-graph, 关系图, 知识图谱, 关系网络]
+---
+
 # 知识图谱（relation-graph）
 
 > 必须使用选型表中的 `relation-graph-vue3`，勿改用 D3 / vis.js 等同类库。按下列示例编写。

package/references/http-api.md

@@ -1,5 +1,5 @@
 ---
-skill: http-api
+name: http-api
 description: 规范 HTTP 请求封装、API 接口文件组织、加解密与文件下载。编写或修改 API 时加载。
 scope: project
 tags: [axios, http, api, encryption, rsa, aes, download, request]

package/references/i18n-localization.md

@@ -1,5 +1,5 @@
 ---
-skill: i18n-localization
+name: i18n-localization
 description: vue-i18n 国际化、locales 语言包、ReLanguageSwitch 语言切换、store/modules/lang
 scope: project
 tags: [国际化, 多语言, i18n, vue-i18n, locale, 语言切换, 语言包, $t, useI18n, ReLanguageSwitch]

package/references/icons.md

@@ -1,5 +1,5 @@
 ---
-skill: icons
+name: icons
 description: 规范项目图标体系（本地 SVG 雪碧图、Iconify ep/ri、全局 svg-icon、ReIconPicker、菜单 meta.icon、UnoCSS presetIcons、svg?component）。在新增/选用图标、改菜单图标、图标选择器或内网离线图标时调用。
 scope: project
 tags: [vue3, icon, svg-icon, ReSvgIcon, ReIconPicker, iconify, ep, ri, unocss, menu-icon]

package/references/layout-theme.md

@@ -1,5 +1,5 @@
 ---
-skill: layout-theme
+name: layout-theme
 description: 布局、主题色、暗黑模式、侧栏配色、Design Tokens、UnoCSS、响应式。修改布局/主题/颜色时加载。上游设计产出落地见 design-handoff / design-verify / design-system。
 scope: project
 tags: [vue3, layout, theme, dark-mode, css-variables, design-tokens, element-plus, vant, dual-ui, unocss, chroma-js, 标签页, 面包屑, tabs, breadcrumb]

package/references/mobile-h5.md

@@ -1,5 +1,5 @@
 ---
-skill: mobile-h5
+name: mobile-h5
 description: 规范移动端 H5 页面开发、Vant 组件使用、微信 JS-SDK 集成和移动端路由配置。开发移动端页面或微信相关功能时调用。
 scope: project
 tags: [vue3, mobile, h5, vant, wechat, miniprogram, responsive, touch]

package/references/particles.md

@@ -1,10 +1,10 @@
----
-skill: particles
-description: tsParticles 登录背景粒子、@tsparticles/slim、particlesOptions
-scope: project
-tags: [粒子, tsparticles, 登录背景粒子, 粒子动画]
----
-
+---
+name: particles
+description: tsParticles 登录背景粒子、@tsparticles/slim、particlesOptions
+scope: project
+tags: [粒子, tsparticles, 登录背景粒子, 粒子动画]
+---
+
 # 粒子特效（tsParticles）
 
 > 按本文件示例编写，复用项目已有 `@tsparticles/*` 注册与 `src/utils/particles.ts` 配置，勿另起一套粒子实现，勿引入 `particles.js`。

package/references/permission-auth.md

@@ -1,5 +1,5 @@
 ---
-skill: permission-auth
+name: permission-auth
 description: 规范页面权限、按钮权限、自定义指令和 Hooks 的使用。在开发涉及权限控制、自定义指令或编写组合式函数时调用。
 scope: project
 tags: [vue3, permission, auth, directive, hooks, v-auth, role, access-control]

package/references/project-inventory.md

@@ -1,5 +1,5 @@
 ---
-skill: project-inventory
+name: project-inventory
 description: 项目资产清单：三方库、Re* 组件、依赖安装表
 scope: project
 tags: [查Re, 版本, 安装, 依赖清单, 库版本]

package/references/qrcode-barcode.md

@@ -1,5 +1,5 @@
 ---
-skill: qrcode-barcode
+name: qrcode-barcode
 description: 二维码、条形码相关 Re 组件与依赖
 scope: project
 tags: [二维码, 条形码, qrcode, barcode, 扫码]

package/references/rich-text.md

@@ -1,5 +1,5 @@
 ---
-skill: rich-text
+name: rich-text
 description: '@wangeditor/editor + ReRichText 富文本使用方式、图片/视频上传'
 scope: project
 tags: [富文本, wangeditor, ReRichText, 编辑器, Markdown]

package/references/seamless-scroll.md

@@ -1,5 +1,5 @@
 ---
-skill: seamless-scroll
+name: seamless-scroll
 description: ReSeamlessScroll 无缝滚动、classOption、关键滚动约定
 scope: project
 tags: [无缝滚动, 跑马灯, marquee, 滚动公告, 滚动通知]

package/references/table-vxe.md

@@ -1,5 +1,5 @@
 ---
-skill: table-vxe
+name: table-vxe
 description: vxe-table / vxe-pc-ui 高性能表格规范。大数据量或复杂网格编辑时加载。自带完整示例。
 scope: project
 tags: [vxe-table, vxe-pc-ui, grid, performance, table, 单元格编辑, 可编辑表格]

package/references/tree-table.md

@@ -1,10 +1,10 @@
----
-skill: tree-table
-description: handleTree/buildHierarchyTree 和 el-table 树形表格、树与表格联动
-scope: project
-tags: [树表, ReTreeLine, handleTree, 树形, 树状, 层级表格, 组织架构, 部门树, 树形列表, 树状表格]
----
-
+---
+name: tree-table
+description: handleTree/buildHierarchyTree 和 el-table 树形表格、树与表格联动
+scope: project
+tags: [树表, ReTreeLine, handleTree, 树形, 树状, 层级表格, 组织架构, 部门树, 树形列表, 树状表格]
+---
+
 # 树形表格与树结构
 
 > 使用 `handleTree` / `ReTreeLine` + `el-table` tree，按本示例编写。

package/references/ui-components.md

@@ -1,5 +1,5 @@
 ---
-skill: ui-components
+name: ui-components
 description: Re* 公共组件目录/导出/类型约定；用法按功能模块分散在各 references，本文件只做索引与新建规范。
 scope: project
 tags: [vue3, component, re-component, library, typescript]

package/references/verify-captcha.md

@@ -1,5 +1,5 @@
 ---
-skill: verify-captcha
+name: verify-captcha
 description: 滑块拼图 ReVerify、拖拽验证 ReDragVerify、图片验证码、短信验证码
 scope: project
 tags: [验证码, 滑块, 短信验证, captcha, 拖拽验证, 图片验证码]

package/references/websocket-realtime.md

@@ -1,10 +1,10 @@
----
-skill: websocket-realtime
-description: WebSocket 实时通信架构 utils/websocket + useWebSocket
-scope: project
-tags: [websocket, ws, 实时, 消息推送, 实时推送, 在线状态]
----
-
+---
+name: websocket-realtime
+description: WebSocket 实时通信架构 utils/websocket + useWebSocket
+scope: project
+tags: [websocket, ws, 实时, 消息推送, 实时推送, 在线状态]
+---
+
 # WebSocket 实时通信
 
 > 使用 `utils/websocket` + `useWebSocket`，勿另起一套 WS 管理器。

package/references/wechat-js.md

@@ -1,5 +1,5 @@
 ---
-skill: wechat-js
+name: wechat-js
 description: 微信 JS-SDK 封装与 useWechat。与 mobile-h5 可组合。自带用法示例。
 scope: project
 tags: [wechat, weixin, js-sdk, useWechat]

package/references/workflow-bpmn.md

@@ -1,5 +1,5 @@
 ---
-skill: workflow-bpmn
+name: workflow-bpmn
 description: bpmn-js 只读 Viewer 使用方式，明确不用 Modeler
 scope: project
 tags: [bpmn, 流程审批, 审批流, BPMN流程, 工作流, 审批流程]

package/scripts/check.mjs

@@ -30,6 +30,11 @@ const checks = [
     desc: "高频 Demo 场景能力组命中验证",
     cmd: () => run("python", "scripts/match.py", ["--batch"]),
   },
+  {
+    name: "协议字段对账",
+    desc: "design-handoff.md 引用 vs handoff-output.md schema，无幽灵字段",
+    cmd: () => run(NODE, "scripts/field-schema-audit.mjs"),
+  },
 ];
 
 function run(runner, script, args = []) {
@@ -60,6 +65,7 @@ for (const check of checks) {
     const summary =
       lines.find((l) => /^OK \d+\/\d+ scenarios/.test(l.trim())) ||
       lines.find((l) => l.includes("校验通过")) ||
+      lines.find((l) => l.includes("幽灵字段")) ||
       lines[lines.length - 1];
     console.log(`\u2713 ${summary?.trim() || "OK"}`);
     passed++;