Android 技能是經過 AI 最佳化的指令,可協助 AI 工具和代理更準確地理解及執行特定模式,並遵循 Android 開發人員的最佳做法和指南。這些範例位於 Android 技能 GitHub 存放區。
您可以使用 Android 技能執行下列工作:
- 從 XML 遷移至 Compose
- 讓應用程式 UI 能夠配合手機、摺疊式裝置、平板電腦、Googlebook 和 ChromeOS 裝置調整
- 升級至 AGP 9
- 設定 Navigation 3 等較新的架構
- 採用無邊框設計,翻新應用程式 UI
- 稽核 R8 設定,提升成效
使用 Android 技能,可協助 LLM 掌握最新知識,以及 Android 專業工作流程的背景資訊。
Android 技能遵循代理技能開放標準,因此與任何支援技能的 AI 工具相容。本頁面說明如何在 Android Studio 中使用技能,以及如何使用 Android CLI 安裝技能,以便與您選擇的任何代理和工具搭配使用。
Android 技能的主要優點
Android 技能提供多項主要優勢,可加快代理工作流程,更有效率地產生高品質的 Android 程式碼:
- 以專業知識為基礎:為 代理提供更多 Android 專屬情境,視需求建立基礎,並在一般模型訓練週期外,擴充預設知識和 專業技能。
- 可重複的工作流程:提供標準指令,確保 Android 開發人員作業中的多步驟任務能一致執行。
- 資源整合:將指令碼、範本或額外說明文件與主要 SKILL.md 指令一併提供,讓代理集中取得所需的一切,不必手動附加提示檔案。
- 分享專業知識:將團隊的 Android 開發人員模式封裝到共用資料夾,以便統一存取及協作。
使用 Android 技能
Android 技能已整合至 Android CLI,可與您選擇的任何代理搭配使用。

Android CLI
建議您使用 Android CLI 安裝 Android 技能,以便輕鬆探索、下載及管理任何代理的技能。
- 如要查看可用技能清單,請執行
android skills list。 - 如要安裝技能,請執行
android skills add skill-name。如果已安裝技能,skills add會將技能更新至最新版本。
Android Studio
您可以從 Android 技能 GitHub 存放區下載技能,並將其匯入 Android Studio 中的專案。
啟用技能
代理會自動啟用與任務相關的技能。如要使用技能,請提示代理完成與技能相關的工作,例如「將應用程式 UI 設為無邊框」。代理應會自動尋找並使用可用的技能。
在 Android Studio 中,您也可以直接在對話視窗中輸入 @skill-name,手動叫用技能。
建立自己的技能
你可以建立自己的技能,打包並分享團隊的工作流程。 如要進一步瞭解技能需求,請參閱代理技能規格。
代理程式會從專案根目錄中的 .skills/ 或 .agent/skills/ 目錄開始尋找技能。如要建構自訂技能,請按照下列步驟操作:
- 為技能建立目錄 (例如
my-new-skill/)。 - 在新目錄中建立
SKILL.md檔案 (區分大小寫)。
技能必須遵循下列規則:
- 每個技能一個目錄:每個技能都必須有專屬目錄,其中包含
SKILL.md檔案和任何其他資源。 - 巢狀結構:所有技能都必須位於專案根目錄的
.skills/或.agent/skills/目錄中。不過,您可以使用子目錄來改善組織結構 (例如skills/ui-flows/<skill name>/SKILL.md或skills/testing/<skill name>/SKILL.md)。 - 範圍:僅支援專案程式碼集內的技能。
SKILL.md 檔案使用 YAML 區塊做為中繼資料,並使用標準 Markdown 做為操作說明。
name:技能的專屬 ID。這應與目錄名稱相符。description:清楚說明技能的作用,以及代理應使用的時機。- 主體:YAML 區塊下方的 Markdown 主體包含指令,用於在技能啟用時引導代理的行為。
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
author: example-org
version: "1.0"
---
Skill content
格式規範
- 名稱:最多 64 個字元 (僅限小寫英文字母、數字和連字號)。
- 說明:最多 1024 個半形字元。
- 內文:建議長度為 1 萬到 2 萬個字元 (約 2,500 到 5,000 個詞元)。如果操作說明超過這個長度,建議您按照「選用技能目錄」一節所述,將詳細說明文件移至資源檔案。
選用技能目錄
如要讓 SKILL.md 檔案保持簡潔和模組化,您可以在動作資料夾中的下列選用目錄中加入其他資源:
scripts/:包含代理可執行的程式碼 (例如 Python 或 Bash)。references/:包含詳細的技術說明文件、API 參考資料或特定領域指南。assets/:包含靜態資源,例如文件範本、UI 圖表或 JSON 結構定義。
在 SKILL.md 指令中參照這些檔案時,請使用技能根目錄的相對路徑。例如:Run the script at scripts/cleanup.py。
技能運作方式
技能代表隨選專業知識。這種結構可讓代理維持大量專業能力,同時避免模型的即時脈絡窗口雜亂無章。
模型會根據您的要求和技能說明,自主決定何時使用技能。識別出相關技能後,模型會動態擷取完成工作所需的完整指令和資源。