工具介绍
关于 Vue Skills 的定位、能力与适用场景
Vue Skills(仓库名 vue-skills)是 vuejs-ai 组织维护的一套 Agent Skills,专门解决 AI 编程助手写 Vue 3 时「看起来对、细节全错」的问题。它把 Vue 生态里版本敏感的行为、容易混淆的写法、训练数据覆盖不到的边界情况整理成结构化技能文件,装上之后 AI 会按文档里的模式生成代码,而不是凭印象猜。
仓库目前有 8 个技能,覆盖 Composition API、Options API、Vue Router、Pinia、组件测试、JSX、调试排错和可复用 composable 八条主线。作者把它定位成 early experiment,规则来自真实项目里踩过的坑,但也坦言部分内容可能带模型幻觉,建议先在 demo 里验证再用到生产。
8 个技能
- vue-best-practices:Vue 3 + Composition API + TypeScript 的最佳实践、常见坑、SSR 指导与性能
- vue-options-api-best-practices:Options API 的
this上下文、生命周期与 TypeScript 写法 - vue-router-best-practices:Vue Router 4 的导航守卫、路由参数与路由组件生命周期
- vue-pinia-best-practices:Pinia 的 store 组织、响应式与状态模式
- vue-testing-best-practices:Vitest、Vue Test Utils、Playwright 的组件测试与 E2E
- vue-jsx-best-practices:Vue 里写 JSX 与 React JSX 的语法差异
- vue-debug-guides:运行时错误、警告、异步错误处理与 hydration 问题
- create-adaptable-composable:用
MaybeRef/MaybeRefOrGetter写可复用 composable
怎么安装
一行命令装进支持 Agent Skills 的工具:
npx skills add vuejs-ai/skillsClaude Code 用户也可以走插件市场,整包装或单装:
/plugin marketplace add vuejs-ai/skills
/plugin install vue-skills-bundle@vue-skills
/plugin install vue-best-practices@vue-skills用的时候建议在 prompt 前面加一句 Use vue skill,,显式触发能保证命中,不加前缀时命中率取决于你的描述和技能关键词的匹配程度。
技能是怎么筛出来的
作者把技能分成两类:Capability 指 AI 不装技能就做不对的问题,比如版本特定行为、未文档化的实现、新特性和训练数据之外的边界情况;Efficiency 指 AI 能做但做不好的问题,靠最佳实践把结果拉齐。每条规则都要过自动化 eval:先跑一遍 baseline,再装着技能跑一遍,只有从「失败」变成「通过」的规则才保留,baseline 本来就能通过的会被砍掉。
项目采用 MIT 协议,开发和 PR 走 dev 分支,main 只放发布版本。作者表示如果这套东西确实有价值,会提议把项目转交给 Vue 官方组织维护。同类的还有 antfu/skills、vueuse/vueuse-skills 和 onmax/nuxt-skills,覆盖范围不同,可以并存。
