前言¶

uni-app 微信小程序开发里，重复性的坑很多：pages.json 的路由与 tabBar 配置容易写错，Vue2 和 Vue3 的语法差异常被混用，条件编译写错了在特定平台直接不生效，网络请求没有统一封装导致每个页面各写一遍。把这类任务交给编码 Agent 时，问题更明显——Agent 需要明确知道 uni-app 的项目约定、可用的 uni 组件与 API、以及小程序特有的生命周期，否则产出的代码常常跑不起来。

下面介绍的这个 Skill，作用就是给 Agent 补上这些约定，让它按 uni-app 规范产出页面、组件、路由、状态管理和网络请求代码。

这是什么¶

Uniapp小程序开发Skill 是一个面向 uni-app 微信小程序的专家级 Skill，用于指导 Agent 创建、开发、调试 uni-app 项目（同时覆盖 Vue2 与 Vue3 语法）。

它由社区发布者 user_af8afc9a 维护，坐标 @user_af8afc9a/ray-uniapp-miniapp-skill，当前版本 1.0.0，分类为 dev-programming，来源标记为 community，标签显示 requires_api_key=false，即使用时不需要 API Key。

Skill 采用通用的 SKILL.md 格式，因此可以在支持该格式的 Agent 工具里直接启用。

核心功能¶

根据官方简介，这个 Skill 覆盖以下能力：

• 使用 uni-app 框架（Vue2 与 Vue3 语法）创建、开发、调试微信小程序。
• 编写符合规范的页面、组件、路由、状态管理、网络请求与交互逻辑。
• 处理小程序特有的生命周期、条件编译、uni 组件、uni API 与平台差异场景。

它的触发方式有两条。一是用户直接提出需求，例如“开发小程序”“写一个 uni-app 页面”“创建 uni-app 组件”“封装 request 请求”“实现 uni-app 功能”；二是项目根目录存在 pages.json、main.js、App.vue、manifest.json 等 uni-app 项目特征文件。满足其中一条，就可以启用这个 Skill。

安装与启用¶

这个 Skill 是通用 SKILL.md 格式，没有独立的安装命令或依赖。启用方式是把 Skill 文件放到 Agent 工具约定的 Skills 目录下，或通过 @user_af8afc9a/ray-uniapp-miniapp-skill 这个坐标引用它，之后在对话中触发上述条件即可。

不同 Agent 工具对 SKILL.md 的目录约定不同，具体路径请以所用工具的文档为准。由于官方页面在抓取时不可访问，本节不给出未经核实的具体目录路径或命令。

典型用法¶

下面给出几种符合该 Skill 定位的典型需求，均来自官方简介中列举的触发场景：

1、开发一个新页面。用户提出“写一个 uni-app 页面”，Agent 启用 Skill 后，按 uni-app 规范创建页面文件，并同步在 pages.json 里登记路由。

2、封装网络请求。用户提出“封装 request 请求”，Skill 指导 Agent 把 uni.request 封装成统一的请求模块，供各页面复用，而不是在每个页面里重复写请求逻辑。

3、处理平台差异。涉及条件编译、小程序生命周期或 uni API 时，Skill 提供对应约定，避免 Agent 混用 Vue2/Vue3 语法或写错小程序特有的调用方式。

适用场景与注意¶

适合已经在用 uni-app 开发微信小程序、希望让编码 Agent 产出可运行代码的开发者或团队。

需要注意两点。第一，Skill 只提供规范指导，项目本身的 pages.json、manifest.json 等配置仍需开发者确认，Agent 生成的内容建议在真机或开发者工具里验证后再合入。第二，官方页面在抓取时不可访问，评分、下载量等数据请以 SkillHub 页面实时显示为准；本页引用的数据来自抓取时的资料。

结尾¶

这个 Skill 的价值在于把 uni-app 微信小程序的常见约定固化下来，让 Agent 不必从零摸索，减少路由、条件编译、生命周期这类问题上的返工。

官方地址：https://api.skillhub.cn/user_af8afc9a/ray-uniapp-miniapp-skill ；SkillHub 页面：https://www.skillhub.cn/skills/user_af8afc9a/ray-uniapp-miniapp-skill