@qilitt-mickey/vue3-temp-skill 1.1.25 → 1.1.26

package/SKILL.md

@@ -7,7 +7,25 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 
 # Vue 3 项目开发规范技能包
 
-执行顺序：命中模块 → 读 `core-kernel` → 读命中 `references/<模块>.md` → 生成 → 执行 `code-quality` → 回复含审查结果块。
+执行顺序：运行 `python scripts/match.py "<需求>"` 获取精确匹配 → 按 `load_files` 读参考文件 → 生成 → 按 `quality_gates` 检查 → 执行 `code-quality` → 回复含审查结果块。
+
+> **模块路由优先用脚本**：`python scripts/match.py "需求描述"` 输出 JSON，含命中模块、同批加载、闸门项、加载文件清单。AI 按此结果加载文件，不自行推理匹配。无 Python 环境时回退至下方路由表手动匹配。
+
+### 脚本工具
+
+| 命令 | 用途 |
+|------|------|
+| `python scripts/match.py "<需求>"` | **运行时匹配器**（AI 调用）：输出命中模块、同批加载、闸门项、文件清单 |
+| `python scripts/match.py --batch` | 批量测试 15 个典型场景 |
+| `npm run check` | **发布前全量检查**（5 项任一失败即中断） |
+| `npm run validate` | 结构校验：frontmatter、路由表一致性、孤立模块、交叉引用 |
+| `npm run audit` | 命中精度审计：关键词重叠、盲区、模块评分、边界冲突 |
+| `npm run content` | 内容可用性审计：样板完整性、Must-do 清单 |
+| `npm run deps` | 依赖图分析：断链、循环依赖、引用热度 |
+| `npm run match:batch` | 批量测试（npm 封装） |
+| `node scripts/cli.mjs --list` | 列出所有可用命令 |
+
+> `npm run release` 会自动先执行全量检查，通过后才升版本、提交、发布。
 
 ## 术语约定
 
@@ -77,45 +95,47 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 
 | 模块 | 关键词 |
 |------|--------|
-| **http-api** | 接口、http、加密、API |
-| **crud-pages** | 列表、表格、查询、管理、CRUD、新增编辑、操作列、行操作 |
-| **detail-page** | 详情、编辑页、查看页、新开路由、toDetail、activePath、showLink、顶部 tag |
-| **data-writeback** | 回显、回填、useFormCheck |
-| **permission-auth** | 权限、v-auth、roles、ReAuth |
-| **layout-theme** | 布局、主题、暗黑、`--vts-*`、UnoCSS |
+| **http-api** | 接口、http、加密、API、请求、响应、axios |
+| **crud-pages** | 列表、表格、查询、管理、CRUD、新增、行编辑、操作列、行操作、分页、筛选、批量、排序 |
+| **detail-page** | 详情、编辑页、查看页、新开路由、toDetail、activePath、showLink、顶部 tag、跳转 |
+| **data-writeback** | 回显、回填、回写、useFormCheck、编辑数据 |
+| **permission-auth** | 权限、v-auth、roles、ReAuth、按钮权限、页面权限、角色可见 |
+| **layout-theme** | 布局、主题、暗黑、`--vts-*`、UnoCSS、夜间模式、换肤、侧栏、标签页、面包屑 |
 | **design-system** | 设计规范、UI 规范、按 XX 规范适配、design-tokens、主题色系、令牌体系、暗色模式 |
-| **icons** | 图标、svg-icon、Iconify、ReIconPicker、菜单图标 |
-| **feedback-loading** | message、loading、确认框 |
-| **base-code-dict** | 字典、baseCode、码表 |
-| **api-check** | 联调、mock、契约、对接后端 |
+| **icons** | 图标、svg-icon、Iconify、ReIconPicker、菜单图标、icon |
+| **feedback-loading** | message、loading、确认框、提示、加载、操作反馈、骨架屏 |
+| **base-code-dict** | 字典、baseCode、码表、下拉字典、数据字典 |
+| **api-check** | 联调、mock、契约、对接后端、接口核对 |
+| **i18n-localization** | 国际化、多语言、i18n、vue-i18n、locale、语言切换、语言包、useI18n、ReLanguageSwitch |
+| **auth-pages** | 登录、注册、忘记密码、重置密码、认证、auth、login、register、signup、forgot-password、找回密码（**设计自由，仅规范流程**） |
 | **ui-components** | 新建 Re*、type.ts、组件目录；**用法见各功能模块**（本文件仅索引） |
 
 ### 专项能力包
 
 | 模块 | 关键词 |
 |------|--------|
