android-native-dev

android-native-dev 技能概覽

android-native-dev 是一個聚焦的 Android 原生開發指南，適合使用 Kotlin、Jetpack Compose、Material Design 3，並以可上線的應用程式設置為目標的團隊與代理程式。當你需要的不只是一般性提示詞，而是一套可重複的方式來初始化、驗證並改善 Android app，且同時顧及正確的專案檔案、UI 限制、無障礙檢查與建置穩定性時，這個技能特別有用。若你是在使用 android-native-dev for Frontend Development，它的核心價值就是把粗略的 Android UI 需求轉成符合平台規則的實作計畫，而不是臨時拼出一個網頁風格的版面。

最適合的使用情境

當工作內容是要啟動或修復原生 Android 專案、使用 Compose 新增畫面，或讓既有 app 更符合 Android 預期時，建議使用 android-native-dev 技能。若你在意 app 結構、gradle.properties、wrapper 設定、無障礙、響應式版面，以及在寫功能程式碼之前就先處理建置排錯，這個技能尤其相關。

它的差異在哪裡

和空泛的 Android 提示詞不同，android-native-dev 會以專案狀態作為工作流程基礎：空目錄、半成品專案、已有 wrapper，或完整的 Android Studio 專案。這很重要，因為實務上常常不是 UI 設計失敗，而是設定階段就卡住了。這個技能也會指向無障礙、適應不同螢幕、動效、效能、隱私與測試等支援參考，因此比單純一句「幫我做一個 app 畫面」更實用。

何時適合使用

如果你希望輸出的原生 Android 內容具備以下特性，這個技能很適合：

• 以 Compose 為優先，或偏向現代 Android UI
• 符合 Material Design 3 的慣例
• 可搭配 Gradle 專案設定
• 重視無障礙與大螢幕行為
• 比較不容易因建置或設定基礎問題而出錯

如何使用 android-native-dev 技能

安裝並確認適用範圍

在你使用的技能管理器中執行 android-native-dev install 指令，接著確認這個技能是用在 Android 原生開發，而不是跨平台 UI。最重要的輸入是你的專案狀態：請明確告訴模型你手上是空資料夾、不完整的 repo、Android Studio 專案，或已存在的 Gradle wrapper。這會決定它應該是初始化、修復，還是擴充。

把模糊目標轉成好用的提示詞

一個有效的 android-native-dev usage 提示詞，應該包含：

• app 類型與受眾
• 目前的 repo 狀態
• 目標 UI 框架，通常是 Compose
• 要建立的畫面或功能
• 任何限制條件，例如無障礙、平板支援，或不能使用網路

例如，不要只說「做一個登入畫面」，可以改成：

Using android-native-dev, create a Jetpack Compose login flow for a finance app. The repo already has a Gradle wrapper. Prioritize Material 3, accessible labels, error states, and a compact phone layout. Start by listing the files that must exist before implementation.

這樣能提供足夠上下文，讓技能做出更好的架構與 UI 判斷。

先讀這些檔案

在實際進行 android-native-dev guide 工作時，建議先從以下檔案開始：

• SKILL.md：工作流程與情境判斷
• references/functional-requirements.md：以行為為導向的限制條件
• references/accessibility.md：標籤、對比與觸控範圍
• references/adaptive-screens.md：平板、摺疊機與尺寸變化
• references/performance-stability.md：啟動與崩潰風險限制

如果任務偏向視覺表現，也要閱讀 references/design-style-guide.md、references/visual-design.md 和 references/motion-system.md。如果涉及敏感資料或權限，請先查看 references/privacy-security.md 再開始擬定 UI。

採用分階段工作流程

當你要求輸出分階段進行時，這個技能通常表現最好：

1. 確認專案狀態與缺少的檔案
2. 定義畫面或功能需求
3. 產生或修復可建置的專案骨架
4. 加入 UI 與驗證細節
5. 檢查無障礙、效能與適應性行為

這個順序可以避免常見失誤：在 Gradle、AndroidX 或 app 結構都還沒準備好之前，就直接衝進 UI 程式碼。

android-native-dev 技能 FAQ

android-native-dev 只適合新專案嗎？

不是。android-native-dev 技能同樣適用於不完整或已經起步的 Android repo。事實上，對這類專案它往往更有價值，因為它可以在改碼之前先找出缺少的 wrapper 檔、設定缺口與專案狀態問題。

一定要用 Compose 才能用嗎？

Compose 是主要預期路徑，但即使你是在比較 Compose 與較舊的 XML 模式，這個技能對原生 Android 規劃仍然有幫助。如果你的 repo 仍以舊式 XML 為主，它就不如 Compose-first 工作那麼理想，但仍可協助處理設定、無障礙與適應性行為。

這和一般 Android 提示詞有什麼不同？

一般提示詞通常直接問功能；android-native-dev 則會先看可建置性、repo 狀態，以及 Android 特有的限制。這讓它更適合真正的實作工作，因為它會在你浪費時間做美化之前，先暴露像是缺少 gradle.properties、wrapper 設定，或無障礙缺口這類阻塞點。

什麼情況下不該用它？

如果你正在做跨平台行動開發、僅限後端的 Android 服務，或只是做不打算實作原生 Android 程式碼的設計稿，就不要選 android-native-dev。如果你要的是廣泛的產品策略，而不是親手動手做 Android 實作指引，它也不是最佳選擇。

如何改善 android-native-dev 技能

先把專案狀態講清楚

品質提升最大的一步，就是先說明 repo 是空的、半成品，還是已經可以建置。如果你只說「幫我做 app」，技能就得自己猜太多。若你說的是「Android Studio 專案、缺 wrapper、Compose 畫面已經存在」，它就能把焦點放在真正缺口上，避免過度初始化專案。

指定不可妥協的條件

若要更好的 android-native-dev usage，請把會影響實作決策的限制條件一起講明：

• 無障礙需求，例如 TalkBack 標籤或對比度
• 螢幕目標，例如只支援手機，或要支援平板／摺疊機
• 效能限制，例如啟動要快
• 安全限制，例如盡量減少權限
• 視覺限制，例如 Material 3 或嚴格品牌風格

這些細節會直接影響版面、狀態處理與元件選擇。

要求驗證，不要只要產出

常見失敗模式是拿到一份看起來不錯、但其實沒過建置或 UX 基本要求的程式碼。你應該要求技能驗證 ./gradlew assembleDebug、列出必要檔案，並檢查無障礙或適應性螢幕的缺口。如果第一次輸出不完整，就分階段迭代：先要缺少的檔案清單，再要畫面實作，最後再做檢視與修正。

提供好與不好的範例

如果你已經知道什麼叫「好」，就直接說出來。比如說：「我要的是精簡、偏 production 風格的設定頁，不要行銷型版面。」這能幫助 android-native-dev skill 避開裝飾性 UI，並保持在真正的 Android 前端實作方向上。