小程序云测:在 AI Agent 里对接微信 MiniTest 云测

前言

小程序真机自动化测试往往要登录 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 何时、如何对接外部服务。

  1. 测试任务:提交测试任务、查询任务状态(与云测 HTTPS 提测、任务通知等能力一致,见官方「支持持续集成」说明)。
  2. 测试资产:管理测试计划、测试用例(对应云测侧的用例与计划能力;自动化形态包括智能化 Monkey、录制回放、自定义测试 Minium、AI 自定义测试等,见官方文档「丰富的自动化测试能力」)。
  3. 质量检测:处理质量检测(质检)任务;官方文档描述云测可将自动化测试与启动性能等结合,从启动性能、运行时性能、兼容性、网络性能等方面输出质检报告。
  4. 性能与真机:云测服务支持启动性能专项、真机体验评分、资源占用分析等(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 简介一致):

  1. 提交一轮小程序云测任务(如指定开发版/体验版/线上版,以云测支持的版本为准)。
  2. 根据任务 ID 或名称查询任务状态,并在结束后查看报告链接或通知配置(云测支持邮箱、手机号任务结束通知,见官方文档)。
  3. 创建或调整测试计划、关联测试用例(含录制回放、Minium 自定义测试、AI 自定义测试等类型,以你在云测项目中已配置的能力为准)。
  4. 发起或跟进小程序质量检测任务,获取质检报告中的启动、运行时、兼容性、网络等维度结果。

若需接口级参数与示例,以微信开放文档 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/
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye