aldefy/compose-skill

What it solves

AI コーディングアシスタントは、コンパイルはできるものの、状態管理（remember vs derivedStateOf）の誤り、不安定な再構成（recomposition）、修飾子の順序の誤り、あるいは幻覚（hallucination）API の使用といった、コンパイルは通るが微妙なバグが含まれる Jetpack Compose コードを生成することがよくあります。このプロジェクトは、検証済みのリファレンスガイドと実際のソースコードに AI エージェントがアクセスできるようにすることで、こうした「感覚的な」推測を防止します。

How it works

このプロジェクトは、さまざまな AI コーディングツール（Claude Code, Cursor, Copilot, Windsurf など）に「スキル」やルールとして統合できる Markdown ファイルのセットとして配布されます。2 つのレイヤーで動作します：

1. Guidance Docs: 特定の Compose 专题- 状態管理、パフォーマンス、ナビゲーション、マルチプラットフォームなど - をカバーする 24 のリファレンスガイド。タスクのシグナルを特定のパターンや落とし穴をマップします。

2. Source Code Receipts: androidx/androidx および compose-multiplatform-core からの実際の Kotlin ソースコードを含む 6 つのファイル。エージェントが推測ではなく実装の詳細を検証できるようにします。

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: よくある実世界の解析（crash）パターンの根本原因と修正方法を記述した「本番環境用クラッシュ・プレイブック」を含みます。