Agent Skills
返回列表
💻

VueUse 组合式函数指南

开发编程 更新于 2026.08.30

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

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

技能介绍

你在 Vue / Nuxt 里常遇到什么

实现暗色模式、LocalStorage 持久化、窗口尺寸响应、拖拽上传、useFetch 中止请求、点击外部关闭弹层时,容易自己绑事件、手写 ref + watch,或者不知道 VueUse 里是否已有对应 API。结果是代码重复、生命周期清理遗漏,以及与 SSR 相关的边界没处理好。

这套技能怎么帮你做决策

本技能把 需求 → VueUse 函数 的映射写进分类清单(State、Elements、Browser、Sensors、Network、Animation、Component、Watch 等),并强调 Invocation 规则:

  • AUTO:适用时默认优先考虑该 composable
  • EXTERNAL:仅当用户已安装所需外部依赖时使用,否则先评估是否真有必要安装
  • EXPLICIT_ONLY:仅用户明确要求时才用

工作流程是:先判断需求能否用 VueUse 覆盖,再选定函数并查 ./references 中的 Usage 与类型声明,而不是先写一长段定制逻辑。全局态可用 createGlobalState / createInjectionState;DOM 与视口用 useElementBounding、useIntersectionObserver;网络层用 useFetch、useWebSocket、useEventSource;监听侧有 watchDebounced、until 等。

边界与注意点

清单中的函数均来自 VueUse 生态,不包含 VueUse 表外库的替代方案。用户提示词或 AGENTS.md 可覆盖某函数的默认 Invocation。对标记 EXTERNAL 的条目,不应在未确认依赖的前提下强行推荐安装。

使用场景

  • 在 Nuxt 页面里用 `useFetch` 做可中止请求并替换手写 `fetch` + `AbortController`
  • SSR 项目需要 `useMediaQuery` / `useBreakpoints` 时配合 `useSSRWidth` 统一视口宽度
  • 实现文件拖放上传区,需要选用 `useDropZone` 而不是自己监听 `dragover`/`drop`
  • 弹层与下拉菜单要「点外部关闭」,应对照 `onClickOutside` 与焦点相关的 `useFocusWithin`

适合人员

  • 维护公司 Vue 3 管理后台、希望全局暗色与 `useDark` / `useColorMode` 持久化策略一致的工程师
  • 负责 Nuxt 内容站、要在服务端渲染下正确处理 `useStorage` 与仅浏览器 API 的全栈开发者
  • 做交互密集型前台、需要统一选用 `useDraggable`、`useSwipe`、`useMagicKeys` 而非散落事件监听的前端工程师
  • 在 monorepo 里写可复用 composable、要用 `createSharedComposable` 与 `createInjectionState` 规范跨实例状态的组员