前言¶

在安卓侧用 AIGame / AutoGOD 写自动化脚本时，常见问题是通用大模型会把 Android 原生写法、错误的 API 名或权限顺序混进回答里。$act、$screen、$ocr 等模块各有约定，悬浮窗、找图、异步释放也容易踩坑。单靠对话记忆很难稳定对齐官方方言。

下面介绍 SkillHub 上的 augtogod自动化助手（坐标 @user_2a67a6dc/autogod）。它把 AutoGOD 的编码规范、自检流程和分模块 API 参考打包成 Agent Skill，让助手在写脚本前先读规范、再按清单自检，并附带可复制的代码范式与项目示例。

这是什么¶

augtogod自动化助手 是社区来源（community）的 ai-agent 类 Skill，当前版本 1.0.5，发布者为 user_2a67a6dc（SkillHub 展示名：娟子是个米）。SkillHub 简介为：本工具为 autogod 自动化助手的可用辅助 skill。

包内 SKILL.md 的定位是 AutoGOD autogod 编码规范技能：在用户需要编写 autogod、AIGame / AutoGOD 脚本，或涉及 $act、$screen、$ocr、$http、$floaty、$file 等 API、安卓自动化、图色/OCR、UI 构建、网络与文件、多线程等任务时触发。标签 requires_api_key=false，安装后无需额外 API Key。

与仅依赖模型内置知识的写法相比，本 Skill 把权限链（ROOT > Shizuku > Accessibility）、必读规范文档路径和强制自检步骤写进技能说明，并挂载大量 references/ 下的 API、UI 与示例文档，供 Agent 按需读取。

核心功能¶

以下能力均来自已安装包内的 SKILL.md 及同级参考文件，经 SkillHub v1.0.5 包核对。

编码规范与执行流程¶

技能规定四步流程：

1. 读取 references/01～05 及补充 API 文档（JS 方言、XML 布局、代码片段、错误修正、强制自检清单）。
2. 生成代码前完成 05_autogod-mandatory-checklist.md 中的检查项，并在回复中声明已完成自检。
3. 按 01_autogod-js-api-standard.md 与 03_autogod-code-snippets.md 生成代码，要求异步使用 async/await 或回调，并处理异常与资源释放。
4. 对照 04_autogod-error-correction.md 做常见错误审查（API 拼写、参数类型、权限、泄漏、异步误用等）。

权限与手势优先级¶

所有 $act 相关手势遵循：ROOT > Shizuku > Accessibility。技能说明中要求先判断 ROOT（$root），否则 Shizuku（$szk），最后无障碍。

参考文档体系¶

• 规范：AutoGOD开发规范.md、references/01～06、踩坑记录等。
• API：references/api/ 下合并文档与分模块说明（含 $act、$ocr、$floaty、$ui 等）；技能内还列出 v2 模块文档命名方式。
• UI：references/ui/ 下布局、控件、示例与颜色/重力对照等。
• 示例与项目：references/examples/ 按主题分的代码示例；references/projects/ 含悬浮界面、光源音乐等项目示例源码说明。
• 模板：assets/quick_start_template.js 提供带配置区、权限申请与异常处理的标准启动模板。

技能内嵌常用模式¶

SKILL.md 提供可直接对照的片段，例如权限申请（$permit.wza()、$permit.floaty()）、找图点击（$ag.findImgClick / waitImgClick）、截屏 OCR（$screen.getScreen + $ocr.detect / $ocr.v）、找色（$color.find）、悬浮窗（$floaty.newApp）等。具体参数以包内文档为准。

v1.0.5 变更说明（SkillHub 页面数据）：修正 window 新建窗口的错误例子；包内另有 悬浮窗API错误修正.md 针对悬浮窗 API 的修正说明。

安装与启用¶

安装前请确认本机已有 skillhub CLI；若无，可按 SkillHub 官方安装说明安装（完整安装或仅 CLI）。

检查是否已安装：

command -v skillhub && skillhub --version

将技能安装到当前 Agent 的 skills 目录（必须带 --dir，否则默认落在 ./skills/ 可能不会被识别）。常用路径示例：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

