vue-skills：8 个 Vue 3 agent skill，用 eval 决定留不留，但它还是早期实验
项目地址：https://github.com/vuejs-ai/skills
定位
这是一套给 AI agent 用的 Vue 3 开发 skill 集合。
需要先说清楚它的状态：这是个早期实验 / 社区项目。skill 内容从真实问题中提炼，但因为模型可能产生幻觉，可能并不完整，作者欢迎反馈。如果这套东西证明有价值，作者计划提案把项目移交给 Vue 官方组织，让更大范围的社区用上。
也就是说，现在它是「能用，但别当成权威文档」。
安装
npx skills add vuejs-ai/skills
Claude Code Marketplace
/plugin marketplace add vuejs-ai/skills
/plugin install vue-skills-bundle@vue-skills
/plugin install vue-best-practices@vue-skills
/plugin install vue-best-practices@vue-skills vue-router-best-practices@vue-skills
使用方式
想要最可靠的结果，在 prompt 前面加上前缀：
use vue skill,
这样会显式触发 skill，并让 AI 按文档里记录的 pattern 来走。
不加前缀时触发并不稳定，取决于你的 prompt 和 skill 描述里的关键词匹配得有多近。所以如果你发现某次输出没有按预期走，先检查是不是漏了前缀。
可用的 8 个 skill
| Skill | 适用场景 | 覆盖内容 |
|---|---|---|
| vue-best-practices | Vue 3 + Composition API + TypeScript | 最佳实践、常见坑、SSR 指引、性能 |
| vue-options-api-best-practices | Options API（data()、methods） | this 上下文、生命周期、Options API 下的 TypeScript |
| vue-router-best-practices | Vue Router 4 | 导航守卫、路由参数、路由组件生命周期 |
| vue-pinia-best-practices | Pinia 状态管理 | store 设置、响应式、状态模式 |
| vue-testing-best-practices | 组件测试或 E2E 测试 | Vitest、Vue Test Utils、Playwright |
| vue-jsx-best-practices | Vue 中的 JSX | 与 React JSX 的语法差异 |
| vue-debug-guides | 调试 Vue 3 问题 | 运行时错误、警告、异步错误处理、hydration 问题 |
| create-adaptable-composable | 编写可复用 composable | MaybeRef / MaybeRefOrGetter 输入模式 |
示例
vue-best-practices：一个 todo app
Prompt：create a todo app
使用 skill 之后的变化：
- 代码可读性更好
- 组件做了拆分
- 状态被移进 composable（
useTodos.ts） - 原始响应式数据用
shallowRef
create-adaptable-composable：useHidden
Prompt：create a reusable composable for controlling hidden for a element
使用 skill 之后的变化：
- 输入参数改用
MaybeRef和MaybeRefOrGetter，换取响应式上的灵活性
export interface UseHiddenOptions {
hidden?: MaybeRef
initialHidden?: MaybeRefOrGetter
syncAria?: boolean
}
export function useHidden(
target?: MaybeRefOrGetter,
options: UseHiddenOptions = {},
)
方法论
skill 分两类
- Capability：没有这个 skill，AI 就解决不了问题。针对的是版本特定问题、未文档化的行为、较新的特性，或者训练数据之外的边界情况。
- Efficiency：AI 能解决，但解决得不够好。提供的是更优 pattern、最佳实践和一致的做法。
校验流程
每条 skill 规则都要经过自动化 eval 验证：
- Baseline：不安装 skill 直接跑
- With-skill：安装 skill 后跑
只有当一个规则能让模型解决它原本解决不了的问题时，这条规则才会被保留。判定标准写得很直白：
- Baseline 通过 + 加挂 skill 通过 → 视为可移除
- Baseline 失败 + 加挂 skill 通过 → 保留
换句话说，只做「锦上添花」的规则不会留在仓库里。
贡献
开发在 dev 分支进行，main 分支只放已经发布的 skill。
- 从
dev拉 feature 分支 - 向
dev提 PR - 审核通过后合并到
dev - 维护者准备好发布时，通过 GitHub Action 把
dev同步到main
相关项目
- antfu/skills —— Anthony Fu 整理的 Vue / Vite / Nuxt agent skills 集合
- vueuse/vueuse-skills —— 面向 VueUse 开发的 agent skills
- onmax/nuxt-skills —— 面向 Nuxt 开发的 agent skills
License
MIT