前言¶
小程序聯調往往離不開微信開發者工具：改一頁、點幾步、看數據、截一張圖，再重複下一輪。手工點模擬器適合單次排查，一旦要做冒煙檢查、迴歸某條頁面路徑，或讓編程 Agent 按固定步驟跑通流程，就需要能在終端裏啓動/連接 DevTools、操作頁面、取數、mock wx、截圖的一套約定。
下面介紹 SkillHub 社區 Skill「微信開發者工具自動化 skill」。它面向 harness engineering 場景，把 miniprogram-automator 相關能力整理成 Agent 可遵循的 SKILL 說明，便於在 Cursor、Claude Code 等環境裏重複執行上述流程。
這是什麼¶
一句話定位：指導 AI Agent 通過 miniprogram-automator 從終端自動化微信開發者工具中的小程序調試流程。
- 座標：
@user_aa41fce0/wechat-miniprogram-automator - 版本：1.0.0（SkillHub 頁面標註）
- 來源：community，發佈者
user_aa41fce0 - 分類：dev-programming
- 標籤：
requires_api_key=false（安裝使用該 Skill 不要求配置 API Key）
官方簡介說明：在需要可重複的小程序流程時使用，例如啓動或連接 DevTools、重新打開路由、按選擇器點擊、填寫輸入、採集頁面數據、mock wx 方法，或在調試與冒煙檢查中截圖。
SkillHub 統計（以 SkillHub API 抓取爲準）：評分 100000，下載 5893，安裝 191。
核心功能¶
以下能力均來自 Skill 官方簡介，對 Agent 側「該做什麼」的歸納：
- 啓動與連接 DevTools：從終端拉起開發者工具，或連接到已運行的實例。
- 頁面與路由：重新打開指定頁面路徑，便於固定迴歸路徑。
- UI 操作：按選擇器點擊、填寫輸入框，模擬用戶在模擬器中的操作。
- 數據與 mock：採集頁面數據；在調試中 mock
wx相關方法。 - 截圖：在調試或冒煙檢查中保存界面截圖。
底層依賴微信側提供的 miniprogram-automator（小程序自動化 JS SDK）。本 Skill 的價值在於把上述場景寫成 Agent 可執行的說明，而不是替代微信官方 SDK 文檔。
安裝與啓用¶
通過 SkillHub CLI 安裝¶
先確認本機已安裝 skillhub（安裝方式見 SkillHub 安裝說明）。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能無法加載。
command -v skillhub && skillhub --version
skillhub install user_aa41fce0/wechat-miniprogram-automator --dir <skills 目錄>
常用 Agent 的 skills 目錄（摘自 SkillHub 安裝文檔）：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按你所用 Agent 的慣例重啓或刷新 Skill 加載；SkillHub 頁面未單獨寫明 Cursor 與 Claude Code 的差異，以上路徑以安裝文檔爲準。
通過提示詞讓 AI 安裝¶
SkillHub 頁面提供的安裝提示如下，可將原文發給 Agent：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_aa41fce0/wechat-miniprogram-automator`。
典型用法¶
Skill 包內 SKILL.md 在 SkillHub 站點未直接公開瀏覽；結合官方簡介，典型使用方式可以概括爲下面幾步。
- 在 Agent 中安裝並啓用
@user_aa41fce0/wechat-miniprogram-automator。 - 在對話中說明目標：例如「連接當前 DevTools」「從某路徑 reLaunch」「點擊某 class 的選擇器」「填表並讀頁面數據」「mock 某個 wx 接口」「跑完流程後截圖」。
- Agent 按 Skill 中的約定，編寫或調整基於
miniprogram-automator的終端腳本，執行啓動/連接、頁面操作與斷言。
運行 miniprogram-automator 時，微信開發者工具需在安全設置中開啓 CLI / HTTP 調用，否則 SDK 無法正常驅動工具自動化。具體 Node 版本、基礎庫與開發者工具版本要求以微信開放文檔「快速入門」爲準；本 Skill 頁面未重複列出這些環境項。
SDK 側最小示例如下（來源：微信開放文檔快速入門，與 Skill 簡介中的 miniprogram-automator 一致，便於本地先驗證環境再交給 Agent）：
npm i miniprogram-automator --save-dev
const automator = require('miniprogram-automator')
automator.launch({
cliPath: 'path/to/cli',
projectPath: 'path/to/project',
}).then(async miniProgram => {
const page = await miniProgram.reLaunch('/page/component/index')
await page.waitFor(500)
const element = await page.$('.kind-list-item-hd')
console.log(await element.attribute('class'))
await element.tap()
await miniProgram.close()
})
已打開自動化端口的 DevTools，可用 automator.connect({ wsEndpoint: 'ws://localhost:9420' }) 等方式連接；端口與 CLI 參數見Automator 模塊文檔。
適用場景與注意¶
適合誰
- 小程序開發者，希望把「打開工具 → 進頁面 → 點按/填表 → 取數/截圖」做成可重複腳本或交給 Agent 編排。
- 做 harness / 工程化的人，需要在 CI 或本地冒煙裏跑固定小程序路徑（在 DevTools 與
miniprogram-automator能力範圍內）。
限制與注意
- 本 Skill 爲社區發佈（
community），維護方是 SkillHub 用戶user_aa41fce0，與微信官方「開發者工具 Skills」（wechatide等）是不同產品線；不要混用安裝方式與命令。 - 自動化依賴本機已安裝微信開發者工具、項目路徑正確，且安全設置允許 CLI/HTTP 調用。
- Skill 不聲明需要 API Key；仍須遵守微信賬號、項目 AppID 與工具登錄等既有約束。
- SkillHub 頁面未提供該 Skill 的詳細 SKILL.md 在線預覽，複雜流程應以安裝到本地的 Skill 內容爲準。
結尾¶
「微信開發者工具自動化 skill」把 miniprogram-automator 驅動的 DevTools 操作收斂成 Agent 可執行的說明，適合需要可重複小程序調試與冒煙的場景。安裝與座標以 SkillHub 爲準。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_aa41fce0/wechat-miniprogram-automator
- API 條目：https://api.skillhub.cn/user_aa41fce0/wechat-miniprogram-automator
