# 策展 · X (Twitter) 🔥

> 作者：Jorge Castillo (@JorgeCastilloPr) · 平台：X (Twitter) · 日期：2026-03-16

> 原始來源：https://x.com/jorgecastillopr/status/2033314200718905569

## 中文摘要

「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 開發時面臨的真實挑戰。

## 標籤

Skills, Agent, 開源專案, Jetpack