前言¶
用 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