安装 augtogod自动化助手 的命令（与 skillhub search 输出一致）：

skillhub install autogod --namespace user_2a67a6dc --dir ~/.cursor/skills/

将 ~/.cursor/skills/ 换成你实际使用的 skills 目录。SkillHub 页面亦支持通过自然语言提示 Agent：根据 https://skillhub.cn/install/skillhub.md 安装 @user_2a67a6dc/autogod。

安装完成后，按你所用客户端要求重启或刷新 Agent，使技能被加载。本 Skill 不要求 API Key。

典型用法¶

1. 用自然语言触发技能¶

在已启用该 Skill 的对话中，直接描述 AutoGOD 任务，例如：「用 $ag.waitImgClick 等开始按钮出现后点击」「写一个带 $floaty.newApp 的悬浮控制条」「main.xml 里用 linear 垂直排按钮」。技能说明中的触发条件会引导 Agent 先读规范再写代码。

2. 让 Agent 走强制自检¶

可明确要求：「按 autogod 技能里的 mandatory checklist 自检后再给代码」。技能要求 Agent 在生成代码前勾选 API、权限顺序、异步、资源释放、异常处理等项，并在回复中声明已完成自检。

3. 对照包内速查片段¶

需要权限与找图时，可让 Agent「按 SKILL.md 常用模式速查里的权限申请和找图点击写法」。示例结构（摘自技能内文档，路径与参数需按你设备与素材调整）：

$permit.wza();

let point = $ag.findImgClick({
    path: "/sdcard/close.png",
    region: [0, 0, 500, 500],
    similar: 0.85
});

4. 从快速启动模板起步¶

可说明：「基于技能里的 assets/quick_start_template.js 改 CONFIG 和 main()」。模板内含应用包名、超时、OCR 引擎等配置区及标准初始化流程说明。

5. 与 UI 速查技能配合¶

SkillHub 上同发布者另有 augtogod自动化UI（@user_2a67a6dc/autogod-ui），简介写明依赖 autogod 技能，侧重 AIGame/AutoGOD UI 速查。界面布局与控件细节可单独安装该技能，与本助手分工配合。

适用场景与注意¶

适合谁

• 使用 AIGame / AutoGOD 在安卓上做自动化、带 UI 的小工具或游戏辅助脚本的开发者。
• 希望 Agent 生成代码时对齐 官方 JS/XML 方言，而不是 Android Studio 或 Auto.js 习惯写法的人。
• 需要 OCR、找图找色、悬浮窗、HTTP、多线程等模块时，希望 Agent 能引用分模块文档而非臆造 API 的场景。

限制与注意

• SkillHub 分类为 ai-agent，子类包含任务自动化、工作流编排；本质是给 Agent 的规范与文档包，不能替代真机上的 AutoGOD 运行环境与权限配置。
• AutoGOD开发规范.md 明确警告：AutoGOD 不是 Android 开发，不要使用 Android XML 格式；布局须按技能中的 AutoGOD XML 规范（如根节点 <ui>、<linear> 等）。
• 参考文档体积大，Agent 是否读完某一份文件取决于上下文与指令；复杂任务应点名要对照的 reference 文件名。
• 社区来源、作者未在 SkillHub 标记为官方认证（isAuthorVerified: false）；生产脚本仍须在设备上自行验证。腾讯安全扫描在 SkillHub 页面展示为 benign，不构成对你业务逻辑的担保。
• SkillHub 统计（页面数据）：下载约 1227 次，安装记录 1；版本 1.0.5，共 6 个历史版本。

结尾¶

augtogod自动化助手 把 AutoGOD 的权限链、四步编码流程、API/UI 参考与示例项目集中到一个 Skill 里，适合作为写 autogod 脚本时的 Agent 侧规范助手。安装与详情见 SkillHub：

• 技能页：https://www.skillhub.cn/skills/user_2a67a6dc/autogod
• 坐标：@user_2a67a6dc/autogod
• 官方地址：https://api.skillhub.cn/user_2a67a6dc/autogod