-| **tree-table** | 树表、ReTreeLine、handleTree |
-| **table-vxe** | vxe、高性能表格 |
-| **form-advanced** | 弹窗、ReDialog、ReDialogResize、锚点、卡片选择、地址解析、ReSelectQuery、级联 |
-| **data-compare** | v-compare、变更汇总 |
-| **file-management** | 附件、ReAttachment、ReFileViewer、预览、上传 |
-| **download-export** | 导出、excel、blob、下载文件 |
-| **rich-text** | 富文本、wangeditor、ReRichText |
-| **chart-echarts** | echarts、图表、ReEchart |
-| **data-screen** | 大屏、dataScreen |
-| **graph-relation** | 图谱、relation-graph |
-| **workflow-bpmn** | bpmn、流程审批 |
-| **flowchart-g6** | g6、流程图 |
-| **data-mapping** | jsplumb、字段映射 |
-| **websocket-realtime** | websocket、ws、实时 |
-| **mobile-h5** | 移动端、H5、vant、vconsole |
-| **wechat-js** | 微信、weixin、wechat |
-| **verify-captcha** | 验证码、滑块、短信 |
-| **qrcode-barcode** | 二维码、条形码 |
-| **feedback-ui** | 通知栏、水印、时间轴、打字机 |
-| **seamless-scroll** | 无缝滚动、跑马灯 |
-| **particles** | 粒子、tsparticles、登录背景粒子 |
-| **directives-advanced** | 一键复制、标题字号自适应 → `v-copy` / `v-auto-font` |
+| **tree-table** | 树表、ReTreeLine、handleTree、树形、树状、层级表格、组织架构、部门树 |
+| **table-vxe** | vxe、高性能表格、虚拟滚动、虚拟表格、大数据表格、单元格编辑 |
+| **form-advanced** | 弹窗、对话框、抽屉、ReDialog、ReDialogResize、锚点、卡片选择、地址解析、ReSelectQuery、级联、远程搜索、下拉选择、高级表单、步骤条、折叠面板、穿梭框、分步表单、联动、动态表单、日历、时间选择、日期选择、拖动、拖拽排序 |
+| **data-compare** | v-compare、变更汇总、变更对比、数据对比、字段对比、高亮变更 |
+| **file-management** | 附件、ReAttachment、ReFileViewer、预览、上传、文件上传、图片上传、断点续传、分片上传、打印、截图、视频播放、音频 |
+| **download-export** | 导出、excel、blob、下载文件、下载、导出Excel |
+| **rich-text** | 富文本、wangeditor、ReRichText、编辑器、Markdown |
+| **chart-echarts** | echarts、图表、ReEchart、折线图、柱状图、饼图、统计图、雷达图、散点图、热力图、趋势图、地图、甘特图 |
+| **data-screen** | 大屏、dataScreen、数据大屏、看板、数据看板、仪表盘、全屏可视化 |
+| **graph-relation** | 图谱、relation-graph、关系图、知识图谱、关系网络 |
+| **workflow-bpmn** | bpmn、流程审批、审批流、工作流、审批流程 |
+| **flowchart-g6** | g6、流程图、拓扑图、antv、自定义流程图、流程设计 |
+| **data-mapping** | jsplumb、字段映射、连线映射、数据映射 |
+| **websocket-realtime** | websocket、ws、实时、消息推送、实时推送、在线状态 |
+| **mobile-h5** | 移动端、H5、vant、vconsole、手机 |
+| **wechat-js** | 微信、weixin、wechat、js-sdk |
+| **verify-captcha** | 验证码、滑块、短信验证、拖拽验证、图片验证码 |
+| **qrcode-barcode** | 二维码、条形码、扫码 |
+| **feedback-ui** | 通知栏、水印、时间轴、打字机、展示组件、空状态 |
+| **seamless-scroll** | 无缝滚动、跑马灯、marquee、滚动公告 |
+| **particles** | 粒子、tsparticles、登录背景粒子、粒子动画 |
+| **directives-advanced** | 一键复制、复制、标题字号自适应、字号自适应 → `v-copy` / `v-auto-font` |
 
 ### 匹配规则
 
