前言¶
用 uni-app 做一套代码多端发布时，常见问题往往不在语法本身：Vue2 与 Vue3 的写法差异、条件编译与平台 API 的边界、老项目迁移时的兼容策略，以及微信小程序侧的自动化测试搭建，都需要对照文档和项目经验逐项排查。通用大模型能回答概念性问题，但对 uni-app 生态里的具体约定和踩坑点不一定稳定。
下面介绍 SkillHub 上的社区 Skill「Uni-app 开发专家」（坐标 @user_1cf5565c/uniapp-expert），它把 Vue2/Vue3 开发、迁移与小程序测试等方向收敛进一份 SKILL.md 指引，供 Cursor、Claude Code、Codex 等支持 Skills 的 Agent 在对话中按需加载。
这是什么¶
「Uni-app 开发专家」是面向 dev-programming 分类的社区来源（community）Skill，当前版本 1.0.0，由发布者 user_1cf5565c 维护。
官方简介概括为：uni-app 跨平台开发专家技能，涵盖 Vue2/Vue3 开发、Vue2→Vue3 迁移实战、微信小程序自动化测试；并说明融合真实项目踩坑经验，提供从开发到测试的完整解决方案。页面标注 requires_api_key=false，安装使用不依赖额外 API Key。
在 SkillHub 统计中，该 Skill 评分为 100000，下载 16548 次，安装 464 次（数据以 SkillHub 页面展示为准）。
核心功能¶
以下能力均来自官方简介与 SkillHub 元数据，未在资料中出现的细节不作延伸：
- Vue2 / Vue3 下的 uni-app 开发：在跨端场景下对齐框架用法与项目结构相关建议。
- Vue2→Vue3 迁移实战：针对存量 uni-app 项目升级路径与实操注意点（以 Skill 内指引为准）。
- 微信小程序自动化测试：覆盖小程序端测试相关流程与方案方向。
- 开发到测试的闭环表述：Skill 定位强调从编码到测试的连贯支持，而非单点问答。
Skill 本体遵循通用 SKILL.md 格式，由 Agent 读取后影响后续回答与操作步骤的优先级与术语范围。
安装与启用¶
SkillHub 官方页面给出的安装方式是：让 AI 参照安装文档，安装坐标 @user_1cf5565c/uniapp-expert。安装文档地址为：
https://skillhub.cn/install/skillhub.md
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；文档说明若装到默认 ./skills/ 可能无法被 Agent 加载，且通常需要重启客户端后生效。
skillhub install user_1cf5565c/uniapp-expert --dir <你的 Agent skills 目录>
常用路径（摘自 SkillHub 安装文档）：
| Agent / 客户端 | skills 目录 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
在 Cursor 中，也可将官方页面的提示词发给 Agent，例如：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_1cf5565c/uniapp-expert。
由 Agent 按文档完成 CLI 检查、skillhub install 与目录校验。Codex CLI、Claude Code 的差异主要体现在 skills 目录路径 上，安装命令形式相同，均需指定 --dir。
典型用法¶
资料未提供独立的长示例仓库；可复现的入口是 安装完成后，在已加载 Skill 的对话中提出与简介一致的任务。例如：
- 新建或维护 uni-app 页面时，说明目标端（H5、App、微信小程序等）与 Vue 版本，请 Agent 按 Skill 约束给出组件、生命周期与条件编译写法。
- 存量 Vue2 uni-app 计划升级 Vue3 时，列出当前
manifest.json、依赖版本与关键插件，请 Agent 按「Vue2→Vue3 迁移实战」相关指引拆分步骤与风险点。 - 需要微信小程序自动化测试时，说明现有测试栈与 CI 环境，请 Agent 结合 Skill 中测试章节给出可落地的目录与脚本结构建议。
具体命令、配置文件名与测试框架选型以 Skill 包内 SKILL.md 及引用文档为准；本文不列举未在公开页面出现的配置项。
适用场景与注意¶
适合谁
- 日常用 uni-app 交付多端，希望 Agent 默认站在 uni-app + Vue2/Vue3 语境里回答的开发者。
- 正在做 Vue2 向 Vue3 迁移，或需要补齐微信小程序自动化测试方案的团队。
限制与注意
- 来源为 community，内容与更新节奏依赖发布者维护；重大版本升级前建议在 SkillHub 页面确认版本号仍为 1.0.0 或更新说明。
- 评分与下载量为平台统计，不代表对你方技术栈的适配程度；迁移与测试方案仍需在目标工程里验证。
- 安装路径错误会导致 Skill 不被加载，务必使用上文
--dir与对应客户端目录。 - 公开资料未要求 API Key；若后续版本变更标签，以 SkillHub 页面为准。
结尾¶
「Uni-app 开发专家」把 uni-app 跨端开发、Vue 版本迁移与微信小程序自动化测试收敛为一份 Agent Skill，适合在 SkillHub 安装后作为 uni-app 相关对话的默认上下文。官方 Skill 页与 API 入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_1cf5565c/uniapp-expert
- API 地址：https://api.skillhub.cn/user_1cf5565c/uniapp-expert
