前言¶
在安卓側用 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 包覈對。
編碼規範與執行流程¶
技能規定四步流程：
- 讀取
references/01～05及補充 API 文檔（JS 方言、XML 佈局、代碼片段、錯誤修正、強制自檢清單）。 - 生成代碼前完成
05_autogod-mandatory-checklist.md中的檢查項，並在回覆中聲明已完成自檢。 - 按
01_autogod-js-api-standard.md與03_autogod-code-snippets.md生成代碼，要求異步使用async/await或回調，並處理異常與資源釋放。 - 對照
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
