SuperAPI AI 工具集

ub-vuejs

编程与开发

查看项目

更新于 10-28 16:10

技能介绍

用途 该技能用于 Vue 组件与组合式函数(composable)的编写与审查,帮助在代码生成或重构中落实 Vue 核心最佳实践,面向最新稳定版本并结合严格 TypeScript 与可迁移的遗留代码处理。

主要能力

  • 现代模式约束:新代码使用 Composition API、SFC 的 script setup 与 lang="ts",优先使用 defineModel() 处理 v-model 契约、useTemplateRef() 处理模板 ref。
  • 响应式与 watcher 规则:在 script setup 中使用响应式 props 解构,watch 解构 props 时使用 getter 源;组合式函数使用 MaybeRefOrGetter<T> 与 toValue();在 await 边界前同步注册 onWatcherCleanup();优先精确 getter,必要时才用数值 deep。
  • SSR 与 hydration:使用 useId() 生成 SSR 安全 ID,异步组件在首屏下方重区块可采用惰性 hydration,谨慎且局部使用 data-allow-mismatch 并记录理由,Teleport defer 用于同一渲染 tick 后创建目标的情况。
  • 性能与构建:关注稳定 props、代码分割、大列表虚拟化与受控的深层响应性,编译期标志保持显式,避免无测量依据的微优化。
  • 遗留代码防护:不为新代码生成 Options API、class 风格组件、mixins、filters 或 this 中心逻辑;不手写 modelValue 与 update:modelValue 样板;保留遗留模式仅限既有代码的有界兼容,并记录理由与后续现代化路径。

使用方式 先根据 package.json、锁文件、vite.config.、vue.config. 与 TypeScript 配置识别 Vue 版本族与工具链;确认任务属于 Vue 核心范围(SFC、响应性、watcher、SSR 与 hydration、组件契约)。可按需阅读现代模式参考、遗留到现代迁移参考,以及涉及跨技能编写约定时的规范文档。实现后使用项目已有的类型检查、lint、测试进行验证。技能要求输出环境说明、版本说明、模式说明、遗留说明、验证说明,并在非平凡推荐出现官方资料与仓库实际冲突时标注 OFFICIAL_CONFLICT,无法在官方来源确认时标注 UNVERIFIED。

适用场景 Vue 单文件组件编写、组合式函数设计、响应式与 watcher 逻辑调整、组件 props/emits 契约、SSR 与 hydration 相关实现,以及将既有遗留写法逐步迁移到现代模式。

限制 任务主要依赖 Nuxt 运行时行为、app 目录策略、服务端路由或 Nitro 时不使用本技能;主要问题为 Tailwind 集成或纯 CSS 架构时不使用本技能。不使用预发布或 beta 特性,除非明确要求。生成指引中不硬编码版本号;该项目实际版本落后于最新稳定版时提示版本差距与升级路径。关于该技能的收费、价格与平台信息暂未提供。