Vue 3 组合式开发
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/antfu-skills-vue。
技能介绍
问题在哪
用大模型写 Vue 时,常见问题不是「能不能跑」,而是风格漂移:一会儿 Options API 和 data(),一会儿在 setup 里手写冗长的 props 类型,或者把本可用 shallowRef 的大数据结构全做成深度响应式。Vue 3.5 的 script setup 宏、defineModel、以及 composable 拆分,其实都有明确写法;若助手不跟着这套约束走,你后期合并 PR 时要花大量时间改格式和 API 选择。
技能怎么约束输出
这份技能把 Vue 3.5 + Composition API 当成默认路径,并写明几条硬偏好:优先 TypeScript、在不需要深层响应性时用 shallowRef 而不是 ref,尽量用 <script setup> 与宏(defineProps、defineEmits、defineModel、defineExpose、defineOptions、defineSlots 等),同时不鼓励 Reactive Props Destructure。
在能力表上,它把话题分成两块:
- 响应式与生命周期:
computed、watch/watchEffect、effectScope、生命周期钩子,以及把逻辑抽到 composable 的习惯 - 内置组件与指令:
Transition、Teleport、Suspense、KeepAlive、v-memo、自定义指令等进阶用法
这样当你描述页面结构或状态流时,助手会更倾向于给出可维护的组合式代码,而不是混用旧版 Options 写法。
适用边界
技能是编码规范与 API 选型指南,不会替你跑构建、配 Vite 插件或解决具体业务后端接口。若项目仍大量遗留 Options API,需要你在对话里说明迁移范围;它也不会自动替你查阅你本地的 eslint / unplugin 配置,边界仍以你仓库的 toolchain 为准。
使用场景
- 新功能要用 defineModel 做双向绑定,希望生成物符合 Vue 3.5 宏写法而非手写 props/emit
- 列表页大数据状态更新频繁,需要助手默认用 shallowRef 避免不必要的深度响应式开销
- 异步路由或骨架屏场景,要求代码里正确使用 Suspense、Teleport 等内置组件组合
- 把重复逻辑抽成 composable 时,需要 watchEffect、effectScope 与生命周期钩子用法一致
适合人员
- 维护 Vue 3 中台前端的工程师,希望 PR 里不再混进 Options API 与 Composition API
- 负责组件库迭代的开发者,需要 defineSlots、defineExpose 等宏在示例代码里写法统一
- 从 Vue 2 迁移到 3.5 的项目负责人,要在对话中固定 TypeScript + script setup 默认策略
- 做性能优化的前端,希望在表单/表格类场景里少踩 ref 深度监听带来的渲染抖动