前言¶
uni-app 與 uni-app x 項目往往同時維護 .vue / .uvue 頁面和 pages/ 下的路由結構，端到端測試還要區分 Web、App、鴻蒙與微信小程序等多端腳本。手寫 *.test.js、對照頁面改選擇器、再分別執行 npm run test:*，很容易在「補用例—跑平臺—修失敗」之間來回切換。下面介紹 SkillHub 上的 uniapp-test，它把「讀頁面結構 → 生成或補測試 → 跑指定端 → 修到通過」整理成 Agent 可遵循的一套工作流，而不是單次問答裏的零散建議。
這是什麼¶
uniapp-test（座標 @user_3141f90e/uniapp-test，版本 1.0.0）是社區來源（community）的 Agent Skill，分類爲 dev-programming，由發佈者 user_3141f90e 維護，SkillHub 頁面標註 requires_api_key=false，無需額外 API Key。
一句話定位：面向 uni-app / uni-app x 的自動化測試工程師工作流 Skill——分析 .uvue 或 .vue 頁面，生成或完善同名 *.test.js，在 Web / Android / iOS / 鴻蒙 / 微信小程序上運行測試，並在失敗時協助改寫到通過。
官方入口：
- API / 安裝線索：https://api.skillhub.cn/user_3141f90e/uniapp-test
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_3141f90e/uniapp-test
（SkillHub 當前展示：評分 100000，下載 2382 次。）
核心功能¶
以下能力均來自官方簡介與 SkillHub 頁面說明，未單獨展開實現細節的部分不臆測。
-
頁面結構分析
針對項目中的.uvue、.vue以及pages/目錄下的頁面，爲後續測試用例提供結構依據。 -
測試用例生成與完善
產出或補全與頁面對應的*.test.js，覆蓋常見 uni 自動化 API 場景（簡介中提到的如program.reLaunch、page.$、page.waitFor等）。 -
多端執行
工作流與項目中已有的 npm 測試腳本對齊，包括但不限於：
-npm run test:web
-npm run test:app-android
-npm run test:app-ios
-npm run test:app-harmony
-npm run test:mp-weixin -
失敗修復閉環
運行失敗後繼續在同一 Skill 指導下改用例，直到通過。 -
觸發範圍較寬
用戶提到 uni-app、uniapp、uni-app x、uvue、uni 自動化測試、pages/頁面測試、*.test.js，或表達「爲某頁寫測試 / 跑測試 / 修測試」時，即應啓用本 Skill，即便未明說「自動化測試」四字。
安裝與啓用¶
SkillHub 官方建議：先按 SkillHub 安裝說明 配置 CLI，再將本 Skill 安裝到當前 Agent 實際讀取的 skills 目錄（裝錯目錄會導致 Agent 識別不到）。
1、檢查或安裝 skillhub CLI¶
command -v skillhub && skillhub --version
若未安裝，可使用官方完整安裝腳本（文檔標註沙箱環境需具備聯網權限）：
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、安裝 uniapp-test¶
安裝時必須用 --dir 指向當前環境的 skills 目錄。SkillHub 文檔給出的常見路徑示例：
| 環境 | skills 目錄（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
以 Cursor 爲例：
skillhub install @user_3141f90e/uniapp-test --dir ~/.cursor/skills/
也可將安裝提示直接交給 Agent：「請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_3141f90e/uniapp-test。」
安裝後按所用客戶端要求重啓或刷新 Agent，使 Skill 生效。
典型用法¶
公開頁面未提供獨立的長示例倉庫；可復現的用法是在已具備 uni 自動化測試基建的項目裏，用自然語言驅動上述工作流。
-
爲單個頁面補測試
指明pages/下頁面路徑或.vue/.uvue文件，要求生成或完善對應的*.test.js。 -
按端運行
說明目標平臺，讓 Agent 選擇匹配的腳本，例如 Web 端：
npm run test:web
App Android：
npm run test:app-android
其他端同理使用 test:app-ios、test:app-harmony、test:mp-weixin。
- 失敗後的修復
粘貼失敗日誌或說明斷言/等待超時，要求基於page.$、page.waitFor、program.reLaunch等 API 調整用例並重復執行，直到通過。
經過上面的步驟，Skill 的價值在於把「寫用例、選命令、改選擇器」綁在同一條對話工作流裏，而不是隻生成一段無法與項目腳本對齊的示例代碼。
適用場景與注意¶
適合誰
- 已在 uni-app / uni-app x 工程中使用
*.test.js與npm run test:*的團隊或個人。 - 需要跨 Web、原生 App、鴻蒙、微信小程序多端迴歸，但希望由 Agent 承擔頁面分析與用例迭代的人。
限制與注意
- 本 Skill 不替代本地測試環境：各端仍依賴項目自身的測試框架、模擬器/真機與依賴安裝；Skill 指導的是工作流與用例內容。
- 安裝目錄必須與當前 Agent 一致；官方文檔強調默認裝到
./skills/時 many Agent 不會自動加載。 - 公開 SkillHub 頁未附帶完整
SKILL.md正文鏡像，具體步驟細則以安裝到本地的 Skill 文件爲準。 - 評分與下載量來自 SkillHub 展示，會隨時間變化，引用時以官網爲準。
結尾¶
uniapp-test 把 uni-app 多端頁面測試收斂爲「分析頁面 → 維護 *.test.js → 跑對應 npm run test:* → 修失敗」的 Agent 工作流，適合在已有測試腳本的項目裏減輕手工編排成本。需要安裝或更新時，請使用座標 @user_3141f90e/uniapp-test，並參考 https://www.skillhub.cn/skills/user_3141f90e/uniapp-test 與 https://api.skillhub.cn/user_3141f90e/uniapp-test。
