前言¶
小程序真机自动化测试往往要登录 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/
