Android ADB Control

让 Agent 通过 ADB 操控安卓手机：观察界面、执行一步、验证结果，再决定下一步。

An instruction-only Agent Skill for Android phone control via ADB.

作者：范凯 and Agent（Friday） · MIT License

• 打开 App、查找页面、点击、滑动、长按和输入文字。
• 查看授权范围内的界面信息、处理有限列表、复现测试操作。
• 准备消息草稿；明确授权后执行指定发送动作。

这是给已有 Agent 加载的技能，不是独立程序、MCP Server 或后台服务。基础操作只需 ADB 和已授权设备；自绘界面需要截图工具与视觉模型，中文输入可选 ADBKeyboard。

不用于绕过锁屏、验证码、支付验证或企业策略，也不提供无人值守监控、自动交易或无限重试。

这里指技能格式与加载方式兼容，不代表已在四个宿主上完成真机验收。Agent 必须能执行本机 ADB；需要视觉时，还必须能把截图交给模型。云端会话或远程容器不会自动获得本地 USB 设备。

以下为 macOS / Linux 的 Bash 示例；Windows 请使用官方 Platform-Tools 并适配路径、引号和截图输出。

先检查，避免重复安装：

command -v adb
adb version

缺失时安装 Android SDK Platform-Tools。macOS 可使用：

brew install --cask android-platform-tools

先审阅本仓库。Pi、Codex、OpenCode 可共用一份：

mkdir -p "$HOME/.agents/skills"
git clone https://github.com/robbin/android-adb-control.git \
  "$HOME/.agents/skills/android-adb-control"

只用 Claude Code 时，将目标目录改为 ~/.claude/skills/android-adb-control。若已装共享版本，可给 Claude Code 建兼容链接：

mkdir -p "$HOME/.claude/skills"
ln -s "$HOME/.agents/skills/android-adb-control" \
  "$HOME/.claude/skills/android-adb-control"

目标已存在时先检查，不要覆盖。OpenCode 也会扫描 .claude/skills，兼容链接可能引起同名告警；确认最终加载路径，不要再安装第二份副本。

只想在项目内使用时，安装到项目的 .agents/skills/android-adb-control/；Claude Code 使用 .claude/skills/android-adb-control/。不要无意重复安装用户级和项目级技能。父项目已有 Git 时，按团队规范处理嵌套仓库或子模块。

安装后，Pi 执行 /reload；其他宿主若未发现技能，检查技能权限并重开会话。OpenCode 的技能不一定注册为同名斜杠命令。

在自己的手机上开启开发者选项和 USB 调试，用数据线连接，手动解锁并确认电脑的 RSA 授权，然后运行：

adb devices -l

设备应显示为 device。多个设备时明确指定目标；遇到 unauthorized、offline 或 Linux no permissions，先解决连接问题。

无线调试是可选项，见连接与故障处理。不要将 ADB 端口暴露到公网。

从低风险任务开始，按上表使用对应宿主的调用方式，例如 Pi：

/skill:android-adb-control 打开系统设置首页，确认页面，不修改设置。

也可以用自然语言请求加载技能，再描述目标和边界：

使用 android-adb-control，在指定测试联系人会话里输入“我稍后回复”，
停在发送前。不要点击发送，也不要按可能触发发送的回车。

查看这个测试列表的前 20 个项目，只记录名称和可见编号。
同名项目不要直接合并；到 20 个或预算用完就停止。

默认最多 30 个设备状态变更动作、5 分钟，并为恢复操作预留预算。长任务提前约定有限预算和检查点。发送状态不明时不会自动重发。

• 只操作获授权的设备、Android 用户和 App。发送、购买、删除、安装、导出个人资料及修改安全/网络设置需要明确授权。
• 截图和 UI XML 可能含私人内容，交给云端模型前应确认数据与日志策略；不要提交到本仓库或公开 Issue。
• ADBKeyboard 的部分实现允许其他本地应用发送控制广播。优先用于可信测试设备，不用于凭据输入；使用前说明风险，结束后恢复本次改变的输入法状态。
• 默认不改休眠时间、不切换 VPN、不安装辅助 App。无法验证或恢复时停止并报告。
• 技能规则不是技术沙箱，仍需宿主权限控制与人工监督。

本版本已做文档审查和静态检查，尚未完成修订版真机端到端验收。不同 ROM、App、输入法版本和视觉链路仍需测试。

• SKILL.md：Agent 执行入口。
• ADB 命令参考：设备／用户选择、输入、捕获和恢复。
• 故障处理：USB、OEM、无线连接与 VPN。
• DroidClaw 蒸馏笔记：脱敏后的设计背景与历史经验。
• 验证清单：检查方法和真机验收步骤。

静态检查不连接手机，需要 Bash、Git 和 uv：

uv run --no-project python scripts/check_docs.py

更新前检查安装目录的本地修改，确认可接受上游变更后再运行 git pull --ff-only，然后刷新 Agent 会话。

方法受到 DroidClaw 启发，本项目不是其官方产品或运行时，也不分发第三方 APK。

参考：ADB · ADBKeyboard · Agent Skills · Pi · Codex · Claude Code · OpenCode

本仓库采用 MIT License，作者为范凯 and Agent（Friday）。第三方项目遵循各自许可证。