android-java

android-java 技能概覽

android-java 是用來做什麼的

android-java 是一個聚焦的 Android Java 技能，適合在以 Java 為主的 Android app 程式碼中工作，尤其是專案採用 MVVM、ViewBinding 和 Espresso 測試時最有幫助。當你需要 android-java skill 來編輯或擴充原始檔，且不想憑空猜測專案的 Android 結構時，它特別實用。

誰適合使用它

如果你正在修改 Android app 裡的畫面、ViewModel、repository、Gradle 設定或測試程式碼，就適合使用這個 android-java skill。對於 Android 前端開發來說，只要主要工作是正確串接 UI、狀態與應用結構，而不是從零發明全新架構，它就是很合適的選擇。

它有什麼不同

它的主要價值在於能針對常見的 Android app 分層提供實作導向的指引：data、domain、ui、依賴注入，以及測試資料夾。這讓 android-java guide 比一般泛用的 Android 提示更有幫助，因為它能協助你在修改時保留專案慣例。若你的 app 是 Kotlin 優先、Compose 優先，或高度依賴特定框架，這個技能就沒那麼適合。

如何使用 android-java skill

安裝並打開正確的檔案

進行 android-java install 時，先透過你的目錄工具或 skill manager 把技能加進來，然後先打開 SKILL.md。接著閱讀最相關的專案脈絡，通常最重要的是 README.md、AGENTS.md、metadata.json，以及如果存在的話，rules/、resources/、references/ 或 scripts/ 資料夾。在這個 repo 裡，技能內容主要集中在單一檔案，所以 SKILL.md 是最關鍵的起點。

給技能一個具體的 Android 任務

android-java usage 最有效的情境，是你的提示詞明確指出功能、檔案區域與限制。不要只說「幫我處理 Android」，而是像這樣寫：「更新 app/src/main/java/.../ui/login/ 裡的登入流程，支援錯誤狀態，維持 MVVM，並為失敗路徑加入 Espresso 覆蓋。」這樣 android-java skill 才有足夠脈絡去正確判斷分層放置、命名與測試範圍。

先看 repository 路徑，再開始修改

先用 skill 裡的檔案樹來定位：app/src/main/java/.../data 放本機或遠端資料存取，domain 放商業規則，ui 放 activities、fragments 和 ViewModels，而 androidTest 則放 instrumentation 覆蓋。如果你不確定變更該放哪裡，先檢查最靠近的功能資料夾，再沿著依賴往外追，不要直接重寫整個 app。

明確提示架構與測試意圖

一個好的 android-java guide 提示詞，應該同時說明架構期待與驗收標準。像是：「新增一個取得使用者詳細資料的 repository 方法，透過 ViewModel 暴露出來，用 ViewBinding 更新 fragment UI，並加入 repository 的單元測試與 happy path 的 Espresso 測試。」這比含糊的功能需求更好，因為它直接告訴技能哪些層級必須修改，以及你期待用什麼方式證明正確性。

android-java skill 常見問答

android-java 只適合前端開發嗎？

不是。雖然 android-java for Frontend Development 的切入點確實存在，但這個技能也涵蓋會影響 UI 行為的資料流、repositories、依賴注入與測試。如果你的任務碰到會餵給畫面的 app 邏輯，它仍然能派上用場。

我一定要已經有 Android Java 專案才能用嗎？

是，這是最合適的使用情境。android-java skill 的設計目標，就是在既有的 Java Android codebase 裡工作，並且已經有固定資料夾與 Gradle 檔案。它不是通用的 Java 後端技能，也不適合拿來處理一個還沒有結構的空白 app 概念。

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

一般提示詞可能只會產出泛泛的 Android 建議。android-java 更適合用在你希望模型尊重 Android 專案佈局、把變更放在正確層級，並同時考慮 ViewBinding、MVVM 和 Espresso 的情況。這會大幅減少初稿完成後的整理工作。

什麼情況下不該用它？

如果你的專案是純 Kotlin、以 Jetpack Compose 為主，或主要任務跟 Android 原始碼無關，就可以跳過 android-java install。如果你需要的是深度的產品設計協助，而不是實作協助，它也不是最佳選擇。

如何改進 android-java skill

給它最小但完整的功能需求

最佳輸出通常來自這種輸入：明確點出畫面、資料來源，以及成功／失敗行為。例如：「在 FeatureFragment 中，為新的 API 回應顯示 loading、empty 和 error 狀態，並且讓 ViewModel 成為唯一負責格式化 UI state 的地方。」這比「把畫面弄好一點」更有效，因為它限制了實作方向，也能避免不必要的重構。

說清楚會影響實作的限制

如果你的專案使用 Hilt、Retrofit、Room，或既有的 ViewBinding 模式，請明確說出來。當你提到像 minSdk、相容性要求、測試類型，或是否要避免引入新 library 這類限制時，android-java skill 產出的程式碼通常會更好。這些細節往往會決定某個建議到底能不能真正交付。

要求測試與你在意的邊界情況

想讓 android-java usage 更到位，就直接要求你需要的測試層，並列出你在意的邊界情況。例如：「為 null response 處理加入單元測試，並為網路失敗後點擊 retry 加入 Espresso 測試。」這能幫助技能不只停留在 happy path，而是貼近真實 Android app 的行為。

先從檔案放置是否正確開始迭代

拿到第一版答案後，先檢查變更是否落在正確資料夾，以及依賴是否仍然清楚地從 UI 流向 domain 再到 data。如果結果已經接近，但還不夠對齊，就提出更精準的修正，例如「把 parsing 移出 fragment」、「把這段邏輯保留在 repository 裡」，或「只改成 ViewBinding 寫法」。