android-design-guidelines

android-design-guidelines 技能總覽

這個技能能做什麼

android-design-guidelines 技能是一套實用的 Android UI 決策輔助工具，適用於 Material Design 3、Jetpack Compose 與以 XML 為基礎的版面。它能幫你把模糊的 UI 任務，轉成符合平台慣例的實作選擇，涵蓋主題設定、導覽、無障礙、適應式版面與核心元件。

誰適合使用

如果你正在開發或審查 Android 畫面、準備往 Material You 遷移，或想避免破壞一致性與無障礙性的 Android 平台錯誤，就適合使用 android-design-guidelines 技能。對於需要的是 android-design-guidelines for UI Design 這類具體指引，而不是抽象設計理論的產品團隊，尤其有幫助。

它最擅長的情境

當你需要的是 Android UI 應該如何運作的具體指引時，這個技能最有用：例如動態色彩、色彩角色、predictive back、觸控目標尺寸、字型縮放，以及回應式版面模式。和通用提示詞相比，當你需要能兼顧 Compose 與 XML 的、理解實作脈絡的指引時，它會是更合適的選擇。

如何使用 android-design-guidelines 技能

安裝後先找到規則地圖

先執行你的技能管理器所使用的 android-design-guidelines install 指令，接著打開 skills/android 底下的儲存庫內容。先從 SKILL.md 看起，再閱讀 AGENTS.md、metadata.json 和 rules/_sections.md，先理解規則結構，再針對特定畫面或功能提出問題。

提供真實的 Android 任務

這個技能在你提供畫面類型、API level、UI toolkit 與限制條件時，效果最好。比如可以要求：針對 Android 12+ 的 Compose 主題、平板 App 的導覽模式，或自訂元件的無障礙審查。像「改善這個 UI」這類模糊提示，效果通常不如有明確重點的 android-design-guidelines usage 請求，例如：「請檢查這個 Compose 設定畫面是否符合 Material 3、dynamic color，以及 TalkBack 的要求。」

先讀對的檔案

先用 rules/_sections.md 跳到相關分類，再查看 SKILL.md 裡對應的規則群組，以及 AGENTS.md 中的註記。如果你在處理主題設定、導覽或無障礙，那些章節通常就決定了輸出能不能直接用。這個儲存庫的支援檔不多，所以真正有價值的是規則正文和章節索引，而不是龐大的參考樹。

提示條件，不要只丟設計想法

高品質輸入應該明確提到平台版本、版面型態與實作方式。更好的提示會像這樣：「為 Android 14 的相片 App 設計一個 Material 3 Compose 畫面，支援 dynamic color、bottom navigation、大字體，且不要使用自訂品牌色。」這能讓 android-design-guidelines 技能掌握足夠脈絡，回傳符合 Android 慣例、也避免隱性衝突的選項。

android-design-guidelines 技能 FAQ

這只適合設計工作嗎？

不是。android-design-guidelines 技能是用於會影響實作的設計決策。當你需要開發者可以直接套用到 Compose 或 XML 的指引時，它特別有用，尤其適合生產環境 App 中的 android-design-guidelines usage。

我應該用它，還是直接寫一般提示詞？

當你希望減少 Android 專屬錯誤、並得到更一致的平台行為時，就該用這個技能。一般提示詞可以提供 UI 想法，但常常會漏掉 dynamic color fallback、最小觸控目標或導覽慣例這些要求。

對初學者友善嗎？

如果你正在處理的是具體畫面或元件，那麼答案是肯定的。這個技能最好用的情況，是你已經知道任務內容，例如「做一個設定頁」或「修這個無障礙問題」。如果你完全沒有 Android 脈絡，它的幫助就會比較有限。

什麼時候不該用？

如果不是 Android 的設計系統、行銷網站版面，或 iOS 專屬互動模式，就不要依賴它。若你要的是產品策略，或不受平台限制的視覺品牌探索，它也不是對的工具。

如何改善 android-design-guidelines 技能

先從風險最高的規則區域下手

品質提升最明顯的地方，通常是主題設定、導覽與無障礙。使用 android-design-guidelines guide 時，請明確說明你是否需要 Material You、predictive back、平板適配，或螢幕閱讀器支援，這樣技能才能優先處理最影響正確性的規則。

提供規則所依賴的畫面背景

如果你把 Compose 或 XML、目標 API level、手機或平板、深色模式需求，以及畫面是否使用自繪或標準 Material 元件都交代清楚，技能通常會給出更好的結果。這些背景能幫它避開泛泛而談的建議，改用正確的 Android 模式來回答。

先要求審查，再迭代修正

一個不錯的流程是：先請它給初步實作計畫，完成後再請它做第二輪檢查，找出像是硬編碼顏色、不正確的文字尺寸、焦點順序不佳或導覽位置錯誤這類問題。這時 android-design-guidelines skill 的輸出最有價值，因為它能抓出第一版草稿裡很容易忽略的結構性問題。

用具體輸入換具體修正

不要只說「讓它更無障礙」，而是直接指出失敗模式，例如：「這個 Compose 卡片只有圖示按鈕、觸控目標是 36dp，而且有自訂 canvas 繪製；請說明要怎麼改才符合 Material 3。」越具體，回答就越準，因為技能可以直接把你的問題對應到實際規則，而不是猜測你的意圖。