evanca/flutter-ai-rules

Flutter AI Skills and Rules for Claude, Codex, Cursor, and Other AI-Powered IDEs

evanca/flutter-ai-rules は、36個の小さなガイダンスファイル（「スキル」） のコレクションで、AIコーディングツール（Claude Code、Codex、Cursor、Antigravityなど）が一致するタスクを検出すると自動的にロードします。コンテンツは公式ドキュメントのみから取得されています：Flutter、Dart、Firebase、および各パッケージの公式ドキュメント。個人的な意見や独自の規約は含まれていません。

「スキル」とは

スキルは、SKILL.md ファイルを含むフォルダです。AIエージェントは短い説明を読み、タスクが一致すると判断し、完全なガイダンスを自動的に取り込みます。例：認証コードに触れるとFirebase Authガイダンスがロードされ、Riverpodプロバイダーに触れるとRiverpodガイダンスがロードされます。設定にルールを貼り付けたり、@メンションを入力する必要はありません。

クイックスタート

npx skills add evanca/flutter-ai-rules

これで全てがインストールされます。Node 22.20+ が必要です（古いバージョンは即座に失敗します）。任意のNodeバージョン（またはNodeなし）で動作する代替手段：

1つのスキルのみを参照またはインストール：npx skills add evanca/flutter-ai-rules --list / --skill flutter-best-practices
プラグインとしてインストール（Claude Code、Codex、Cursor、Antigravity用）— セットをその場で更新（完全なコマンドはREADMEにあります）
手動コピー：スキルフォルダを .claude/skills/、.cursor/skills/、.codex/skills/、.agents/skills/、または .windsurf/skills/ にコピーまたはシンボリックリンク — または git clone のワンライナーでプロジェクトにセット全体をベンダリング
スキルを明示的に参照：「@.skills/bloc/SKILL.md を読んでテストカバレッジを作成してください。」

Windsurf/Devinにはプラグインマニフェストがありません（手動コピーがパスです）。GitHub Copilotは SKILL.md をまったく読みません — 代わりにレガシールールファイルを使用してください（下記参照）。

内容

36のスキルはグループ化されています：

カテゴリ	例	トリガー条件
Flutter/Dart基礎（8）	ベストプラクティス、効果的なDart、Dart 3アップデート、アプリアーキテクチャ、エラーハンドリング、Row/Columnレイアウト、プリキャッシュ	Flutterコードの作成/レビュー、プロジェクトのスキャフォールディング、レイアウトエラー
状態管理（4）	Bloc、Riverpod、Provider、ChangeNotifier	プロバイダーの設定、状態の配線、再ビルドの最適化
テストとレビュー（5）	テスト、Mockito、Mocktail、Patrol E2E、コードレビュー	ユニット/ウィジェット/ゴールデンテスト、モッキング、PRレビュー
Firebase（15）	Auth、Firestore、Storage、Analytics、Crashlytics、Messaging、Remote Config、Cloud Functions、App Check、Data Connect、AI機能	任意のFirebaseタスク — 認証状態、スキーマ、アップロード、イベント、機能フラグなど
リリースとプロダクト（4）	アクセシビリティ、インクルーシブデザイン、RevenueCatテスト、Dart Genkitエージェント	a11y、i18n、購入テスト、DartでのAIエージェント

レガシーオプション：ルールと結合バンドル

スキルが存在する前、リポジトリは2つの古い形式を提供していました。両方ともまだ動作し、維持されていますが、スキルが推奨されます。なぜなら、スキルは関連する場合にのみロードされ、毎回のリクエストでコンテキストを消費しないからです。ツールがスキルをサポートしていない場合や、単一の静的ファイルが必要な場合のみ、レガシーパスを使用してください：

rules/ — 6つの広範な基礎ファイル（効果的なDart、アプリアーキテクチャ、エラー、Dart 3アップデート、テスト、コードレビュー）。プロンプトで名前で参照します。パッケージ固有のガイダンス（Bloc、Riverpod、Firebase、Mockitoなど）は現在スキルのみです。
combined/ — 7つのトピックバンドル。それぞれ完全版と6,000文字未満のバリアント（Windsurfのハードリミットに適合）。1つをルール設定に貼り付けます。
GitHub Copilot — 結合バンドルを .github/copilot-instructions.md にコピーするか、ルールファイルを .github/instructions/ にDartのみのフロントマターでコピーするか、バンドルをルートの AGENTS.md に貼り付けます（Copilot、Codex、Antigravityで同時に動作）。

ツール別サイズガイダンス

READMEには各ツールの公式ドキュメント化されたサイズ推奨の表が含まれています（2026-07-11アクセス）。ハイライト：

Claude Code — CLAUDE.md 200行未満（ソフト）；SKILL.md 500行未満（ソフト）；説明1,536文字（ハード）
Cursor — ルール500行未満（ソフト）；SKILL.mdの数値制限なし
OpenAI Codex — ルール制限なし；スキルバンドルは50 MB zip / 25 MBファイル / 500ファイルに制限
Antigravity — ルールファイルあたり12,000文字（ハード）；SKILL.md制限は明記なし
Windsurf — グローバルルール6,000文字；ファイルあたり12,000文字（両方ハード）；SKILL.md制限なし
GitHub Copilot — 指示は約2ページ未満（ソフト）；リポジトリレベルのSKILL.mdサポートなし

このリポジトリは、最も厳しい制限（Windsurfの）を満たすために、結合バンドルを6,000文字未満に保っています。「ハード」は強制/切り捨てを意味し、「ソフト」は品質推奨です。

設計哲学：意見なし

すべてが公式ドキュメントにトレース可能 — 各ソースにリンクが提供されています。
スキルは互いに矛盾する可能性があります — ソースが矛盾するためです（例：2つのパッケージが異なるフォルダレイアウトを推奨）。両方が表示されます。
コンテンツはスケジュールでアップストリームから再取得されるため、スキルは公式ガイダンスの変更を追跡します。
あなたの好みに合わせて自由に変更できます — リポジトリ自体は客観的です。

貢献とライセンス

Forkし、スキル（skills/ 内）またはルール（rules/ 内）を追加/変更し、PRを開きます。
1つのハード要件：追加または変更されたものには公式ドキュメントリンクを含めること。ソースが ATTRIBUTION.md にない場合は、ライセンスとともに追加します。ライセンスが寛容でない場合は、引用ではなくガイダンスを言い換えます。
ライセンス：リポジトリ自身のコンテンツ（トピック選択、トリガー説明、表現/構造）はMIT。基盤となるドキュメントは独自の条件を保持 — Flutter/Dart/FirebaseはほとんどCC BY 4.0、コードサンプルはBSD-3またはApache 2.0、パッケージREADMEはMIT/Apache 2.0、およびいくつかのソース（Apple、Google Play、RevenueCat）はオープンライセンスではないため、コピーではなく事実として言い換えられています。再配布にはCC BY帰属に従ってソースリンクを保持する必要があります。完全なマッピングは ATTRIBUTION.md にあります。

結論

1回のインストールで、AIコーディングエージェントに、必要なときに正確に表示される、ドキュメントソースのFlutter/Dart/Firebaseガイダンスを提供します — 手動設定なし、コンテキストの肥大化なし、独自の規約なし。プラグインは更新を維持し、手動コピーは他のすべての場所で動作し、レガシールールファイルはスキルをサポートしないツールにサービスを提供します。