用途
vue-best-practices 是一个面向 Vue.js 任务的技能，资料说明其「必须」用于 Vue.js 任务。它整理 Vue 3 的最佳实践、常见陷阱与性能优化建议，核心立场是强烈推荐以组合式 API（Composition API）、<script setup> 和 TypeScript 作为标准写法。
主要能力
资料按主题列举了大量具体条目，主要覆盖：
- 响应式：如脚本中访问 ref() 值需使用 .value、解构 reactive() 对象会丢失响应性、ref() 与 reactive() 的取舍、集合中 ref 的访问、shallowRef 性能优化、模板中 ref 解包、响应式代理身份比较、markRaw 用于非响应式库实例、同 tick 批量更新、外部状态管理库集成、用 computed 替代 watchEffect 派生状态等。
- 计算属性：避免副作用、返回值只读、条件依赖、数组变异、与方法的缓存差异、不支持参数、类名逻辑等。
- 侦听器：侦听响应式对象属性、deep watch 性能、watchEffect 中 await 后的依赖收集、flush 时机、watch 与 watchEffect 选择、immediate 选项、新旧值比较、模板 ref 的 flush 等。
- 组件与 Props/Emits：props 只读、事件不冒泡、PascalCase 组件命名、递归组件自引用、局部注册、以 props/emit 替代组件 ref；布尔 prop 转换顺序、组合式函数中 props 响应性丢失、解构 props 的 watch、prop 校验时机、事件命名 kebab-case、事件载荷校验等。
- 模板：v-html 的 XSS 风险、避免 v-if 与 v-for 同用、模板函数无副作用、用计算属性过滤/排序列表、v-if 与 v-show 的取舍。
- 表单与 v-model：defineModel 修饰符、更新后取值的 nextTick、Vue 2 到 Vue 3 的 v-model 变更。
- 事件与修饰符：.once、.exact、鼠标按键修饰符、.passive 与 .prevent 的搭配。
- 生命周期、插槽、Provide/Inject、Attrs、Composables、组合式 API、自定义指令、过渡与动画、KeepAlive、异步组件、渲染函数、Teleport、Suspense、TypeScript、SSR、性能优化、单文件组件（SFC）和插件等多个方向。
每个问题都通过「See xxx」形式指向一条具体条目，例如 ref-value-access、computed-no-side-effects、props-are-read-only、ts-defineprops-type-based-declaration 等。
使用方式
资料仅说明该技能「必须用于」Vue.js 任务，并给出上述主题与条目标识；具体安装命令、调用方式与运行步骤暂未提供。
适用场景
适合在编写、审查或迁移 Vue 3 代码时，按问题（响应式、计算属性、侦听器、组件通信、模板、表单、过渡、KeepAlive、SSR、TypeScript、性能等）查找对应的最佳实践与常见陷阱。
限制
资料未提供收费、价格、平台支持范围与效果说明；安装命令与具体调用步骤暂未提供。