agent-device
让AI代理自动化测试和控制多平台应用，实时验证代码变更效果。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-device。 它的用途是：让AI代理自动化测试和控制多平台应用，实时验证代码变更效果。 完整的 Skill 内容见：https://321skill.com/skills/agent-device/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我测试这个React Native应用的新登录流程，用iOS模拟器打开，输入测试账号，点击登录，并检查是否跳转到首页。” 它会通过agent-device启动会话，自动执行点击、输入、断言等操作，并返回每一步的界面快照和最终结果截图，让你清晰看到测试全过程。
介绍
agent-device 解决了AI编码代理在修改代码后，无法直接验证应用在真实设备（如手机、电视、桌面）上运行效果的问题。它提供了一个命令行工具，允许代理通过读取应用的无障碍快照、查找UI元素、执行点击、输入等操作，并与应用进行实时交互，从而形成一个“检查-操作-验证”的闭环。
使用方式非常直接：开发者或AI代理通过命令行启动一个与目标设备（如iOS模拟器、Android设备、Web浏览器）的会话，然后发送一系列指令（如 agent-device snapshot 查看界面，agent-device press @e2 点击按钮）来驱动应用，并观察指令执行后的界面变化。整个过程支持截图、录屏作为证据留存。
它非常适合需要自动化测试、UI验证或让AI辅助完成复杂应用交互流程的开发者，特别是前端开发、测试工程师和智能体开发者。他们可以利用这个工具，让AI代理像真实用户一样操作应用，验证功能是否按预期工作。
建议在使用前先运行 agent-device doctor 检查环境配置。注意，元素的引用标识（如@e2）仅在最近一次命令输出中有效，界面变化后需要重新获取。对于无障碍信息不佳的应用，可多依赖截图和视频进行验证。
核心特点
与同类浏览器自动化工具（如Playwright）主要面向脚本化测试不同，agent-device专为AI代理设计，提供token高效的无障碍快照和简洁的命令行交互，便于AI理解和决策；同时，它原生支持iOS、Android、TVOS、Web等多平台应用的统一控制，而不仅限于浏览器。
注意事项
对于完全依赖图像识别进行交互或无障碍信息极其匮乏的古老应用，自动化效果可能不佳。
常见问题
agent-device 和 agent-browser 是什么关系？
agent-device 受 Vercel 的 agent-browser 启发，并扩展了其“检查-操作-验证”流程到移动端和电视端。对于 Web 平台，它实际上会调用 agent-browser 来执行。
支持哪些设备和平台？
支持 iOS, Android, tvOS, Android TV, 亚马逊 Vega OS TV（通过VVD虚拟机），Web，macOS 和 Linux 平台上的应用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-device/raw/index.md 读取 agent-device 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-device/raw/index.md（查看排版版本）