@@ -125,16 +145,36 @@ tags: [vue3, typescript, element-plus, vant, pinia, vite, unocss, crud, componen
 4. 默认不改 `vite.config.ts` / `build/**`；**例外**：按 `addon-enable.md` 恢复 FileViewer / VantResolver / Vconsole 等占位插件时允许改 `build/plugins/*`
 5. 效果匹配：
    - 启用 echarts / vant / file-viewer / 富文本等已删 addon → 功能模块 + **`addon-enable`**
-   - 弹窗 → `form-advanced`
+   - 弹窗、对话框、抽屉 → `form-advanced`
+   - 远程搜索下拉、级联选择 → `form-advanced`
+   - 步骤条、分步表单、穿梭框、折叠面板、动态表单 → `form-advanced`
+   - 日历、时间选择、日期选择、联动 → `form-advanced`
    - 点一下复制 → `directives-advanced`（`v-copy`）
    - 标题字跟着宽度变小 → `directives-advanced`（`v-auto-font`）
-   - 角色可见 → `permission-auth`
-   - 变更汇总 → `data-compare`
-   - 导出 Excel → `download-export`
+   - 角色可见、按钮权限 → `permission-auth`
+   - 变更对比、数据对比 → `data-compare`
+   - 导出、下载文件 → `download-export`
    - 菜单/本地图标 → `icons`
    - 粒子背景 → `particles`
+   - 树形列表、层级表格、组织架构、部门树 → `tree-table`
+   - 虚拟滚动、大数据表格 → `table-vxe`
+   - 骨架屏 → `feedback-loading`
+   - 空状态 → `feedback-ui`
+   - 标签页、面包屑 → `layout-theme`
+   - 批量操作、表格排序 → `crud-pages`
+   - 趋势图、地图、甘特图 → `chart-echarts`
+   - 附件上传、断点续传 → `file-management`
    - 按 XX / UI 规范适配、设计交接块、整站风格重构 → `design-system`（项目设计系统说明）+ `layout-theme`；有令牌/交接产出时加读 `design-handoff.md`（逐文件修改清单）+ 设计 Skill `project-implementation-protocol.md`
    - 列表→独立详情/编辑页 → `crud-pages` + `detail-page`
+   - 图表（折线/柱状/饼图） → `chart-echarts`
+   - 数据大屏、看板 → `data-screen`
+   - 实时推送、在线状态 → `websocket-realtime`
+   - BPMN 流程、审批、工作流 → `workflow-bpmn`
+   - 自定义流程图、流程设计、拓扑 → `flowchart-g6`
+   - 国际化、多语言、i18n、语言切换 → `i18n-localization`
+   - 注册、忘记密码、重置密码、认证 → `auth-pages`（设计自由，仅规范流程；含验证码 → `verify-captcha`）
+   - 打印、截图 → `file-management`（ReFileViewer）
+   - 视频播放、音频 → `file-management`（ReFileViewer 文件预览）
 6. 独立详情路由：跳转与 meta 见 `detail-page`（`toDetail` / `showLink` / `activePath` / `initToDetail`）
 
 ## 速查约定（细则见对应模块）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qilitt-mickey/vue3-temp-skill",
-  "version": "1.1.25",
+  "version": "1.1.26",
   "description": "Vue 3 企业级中后台项目开发规范技能包 — core-kernel 架构、按需功能模块",
   "bin": {
     "vue3-temp-skill": "./bin/cli.js"
@@ -12,6 +12,7 @@
   "files": [
     "bin/",
     "references/",
+    "scripts/",
     "SKILL.md",
     "README.md"
   ],
@@ -22,6 +23,19 @@
     "release": "node release.js",
     "release:minor": "node release.js minor",
     "release:major": "node release.js major",
+    "check": "scripts\\check.cmd",
+    "prepack": "scripts\\check.cmd",
+    "validate": "node scripts/validate.mjs",
+    "audit": "node scripts/ai-match-audit.mjs",
+    "content": "node scripts/ai-content-audit.mjs",
+    "deps": "node scripts/analyze-deps.mjs",
+    "deps:hot": "node scripts/analyze-deps.mjs --hot",
+    "deps:mermaid": "node scripts/analyze-deps.mjs --mermaid",
+    "match": "python scripts/match.py",
+    "match:batch": "python scripts/match.py --batch",
+    "gen:index": "node scripts/generate-index.mjs",
+    "gen:index:write": "node scripts/generate-index.mjs --write",
+    "scaffold": "node scripts/scaffold-module.mjs",
     "postpublish": "echo 'Published @qilitt-mickey/vue3-temp-skill to npmjs.org'"
   },
   "keywords": [

package/references/auth-pages.md

@@ -0,0 +1,217 @@
+---
+skill: auth-pages
+description: 登录/注册/忘记密码认证流程、API 模式、userStore 集成、路由配置
+scope: project
+tags: [登录, 注册, 忘记密码, 重置密码, 认证, auth, login, register, signup, forgot-password, 找回密码]
+---
+
+# 认证流程规范（登录 / 注册 / 忘记密码）
+
+> **页面设计自由**：认证页面的视觉布局、交互形式、背景效果均由设计主导，本模块仅规范**认证流程、API 模式、Store 集成、路由配置**。勿将此处代码片段当作页面样板整段抄录，仅提取流程模式。
+>
+> **验证码/滑块组件**：见 `verify-captcha` 模块（ReVerify 滑块拼图、ReDragVerify 拖拽验证、ReImageVerify 图片验证码、ReSmsCode 短信倒计时）。本模块不重复其用法。
+
+## 涉及文件
+
+```
+src/
+├── api/login/index.ts          # 认证 API（按后端实际接口调整字段）
+├── store/modules/user.ts       # useUserStore：login()、logOut()、token 管理
+├── views/login/                # 登录页（设计自由，仅流程受规范）
+├── utils/rule.ts               # 表单校验规则
+└── router/                     # 认证页路由（showLink:false）
+```
+
+## API 模式
+
+> 字段名和接口路径按后端实际定义，以下仅展示结构模式。**勿将字段当作硬约束**。
+
+```typescript
+// src/api/login/index.ts
+import { http } from '@/utils/http'
+
+// 接口参数类型 — 字段按后端实际定义
+interface LoginParams {
+  [key: string]: any  // 常见：账号、密码、验证码等，字段名不固定
+}
+
+// 登录返回 — 结构按后端实际返回
+interface LoginResult {
+  [key: string]: any  // 常见：token、用户信息等，字段名不固定
+}
+
+/** 登录 */
+export const getLogin = (data: LoginParams) => {
+  return http.request<Result<LoginResult>>('post', '/auth/login', { data })
+}
+
+/** 发送短信验证码 */
+export const sendSmsCode = (params: Record<string, any>) => {
+  return http.request<Result<null>>('post', '/auth/sms-code', { data: params })
+}
+
+// 注册/忘记密码 API 按需新增，遵循同一模式：
+// 1. 参数类型用 interface 声明，字段按后端定义
+// 2. 返回值用 Result<T> 包裹
+// 3. 方法名语义化（getRegister、sendResetLink、resetPassword）
+```
+
+## 认证流程模式
+
+> 无论页面长什么样，认证流程必须遵循以下链路。
+
+```
+用户输入 → 表单校验 → [验证码校验] → 调用 API → useUserStore 处理 token → initRouter → 跳转首页
+```
+
+### 1. Store 集成
+
+```typescript
+// store/modules/user.ts — 认证状态管理
+export const useUserStore = defineStore('user', {
+  state: () => ({
+    token: '',
+    userInfo: null as any,
+  }),
+  actions: {
+    // 登录：调用 API → 存 token → 返回结果
+    async login(data: Record<string, any>) {
+      const res = await getLogin(data)
+      if (res.status === 200 && res.data) {
+        // token 存储方式按项目实际（localStorage / cookie / pinia 持久化）
+        this.token = res.data.accessToken ?? ''
+        // 用户信息按后端返回结构存储
+        this.userInfo = res.data
+      }
+      return res
+    },
+    // 退出
+    logOut() {
+      this.token = ''
+      this.userInfo = null
+      // 清除存储、跳转登录
+    },
+  },
+})
+```
+
+### 2. 登录流程
+
+```typescript
+// 登录页脚本 — 仅展示流程，页面模板设计自由
+import { useUserStoreHook } from '@/store/modules/user'
+import { getTopMenu, initRouter } from '@/utils/router'
+
+const useUserStore = useUserStoreHook()
+const router = useRouter()
+const loading = ref(false)
+
+async function handleLogin(formData: Record<string, any>) {
+  loading.value = true
+  try {
+    const res = await useUserStore.login(formData)
+    if (res.status === 200) {
+      // 初始化路由（动态路由/权限路由）
+      await initRouter(router)
+      // 跳转到首页或来源页
+      router.push(getTopMenu().path)
+    }
+  } finally {
+    loading.value = false
+  }
+}
+```
+
+### 3. 注册流程
+
+```typescript
+// 注册页脚本 — 仅展示流程
+import { getRegister } from '@/api/login'
+
+async function handleRegister(formData: Record<string, any>) {
+  loading.value = true
+  try {
+    const res = await getRegister(formData)
+    if (res.status === 200) {
+      // 注册成功 → 跳转登录或自动登录
+      router.push('/login')
+    }
+  } finally {
+    loading.value = false
+  }
+}
+```
+
+### 4. 忘记密码流程
+
+```typescript
+// 忘记密码 — 分步流程，页面交互设计自由
+const step = ref(1) // 步骤数按实际流程定
+
+// 步骤 1：验证身份 → 发送重置凭证
+async function handleSendReset(account: string) { /* 调用 API */ }
+
+// 步骤 2：重置密码
+async function handleReset(formData: Record<string, any>) { /* 调用 API */ }
+
+// 步骤 3：完成 → 跳转登录
+function handleDone() {
+  router.push('/login')
+}
+```
+
+## 路由配置
+
+```typescript
+// 认证页路由统一约定
+{
+  path: '/login',
+  name: 'Login',
+  component: () => import('@/views/login/index.vue'),
+  meta: {
+    title: '登录',
+    showLink: false,       // 不在菜单显示
+    activePath: '/login',  // 高亮路径
+  },
+}
+// 注册/忘记密码页同理：showLink: false + activePath
+```
+
+## 表单校验模式
+
+> 校验规则按业务实际调整，以下为常见模式。
+
+```typescript
+import { loginRules } from '@/utils/rule'
+
+// 必填校验
+const rules = {
+  // 字段名按表单实际定义，不固定
+  account: [{ required: true, message: $t('请输入账号'), trigger: 'blur' }],
+  password: [{ required: true, message: $t('请输入密码'), trigger: 'blur' }],
+}
+
+// 密码确认校验（注册/重置密码场景）
+const confirmPasswordRule = {
+  validator: (rule: any, value: string, callback: any) => {
+    if (value !== formData.password) {
+      callback(new Error($t('两次密码不一致')))
+    } else {
+      callback()
+    }
+  },
+  trigger: 'blur',
+}
+```
+
+## Must-do 清单
+
+1. **认证流程链路**：`API → useUserStore.login() → initRouter() → 跳转`，勿另起流程
+2. **页面设计自由**：布局、背景、交互形式由设计主导，本模块不约束视觉
+3. **API 字段动态**：参数和返回值字段按后端实际定义，勿硬编码字段名
+4. **验证码组件**：见 `verify-captcha` 模块，不在本模块重复
+5. **路由约定**：认证页 `showLink: false` 不在菜单显示，`activePath` 指向自身
+6. **路由白名单**：登录/注册/忘记密码页在路由守卫白名单中，无需 token
+7. **国际化**：所有提示文案用 `$t()` 包裹
+8. **密码确认**：注册和重置密码须有确认密码字段 + 自定义校验
+9. **loading 状态**：提交期间禁用按钮，防止重复提交

package/references/base-code-dict.md

@@ -1,3 +1,10 @@
+---
+skill: base-code-dict
+description: 基础代码字典获取、缓存、useApp().baseCodeGet、filterValue
+scope: project
+tags: [字典, baseCode, 码表, 下拉字典, 数据字典]
+---
+
 # 基础代码（字典）
 
 > 按本文件示例编写，复用 `useApp().baseCodeGet` / `filterValue` 等已有码表能力，勿另起一套字典请求与缓存。

package/references/chart-echarts.md

@@ -2,7 +2,7 @@
 skill: chart-echarts
 description: ECharts 图表与 ReEchart 封装。词云等扩展按项目依赖。
 scope: project
-tags: [echarts, ReEchart, chart, wordcloud]
+tags: [echarts, ReEchart, chart, wordcloud, 折线图, 柱状图, 饼图, 统计图, 雷达图, 散点图, 热力图, 趋势图, 地图, 甘特图, K线图]
 ---
 
 # 图表（ECharts）

package/references/crud-pages.md

@@ -2,7 +2,7 @@
 skill: crud-pages
 description: 查询列表页、表单页、标准 CRUD。含 useTableSearch、列表标准样板、表单约定。
 scope: project
-tags: [vue3, crud, list, form, detail, table, useTableSearch, page, layout]
+tags: [vue3, crud, list, form, detail, table, useTableSearch, page, layout, 批量, 排序, 批量操作]
 ---
 
 # CRUD 页面开发规范

package/references/data-compare.md

@@ -1,3 +1,10 @@
+---
+skill: data-compare
+description: 编辑页数据变更对比：v-compare、compareStore、ChangeSummaryService
+scope: project
+tags: [v-compare, 变更汇总, 变更对比, 数据对比, 字段对比, 高亮变更]
+---
+
 # 数据变更对比
 
 > 按本文件示例编写，复用 `v-compare` / `compareStore` / `ChangeSummaryService` 等已有能力，勿另起一套对比实现。

package/references/data-mapping.md

@@ -1,3 +1,10 @@
+---
+skill: data-mapping
+description: jsplumb 数据映射页面结构和连线初始化
+scope: project
+tags: [jsplumb, 字段映射, 连线映射, 数据映射]
+---
+
 # JsPlumb 数据映射
 
 > 按本文件示例编写；必须使用选型表中的 `jsplumb`（见 project-inventory），勿改用同类其他连线库；新依赖须待确认。

package/references/data-screen.md

@@ -1,3 +1,10 @@
+---
+skill: data-screen
+description: 大屏等比缩放、1920x1080 设计稿、transform: scale()、grid-layout-plus
+scope: project
+tags: [大屏, dataScreen, 数据大屏, 看板, 数据看板, 仪表盘, 全屏可视化]
+---
+
 # 数据大屏
 
 > 按本文件示例编写，复用项目已有布局与图表封装；缩放/适配按本规范实现，勿另起一套大屏方案。

package/references/data-writeback.md

@@ -1,3 +1,10 @@
+---
+skill: data-writeback
+description: 编辑回显用 Object.assign(formData, res.data) 避免破坏响应式
+scope: project
+tags: [回显, 回填, 回写, useFormCheck, Object.assign, 编辑数据]
+---
+
 # 数据回写与编辑
 
 > 按本文件示例编写，复用项目已有回显/回填约定与选择器回写方式，勿另起一套表单赋值实现。

package/references/directives-advanced.md

@@ -1,3 +1,10 @@
+---
+skill: 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,3 +1,10 @@
+---
+skill: download-export
+description: 导出/下载必须带 responseType blob，使用 blobDown 或项目已有下载工具
+scope: project
+tags: [导出, excel, blob, 下载文件, 下载, 导出Excel]
+---
+
 # 下载与导出
 
 > 按本文件示例编写，复用项目已有下载/导出工具与封装，勿另起一套文件流处理。

package/references/feedback-loading.md

@@ -1,3 +1,10 @@
+---
+skill: feedback-loading
+description: Message、Loading、MessageBox、NoticeBar 反馈和加载
+scope: project
+tags: [message, loading, 确认框, 提示, 加载, 操作反馈, 骨架屏, skeleton]
+---
+
 # 反馈与 Loading
 
 > 按本文件示例编写，复用项目已有 Message / Loading / MessageBox 封装，勿另起一套提示方案。

package/references/feedback-ui.md

@@ -1,3 +1,10 @@
+---
+skill: feedback-ui
+description: ReNoticeBar、水印、时间轴、打字机等展示类反馈组件
+scope: project
+tags: [通知栏, 水印, 时间轴, 打字机, 展示组件, 空状态, empty]
+---
+
 # 展示类反馈组件
 
 > 按本文件示例编写，复用项目已有反馈类组件与 Hook，勿另起一套展示实现。

package/references/file-management.md

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

package/references/flowchart-g6.md

@@ -1,3 +1,10 @@
+---
+skill: flowchart-g6
+description: '@antv/g6 + g6-extension-vue 流程图，支持 Vue 节点'
+scope: project
+tags: [g6, 流程图, 拓扑图, antv, G6流程图, 自定义流程图, 流程设计, 拓扑]
+---
+
 # G6 流程图（@antv/g6 v5）
 
 > 按本文件示例编写；必须使用选型表中的 `@antv/g6`（见 project-inventory），勿改用同类其他流程图库；新依赖须待确认。

package/references/form-advanced.md

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

package/references/graph-relation.md

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