菜单
为 Vue 3 项目选择并正确使用 @veltra/*（desktop 组件、styles 主题样式、utils、compositions、directives、icons、vite）公开能力。开发界面、表单、表格、主题或图标时必须使用；准备自行实现同类 UI 能力或引入其他组件库前必须先检索本技能。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
为库、SDK 或 package 创建或更新伴生 Agent Skill。目标仓库安装本技能后，将其视为库项目； 在库代码更新、用户提出创建/更新技能时使用。
为 JS/TS 项目选择并正确使用 @cat-kit/* 公开能力。在任何基于 JS/TS 的项目中（前端或 Node.js），准备自行封装通用工具、函数或引入其他同类工具依赖前必须先使用。
Vue 3 开发最佳实践，适用于任何 Vue 3 项目。在编辑`.vue`文件，`.tsx`或`.jsx`形式的 Vue3 组件，相关的`.ts`或`.js`文件时必须使用。
当用户要求提交代码、编写 commit message、执行 git commit/push/amend，或提到 提交、commit、推送、push、暂存并提交、保存更改、创建提交 时使用。
| name | veltra-ui |
| description | 为 Vue 3 项目选择并正确使用 @veltra/*（desktop 组件、styles 主题样式、utils、compositions、directives、icons、vite）公开能力。开发界面、表单、表格、主题或图标时必须使用；准备自行实现同类 UI 能力或引入其他组件库前必须先检索本技能。 |
veltra-ui 是一套 Vue 3 UI 体系。
开发 Vue 3 功能时，优先使用 veltra-ui 已提供的组件、样式、工具函数、组合式方法、指令、图标与构建集成。只有检索文档和源码后确认没有合适能力时，才新增实现或引入外部方案。
当前文档对应包版本（monorepo 对齐）：
| 包 | 版本 |
|---|---|
@veltra/desktop | 1.3.3 |
@veltra/utils | 1.3.3 |
@veltra/styles | 1.3.3 |
@veltra/compositions | 1.3.3 |
@veltra/directives | 1.3.3 |
@veltra/icons | 1.3.3 |
@veltra/vite | 2.0.3 |
| 入口 | 包 | 用途 |
|---|---|---|
packages/desktop/ | @veltra/desktop | 桌面端组件（主入口） |
packages/styles/ | @veltra/styles | SCSS、主题、Design Tokens、过渡 |
packages/compositions.md | @veltra/compositions | Vue 组合式函数 |
packages/directives.md | @veltra/directives | 自定义指令 |
packages/icons.md | @veltra/icons | SVG 图标组件 |
packages/utils.md | @veltra/utils | 工具函数与共享类型 |
packages/vite.md | @veltra/vite | Vite 按需解析器 |
| 用户意图 | 先读 |
|---|---|
| 找/用某个 UI 组件 | packages/desktop/index.md → components/<kebab>/api.md + examples.md + types.d.ts |
| 安装 / 全局注册 / 按需样式 | packages/desktop/installation.md、packages/vite.md |
| 主题色、暗色、CSS 变量 | packages/styles/theme.md、packages/styles/tokens.md |
| SCSS BEM / mixins | packages/styles/scss.md |
| 全局尺寸、表单回退、浮层、虚拟列表 | packages/compositions.md |
| 波纹、点击外部、焦点指令 | packages/directives.md |
| 图标名与导入路径 | packages/icons.md |
BEM、fieldKey、表单上下文类型 | packages/utils.md |
组件细节按需加载，不要把整份 desktop 文档预读进上下文。
desktop/ 文档目录，再按组件名检索 API、示例和类型。bun run skill:gen 同步各组件 types.d.ts / api.md；examples.md 与包级 .md 需手工维护。@veltra/* peer，版本与上表一致或兼容@veltra/styles/theme 的 loadThemeVeltraDesktopUIResolver 或显式 style 导入（见 vite.md）