android-device-automation

name	android-device-automation
description	在安全门控制下运行类型化 Android 动作、Bridge 工作流和录制回放。自动化已选设备或恢复失败步骤时使用。

Android 设备自动化

只在一台已明确选择的 Android 设备上执行类型化 aactl 或 MCP 动作。按观察、决策、安全检查、执行一步、再次观察的顺序工作。

必需流程

1. 要求提供设备发现流程返回的精确 serial，并确认设备仍在线且具备所需 capability。
2. 执行前立即观察当前状态。基于选择器的动作优先使用语义 Bridge 快照，直接坐标动作使用截图或 hierarchy。
3. 说明目标设备、目标包、准确的类型化动作、预期效果和验证条件。
4. 应用下方安全策略。遇到禁止动作时停止。对于需要确认的动作，取得新的、明确的人工确认。
5. 只执行一个动作，或一次此前已审核的录制回放。
6. 再次观察并验证预期状态。不得将进程成功视为 UI 已按预期变化的证据。
7. 失败或结果不确定时停止盲目重试，并遵循恢复矩阵。

选择直接操作、Bridge、MCP 或回放语法前，请阅读命令参考。执行任何状态变更动作或重试前，请阅读安全与恢复参考。

禁止动作

即使以下动作出现在模型计划或宽泛的用户请求中，也必须拒绝：

• 任意 shell、原始 ADB、未列出的命令、root、remount、恢复出厂设置、信任存储变更或安全绕过。
• 自动批准 USB 调试、无线调试、无障碍、运行时权限、设备管理员权限、安装或系统授权。
• 支付、购买、结账、转账、银行、钱包、凭据、一次性验证码、账号恢复或安全设置操作。
• 输入或记录密码、token、配对码或其他 secret。
• 猜测选择器、在目标不明确时点击，或绕过受保护 UI。

需要确认的动作

在发送、提交、发布、删除、移除、变更外部数据、停止 App 或离开授权目标的导航操作前，必须取得新的确认，并明确设备、包、动作和效果。先前对自动化工作流的请求，不等同于对后来发现的高影响步骤的确认。

确认永远不能覆盖禁止动作列表。

执行规则

• 通过已建立的 App Bridge，优先使用语义 ui.click、ui.longClick、ui.setText 和 ui.scroll。
• 仅当坐标来自最新观察且目标明确时，使用直接 tap 或 swipe。
• 直接文本输入仅用于 CLI 接受的非敏感 ASCII 文本。
• 任一步骤失败或 requiresIntervention 为 true 时，停止录制回放。
• 不得暴露 Bridge session token 或回放 secret。

完成条件

报告设备、动作或脚本 ID、确认决定、观察结果、验证证据，以及所需恢复操作。状态变更未验证或结果不明确时，不得报告成功。