前言¶
小程序真機自動化測試往往要登錄 minitest.weixin.qq.com 控制台，或通過開放接口提交任務、查狀態、維護測試計劃與用例。日常開發裏，這些操作分散在文檔、控制台和 CI 腳本之間，Agent 很難按統一語境幫你執行。
SkillHub 上的「小程序雲測」Skill（座標 @user_05b87ff0/minitest）把微信 MiniTest 雲測能力封裝成 Agent 可讀的說明與調用約定，面向僅通過外部服務（minitest.weixin.qq.com）完成的自動化測試相關操作。下面介紹它是什麼、能做什麼，以及如何安裝與使用。
這是什麼¶
「小程序雲測」是社區來源（community）的 dev-programming 類 Skill，當前版本 1.0.0，發佈者爲 user_05b87ff0。
Skill 簡介寫明：MiniTest（小程序雲測）用於微信小程序自動化測試（External Service Only）。適用場景包括：提交測試任務、查詢任務狀態、管理測試計劃與測試用例、處理質量檢測任務；底層依賴微信雲測服務，文檔入口爲 MiniTest 官方文檔。
微信官方對 MiniTest 的定位是：由微信測試團隊自主研發、聯合 WeTest 雲真機推出的小程序自動化測試服務，基於雲真機支持真機自動化測試與性能分析等能力。Skill 本身不替代雲測平臺，而是讓 Agent 在對話中按 Skill 指引調用該外部服務。
SkillHub 頁面標註 requires_api_key=true，使用前需具備雲測相關 API 密鑰或憑證（具體字段以 Skill 安裝後的 SKILL.md 與微信開放文檔爲準）。
核心功能¶
以下能力均來自 Skill 官方簡介與微信 MiniTest 文檔中可與本 Skill 對應的部分；Skill 負責指導 Agent 何時、如何對接外部服務。
- 測試任務：提交測試任務、查詢任務狀態（與雲測 HTTPS 提測、任務通知等能力一致，見官方「支持持續集成」說明）。
- 測試資產：管理測試計劃、測試用例（對應雲測側的用例與計劃能力；自動化形態包括智能化 Monkey、錄製回放、自定義測試 Minium、AI 自定義測試等，見官方文檔「豐富的自動化測試能力」）。
- 質量檢測：處理質量檢測（質檢）任務；官方文檔描述雲測可將自動化測試與啓動性能等結合，從啓動性能、運行時性能、兼容性、網絡性能等方面輸出質檢報告。
- 性能與真機：雲測服務支持啓動性能專項、真機體驗評分、資源佔用分析等（Skill 側通過同一外部服務間接覆蓋，細節以 minitest 控制台與 API 爲準）。
SkillHub 統計（頁面展示）：評分 100000，下載 4204 次，安裝 188 次。
安裝與啓用¶
安裝 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
安裝本 Skill¶
SkillHub 頁面給出的安裝方式爲：參照 SkillHub 安裝說明，安裝座標 @user_05b87ff0/minitest。
命令行示例（必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝在 ./skills/ 可能不會被識別）：
skillhub install @user_05b87ff0/minitest --dir <skills 目錄>
常見 Agent 的 skills 路徑（來自 SkillHub 安裝文檔）：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按你所用 Client 的要求重啓或刷新 Agent，並配置雲測 API Key（requires_api_key=true）。
典型用法¶
本 Skill 爲 External Service Only：Agent 在用戶提出與雲測相關的需求時，應依據 Skill 內說明調用 minitest.weixin.qq.com 側能力，而不是在本地模擬真機。
可與 Agent 配合的典型意圖（與 Skill 簡介一致）：
- 提交一輪小程序雲測任務（如指定開發版/體驗版/線上版，以雲測支持的版本爲準）。
- 根據任務 ID 或名稱查詢任務狀態，並在結束後查看報告鏈接或通知配置（雲測支持郵箱、手機號任務結束通知，見官方文檔）。
- 創建或調整測試計劃、關聯測試用例（含錄製回放、Minium 自定義測試、AI 自定義測試等類型，以你在雲測項目中已配置的能力爲準）。
- 發起或跟進小程序質量檢測任務，獲取質檢報告中的啓動、運行時、兼容性、網絡等維度結果。
若需接口級參數與示例，以微信開放文檔 MiniTest 小程序雲測 及文檔內的 HTTPS 提測、質量檢測等章節爲準；Skill 安裝包內的 SKILL.md 會約束 Agent 的工具與字段用法。
適用場景與注意¶
適合誰
- 已在使用或計劃使用微信 MiniTest 雲測的小程序團隊，希望在 Cursor、Claude Code、Codex 等環境中用自然語言驅動提測、查狀態、管計劃與用例。
- 需要把雲測與 DevOps、持續集成結合，又希望減少在控制台與文檔間來回切換的開發者。
限制與注意
- 僅外部服務：所有真機與報告能力依賴
minitest.weixin.qq.com，需微信側賬號、項目與 API 憑證；免費額度與時長規則以官方文檔爲準（例如文檔記載每週免費測試時長等說明）。 - 必須配置 API Key：Skill 標籤標明
requires_api_key=true，未配置時 Agent 無法合法調用接口。 - 自動化類型各有邊界：例如智能化 Monkey 不支持輸入、上傳圖片等複雜操作；複雜場景往往需要 Minium 或 AI 自定義測試，與 Skill 管理的用例類型需一致。
- 版本與座標：安裝時使用
@user_05b87ff0/minitest，當前 Skill 版本爲 1.0.0；升級可通過skillhub對同一座標更新，並仍指定正確的--dir。
結尾¶
「小程序雲測」Skill 把微信 MiniTest 雲測的提測、狀態查詢、計劃用例與質檢等操作收斂到 Agent 工作流裏，適合已接入雲測、又需要 API Key 驅動自動化的團隊。安裝與座標以 SkillHub 爲準：
- Skill 頁面：https://www.skillhub.cn/skills/user_05b87ff0/minitest
- API 入口：https://api.skillhub.cn/user_05b87ff0/minitest
- 微信雲測文檔：https://developers.weixin.qq.com/miniprogram/dev/devtools/minitest/
