前言¶
小程序联调往往离不开微信开发者工具：改一页、点几步、看数据、截一张图，再重复下一轮。手工点模拟器适合单次排查，一旦要做冒烟检查、回归某条页面路径，或让编程 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
