aldefy/compose-skill
Jetpack Compose Agent Skill — AI-powered coding guidance with actual androidx/androidx source code receipts. Works with Claude Code, Codex CLI, Gemini CLI, Cursor, Copilot, Windsurf, and more.
What it solves
AI 編碼助手助手經常生成可以編譯但包含細微錯誤的 Jetpack Compose 代碼,例如錯誤的狀態管理(remember vs derivedStateOf)、不穩定的重組(recomposition)、錯誤的修飾符(modifier)順序,以及幻覺 API。本專案提供一個結構化的知識庫,透過提供 AI 代理程式對經過驗證的參考指南與實際原始碼的存取權,來防止這些「基於感覺」的猜測。
How it works
本專案以 Markdown 檔案集的形式分發,可以作為「技能」或規則整合到各種 AI 編碼工具(如 Claude Code, Cursor, Copilot, 和 Windsurf)中。它運作於兩個層級:
- Guidance Docs: 24 份參考指南,涵蓋特定 Compose 專題(例如:狀態管理、效能、導航與多平台),將任務信號映射到特定的模式與陷阱。
- Source Code Receipts: 6 份包含來自
androidx/androidx和compose-multiplatform-core的實際 Kotlin 原始碼檔案,讓代理程式能夠驗證實作細節,而非僅靠猜測。
Who it’s for
使用 AI 編碼助手的 Android 與多平台開發者,希望確保生成的 UI 代碼遵循生產級別的模式,並避免常見的 Compose 效能與穩定性陷阱。
Highlights
- Comprehensive Coverage: 涵蓋範圍廣泛,包括 Android TV, Material 3 motion, Paging 3, 以及 Nav 2 到 Nav 3 的遷移指南。
- Source-Backed: 以原始碼為依據,使用來自官方儲存庫的真實原始碼來消除 API 幻覺。
- Multi-Tool Support: 支援多種工具,提供 Claude Code, Cursor, Copilot, Gemini CLI, Windsurf, 和 Amazon Q 的即用型安裝指南。
- Production Focused: 以生產環境為中心,包含一份「生產環境崩潰劇本」,列出常見真實世界崩潰模式的根本原因與修復方法。",
相關
- 專案
- 專案
- 專案
- 專案
- 專案