「Jetpack Compose Agent Skill」是一個開源專案

「Jetpack Compose Agent Skill」是一個開源專案，針對現有人工智慧程式撰寫工具在處理 Jetpack Compose 時存在的實際問題提供解決方案。該專案的核心觀點是：AI 編寫的 Compose 程式雖然能編譯，但在細節上常常出錯。

常見錯誤模式： 專案列舉了常見的錯誤模式：

• 不適當地到處使用「remember { mutableStateOf() }」
• 導致每幀都重新組合的不穩定程式碼
• 錯誤的 modifier 順序
• 已棄用的導航模式
• 虛構出不存在的 API

這些問題反映了 AI 工具在 Compose 領域「猜測而非真正理解」的根本困境。

兩層解決結構： 該技能透過兩層結構解決此問題。第一層是 13 份參考指南（約 130KB），涵蓋狀態管理、效能、導航、modifier、側效應、列表捲動、動畫、主題、無障礙設計、CompositionLocal、已棄用模式和實驗性 Styles API，每份指南都包含正確做法與常見陷阱。第二層是 5 份原始程式檔（共 2.3MB），直接從官方「androidx/androidx」程式庫複製，讓 Agent 在需要驗證實現細節時能查閱真實程式碼而不是猜測。

安裝支援範圍： 安裝流程相當簡潔——只需 5 分鐘。使用者可將技能檔案複製至各種工具的指定目錄，支援的工具包括：

• Claude Code
• Codex CLI
• Gemini CLI
• Cursor
• GitHub Copilot
• Windsurf
• Amazon Q Developer

對於任何其他工具，只要能讀取 markdown 即可。

可量化的改變： 安裝後的改變是具體且可量化的：

• 狀態管理：從無處不用「mutableStateOf()」改為根據情境選擇適當的狀態原始型別
• 效能：從生成每幀都重新組合的程式改為應用穩定性標註和延遲讀取
• 導航：從已棄用的字串路由改為型別安全的可序列化路由類別
• modifier：從隨意排序改為正確順序並能解釋原因
• 側效應：從錯誤的協程範圍改為正確的效應選擇和生命週期感知的 key
• API：從幻想參數改為檢查真實原始碼

務實的方法論： 該專案採用的方法論值得注意——它不試圖讓 AI「變聰明」，而是透過明確的、由原始碼驅動的參考資料來補強 AI 的知識缺口。這是對當前 AI 編程工具限制的務實認可，同時提供了可行的改善路徑。

授權與貢獻： 專案由 aldefy 維護，使用 MIT 授權，而來自 androidx 的原始程式碼遵循 Apache License 2.0。專案明確歡迎 PR，特別是涵蓋新 API、更正、Compose Multiplatform 支援等方面的貢獻。整體上，這是一個指向明確問題、提供實用解決方案的務實工程產物，反映了使用 AI 工具進行 Android 開發時面臨的真實挑戰。