autofish
为AI智能体提供稳定、可观测的Android自动化执行层
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:autofish。 它的用途是:为AI智能体提供稳定、可观测的Android自动化执行层 完整的 Skill 内容见:https://321skill.com/skills/autofish/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我测试一下购物App的下单流程是否正常。”,AI会通过Autofish启动目标App,观察首页,点击商品,加入购物车,进入结算页面,并验证每一步的页面跳转和元素状态是否正确,最后生成测试报告。或者
对AI说:“自动帮我完成这个App的每日签到任务。”,AI会通过Autofish定位并点击签到按钮,然后截图保存签到成功的证据。
介绍
Autofish 旨在解决AI智能体在控制Android设备时面临的挑战:屏幕状态不稳定、操作依赖易变的坐标、执行结果难以验证。它为智能体提供了一个可靠的中介层,将抽象的意图转化为具体、可验证的Android操作。
使用Autofish,首先需要在Android设备上安装其官方应用并开启服务,然后在电脑端通过npm安装其CLI工具af,并通过af config命令配置连接信息。之后,智能体便可以通过af observe、af act等命令来观察屏幕、执行点击/滑动/输入等操作,并在每一步后进行结果验证。
这个Skill非常适合需要与Android应用进行自动化交互的AI智能体开发者、自动化测试工程师以及希望构建复杂多智能体工作流的研发人员。它让智能体具备了“手”和“眼”,能够像人类一样与移动应用进行交互。
建议在使用时,遵循“观察-行动-验证”的循环,为每个任务使用固定的会话名称以保持记忆连贯性。注意,Android设备上的Autofish服务必须保持开启状态,且建议优先配置Shizuku以获得更稳定的执行能力。
核心特点
与同类Android自动化工具(如ADB命令、UI Automator)相比,Autofish的核心区别在于它专为AI智能体设计,提供了稳定的UI元素引用(refs)而非脆弱的屏幕坐标,并内置了每一步操作后的验证机制和本地执行记忆(SQLite),使智能体的决策和执行过程更加可靠和可观测。
注意事项
不适合需要直接操控硬件底层或绕过Android系统安全限制的场景。
常见问题
Autofish和ADB有什么区别?
ADB是底层的调试桥,Autofish是构建在ADB等工具之上的、为AI智能体设计的高层抽象,提供稳定的UI引用、自动验证和记忆功能,让智能体更可靠地控制App。
必须使用Shizuku吗?
不是必须,但推荐。Shizuku能提供更稳定高效的执行能力;如果没有Shizuku,开启无障碍服务(Accessibility Service)也可以作为备选方案。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/autofish/raw/index.md 读取 autofish 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/autofish/raw/index.md(查看排版版本)