Agent 设备移动调试 CLI
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/control-ios-and-android-devices-through-a-deterministic-cli-for-agent-driven-mobile-testing-and-debugging-with-agent-device。
技能介绍
被自动化卡住的真实设备
Agent 要测移动应用时,常见困境是:UI 自动化框架要么靠截图猜界面,步骤飘忽不稳;要么录屏回放,一碰动态内容就失效。agent-device 的思路是用确定性 CLI 把「看界面」和「操作界面」拆开:先检查 UI 状态,再基于稳定标识执行动作,而不是对着像素坐标盲点。
核心能力与关键步骤
- 会话感知:CLI 持有设备会话,同一会话内状态可追踪,Agent 不必每次重建上下文。
- UI 状态检查:解析当前界面结构,供 Agent 判断所在页面与可用元素。
- 确定性操作:动作基于解析出的界面信息而非随机坐标,失败可复现。
- 证据收集:调试过程中采集日志、网络跟踪与性能数据,形成可回溯的证据链。
典型流程:确认受支持的目标设备 → 建立会话 → 检查 UI → 执行操作 → 采集日志 / 网络 / 性能证据 → 结束会话。
适用边界与注意点
- 仅面向受支持的 iOS、Android、tvOS、macOS 或 AndroidTV 目标,且需预先具备
agent-deviceCLI。 - 技能基于源代码项目,资料中未提供自动提取的安装方式或使用说明,接入前需先阅读上游仓库。
- 在敏感工作流中运行前,应审查上游项目代码,确认行为符合预期。
使用场景
- 移动端测试工程师要用确定性步骤驱动 iOS 应用,复现并验证某个按钮触发的页面跳转。
- 自动化工程师需要让 Agent 检查 Android 界面状态,并在调试过程中采集日志和网络跟踪。
- 开发工程师想复现一个偶现崩溃,用 CLI 连续操作界面并记录性能数据作为排查证据。
- Agent 开发者需要接入 tvOS 或 macOS 目标,按可复现流程执行界面操作并核对结果。
适合人员
- 移动端 QA 工程师,需要稳定复现场景并验证修复,而不是依赖截图或随机坐标。
- 移动开发工程师,正在排查崩溃、卡顿或网络异常,需要日志、网络跟踪和性能证据。
- 自动化平台工程师,负责把确定性设备操作接入 Agent 工作流,并保证步骤可复现。
- Agent 应用开发者,希望用 CLI 驱动真实 iOS 或 Android 设备完成端到端验证。