Android 技能總覽

Android 技能是經過 AI 最佳化的指令，可協助 AI 工具和代理程式進一步瞭解並執行特定模式，遵循 Android 開發的最佳做法和指引。這些範例位於 Android 技能 GitHub 存放區。

你可以使用 Android 技能執行下列工作：

  • 從 XML 遷移至 Compose
  • 升級至 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，可搭配您選擇的任何代理使用。

gemini_cli_skills_demo.gif

Android CLI

建議使用 Android CLI 安裝 Android 技能，這樣就能更輕鬆地探索、下載及管理所選代理程式的技能。

Android Studio

您可以從 Android 技能 GitHub 存放區下載技能，然後匯入 Android Studio 專案。

啟用技能

代理程式會自動啟用與工作相關的技能。如要使用技能，請提示代理程式完成與技能相關的工作，例如「Make my app UI edge-to-edge」(讓我的應用程式 UI 無邊框)。如果技能可用，代理程式應會自動尋找並使用。

在 Android Studio 中，您也可以在聊天視窗中輸入 @skill-name，直接手動叫用技能。

建立自己的技能

您可以建立自己的技能，封裝及分享團隊的工作流程。 如要進一步瞭解技能需求，請參閱代理程式技能規格。

服務專員會從專案根目錄中的 .skills/ 或 .agent/skills/ 目錄開始尋找技能。如要建構自訂技能，請按照下列步驟操作：

  1. 建立技能目錄 (例如 my-new-skill/)。
  2. 在新的目錄中建立 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 個字元 (只能使用小寫英文字母、數字和連字號)。
  • 說明：最多 1,024 個字元。
  • 內文內容：建議 10,000 到 20,000 個字元 (約 2,500 到 5,000 個權杖)。如果說明超出此限制，請考慮將詳細說明移至資源檔案，如「選用技能目錄」一文所述。

選用技能目錄

如要讓 SKILL.md 檔案簡潔且模組化，您可以在技能資料夾內的下列選用目錄中加入其他資源：

  • scripts/：包含代理程式可執行的程式碼 (例如 Python 或 Bash)。
  • references/：包含詳細技術文件、API 參考資料或特定領域指南。
  • assets/：包含靜態資源，例如文件範本、UI 圖表或 JSON 結構定義。

在 SKILL.md 指令中參照這些檔案時，請使用技能根目錄的相對路徑。例如：Run the script at scripts/cleanup.py。

技能的運作方式

技能代表隨需專業知識。這種結構可讓代理程式維持大量專業功能，不會讓模型的即時脈絡視窗雜亂無章。

模型會根據您的要求和技能說明，自主決定何時要使用技能。模型識別出相關技能後，會動態提取完成工作所需的完整操作說明和資源。