pierridotite/mobile-agent-testers
开发工具在 GitHub Actions 上并行运行多个 Claude Code 测试代理,分别操作 iOS 模拟器和 Android 模拟器探索移动应用并产出带截图的缺陷报告。
这是一个 Agent 技能包 · 2 个技能看技能清单和安装方法 →项目介绍
mobile-agent-testers 把移动端 QA 变成并行的探索任务。每个测试员都是一个 Claude Code 代理,在 GitHub Actions 上独占一台 iOS 模拟器或 Android 模拟器,扮演指定人设:瑞典语界面、最大字号的 iPhone SE 用户,200% 字体的 Pixel 7,德语 iPad 等等。代理像新用户一样使用应用,最后写出带编号截图的缺陷报告。
除默认的自由探索外,还可以用 brief 让所有代理完整走通某个功能、在每台设备上复现同一份缺陷报告,或生成按区域和影响排序的改进建议。对比模式会让同一批人设分别跑两个构建,便于发版前比对。开箱支持的框架包括 Flutter、React Native/Expo、原生 Kotlin/Java、Swift/Objective-C、Kotlin Multiplatform、Capacitor/Ionic 和 .NET MAUI(beta);代理靠截图和无障碍树读屏,其他 UI 工具包可以通过自定义构建参数接入。
快速使用
需要 gh CLI 以及 Claude 订阅或 API Key,不需要 Mac。先从模板创建仓库,运行初始化脚本生成密钥对、写入 secrets,再触发演示流程:
gh repo create my-testers --public --template pierridotite/mobile-agent-testers --clone
cd my-testers && ./setup.sh # Windows 用 .\setup.ps1
gh workflow run agent-testers.yml # 2 个 Android + 2 个 iOS 测试员,约 20 分钟
bash scripts/collect.sh <run id> # 解密报告并归并到 runs/<id>/SUMMARY.md
测试自己的应用时,用源仓库、应用 ID 和 personas.json 里的人设 id 触发工作流:
gh workflow run agent-testers.yml -f source_repo=you/app -f app_id=com.you.app \
-f android_personas=anna,malik -f ios_personas=clara,jonas
其余输入项覆盖应用目录、brief(默认探索、改进报告或自写功能脚本)、待复现的缺陷、模型与提供商、强制指定框架、自定义构建命令或预编译应用路径、屏蔽的分析域名,以及每台手机的录屏。报告只在你的机器上解密。
使用约束
结果不可复现:两次运行路径不同,得到的是同类缺陷而非同一份列表。回归测试仍应交给 Maestro、Appium 这类脚本化套件。每个代理探索约 1 到 18 分钟,覆盖主要路径而非大型应用的所有角落,且可能读错屏幕——LocalSend 那一轮里 20 个代理中有 3 个把模拟器键盘当成了应用界面,提交前要看截图确认。
公开仓库可用免费 GitHub Runner,大约 20 个任务并发,但 macOS 只有 5 个,iOS 任务消耗 macOS 分钟数。有 5 小时用量上限的套餐可被 20 个代理在约 15 分钟内耗尽,建议每批 6–10 个。托管 Runner 面向仓库自身项目,闭源应用应在私有仓库或自己的 Mac 上运行工作流。公开仓库的日志是公开的,因此报告、截图和录像用你的密钥加密,手机内也会屏蔽分析域名,但仍应使用测试账号。已公布的运行记录中模型费用约为每个代理 0.15–0.55 美元。项目采用 MIT 许可证。
HotRepo 点评
该项目在 2026-11-22 进入 HotRepo 新项目榜,记录窗口内一小时内新增 36 Star,累计达到 140 Star、12 Fork。这次单点快照只能说明上线当天出现过一波早期增长,尚无全语言日榜名次记录,因此还看不出持续趋势。技术上更值得注意的是它的分布式会话设计:工作流先构建一次应用,再为每个人设分发一套模拟器加代理,报告加密后回收到用户机器上归并。这比 agent-device 那种一个代理接一台模拟器的做法更进一步,也针对脚本化 UI 测试留下的空白。项目自己写明的不可复现、探索时长有限和偶发读屏错误,正是判断它适合放进发版前检查清单、而不是替代回归套件的依据。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- callstack/agent-device面向 AI 编程 Agent 的设备控制层,提供 CLI、MCP 服务和 Node.js API,用于在模拟器、真机及云设备上检查、操作和验证移动端、电视、Web 与桌面应用。
- jo-duchan/tapflow自托管的中继加 macOS 代理,把 iOS 模拟器和 Android 模拟器串流到浏览器,供团队做移动端测试。
- mobile-next/mobile-mcp让 AI 代理通过统一接口操作 iOS 与 Android 模拟器、仿真器和真机应用的 MCP 服务器。
- hridaya423/phonedriver让 AI 代理通过 MCP 和命令行读取并操控 Android 手机与 iPhone 屏幕,付款类操作前先向人确认。
- erkamyaman/unslopovich一个代理技能:审查移动端和网页界面的 AI 感、UX 与可访问性问题,并给出修复方案。