Agent Skills
返回列表
💻

VueUse 组合式函数指南

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vueuse-skills。

技能介绍

你在 Vue 里重复造轮子的问题

在 Vue 3 / Nuxt 项目里,响应式状态、DOM 观测、浏览器 API、网络请求 往往被拆成一堆 ref/watch 和事件监听。同类需求每家写法不同,维护成本高,也容易在 SSR、卸载清理上踩坑。VueUse 已经把这些场景封装成 composable,但函数数量多、命名相近,助手若不清楚规则,容易推荐错函数或当场写一套“差不多”的自定义逻辑。

技能如何帮你做选型与落地

本技能把 需求 → VueUse 函数 → 调用方式 串成固定流程:接到 Vue / Nuxt 相关开发任务时,先判断是否有 VueUse 能直接覆盖,再对照函数表里的 Invocation 字段决定怎么用:

  • AUTO:场景匹配即可采用
  • EXTERNAL:仅当用户已安装对应外部依赖时再推荐,否则先评估是否真有必要安装
  • EXPLICIT_ONLY:只有用户点名时才使用

函数按 State、Elements、Browser、Sensors、Network、Animation、Component、Watch 等类目归类;每个条目有简述,具体用法与类型声明以技能内 ./references 文档为准。整体倾向用 composable 替代手写实现,在可读性、可维护性和性能之间取平衡。

适用边界

  • 仅覆盖 VueUse 库内 已列出的函数,不替代完整应用架构设计
  • 用户 prompt 或 AGENTS.md 中的指令可覆盖默认 Invocation 规则
  • EXTERNAL 类函数不应在依赖未安装时默认强推安装

使用场景

  • Nuxt 页面要根据 `prefers-color-scheme` 切换主题并持久化,需选用 `useColorMode` 或 `useDark` 而非自写 localStorage 逻辑
  • 列表页要做无限滚动,需在 `useInfiniteScroll` 与容器 `useScroll` 之间按 DOM 结构选型
  • 表单要 debounce 记录 `ref` 变更历史以便撤销,需对照 `useDebouncedRefHistory` 与 `useRefHistory` 的用法
  • SSE 实时推送要用 `useEventSource`,并确认与 `useFetch` 在可中止请求上的分工

适合人员

  • 维护 Vue 3 管理后台、经常要写 localStorage/session 同步的业务前端,希望统一用 VueUse State 类函数
  • 负责 Nuxt SSR 站点的全栈工程师,需要在服务端安全使用 `useMediaQuery`、`useBreakpoints` 等视口相关 composable
  • 做拖拽上传、剪贴板、全屏等媒体交互的组件库作者,想按 Browser/Sensors 类目选对 API 封装
  • 在 code review 里反复看到自定义 `fetch`/`WebSocket` 封装的团队 Tech Lead,想推动 Network 类函数的标准用法