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)中。它運作於兩個層級:

  1. Guidance Docs: 24 份參考指南,涵蓋特定 Compose 專題(例如:狀態管理、效能、導航與多平台),將任務信號映射到特定的模式與陷阱。
  2. Source Code Receipts: 6 份包含來自 androidx/androidxcompose-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: 以生產環境為中心,包含一份「生產環境崩潰劇本」,列出常見真實世界崩潰模式的根本原因與修復方法。",

相關

  • 專案
  • 專案
  • 專案
  • 專案
  • 專案