FlutterSDK Docs

FlutterSDK AI

FlutterSDK エコシステム向けの AI コーディングスキル。
主要なコーディングツールすべてで、AI アシスタントに Wind UI、Magic Framework などを教えます。

レジストリ · 課題 · クイックスタート

なぜ必要なのか？

AI コーディングアシスタントは強力ですが、あなたが使うフレームワークの知識はありません。ウィジェット名を幻覚し、API のパターンを推測し、規約を見落とします。

FlutterSDK AI がこの問題を解決します。 Wind UI の className システムや、Magic Framework の Laravel に着想を得たアーキテクチャなどに関する体系的な知識を AI に提供するため、最初から正しいコードを生成できます。

一度インストールすれば、あらゆるツールで使えます。

スキル

5 つのスキルを利用できます。詳しい説明はdocs/SKILLS.mdをご覧ください。

各スキルは、対応する上流パッケージの skills/ ディレクトリをそのまま反映しており、そのパッケージのリリース公開時にここへ追加されます。同期された正確なバージョンは skills/<name>/SKILL.md の version: フィールドに記載されています。また、機械可読なインデックスは skills/index.json です。この表にはどちらも重複して記載していないため、表との不一致は発生しません。

MCP サーバー

mcp.fluttersdk.com は、Streamable HTTP 経由で単一の search-docs ツールを提供します。 公開されており、認証は不要です。クライアントの完全な設定スニペット（Claude Code、Cursor、 OpenCode、Codex CLI、Gemini CLI、VS Code Copilot など）は docs/MCP.md にあります。

stdio のみをサポートするクライアント（Claude Desktop、旧バージョンの Codex CLI）の場合：

npx @fluttersdk/mcp

npx ブリッジが、stdio から上流の HTTP サーバーへ透過的にプロキシします。

クイックスタート

オプション 1：npx skills（推奨）

最も手軽な方法です。40 以上の AI コーディングエージェントで動作します。

# Install all FlutterSDK skills to all detected agents
npx skills add fluttersdk/ai

# Install a specific skill
npx skills add fluttersdk/ai --skill wind-ui

# Install globally (available across all projects)
npx skills add fluttersdk/ai -g

オプション 2：ユニバーサルインストーラー

git clone https://github.com/fluttersdk/ai.git && cd ai

# Preview what would be installed
bash scripts/install.sh --dry-run --global

# Install globally for all detected tools
bash scripts/install.sh --global

# Install globally and register the MCP server for all detected tools
bash scripts/install.sh --global --with-mcp

# Or install into your current Flutter project
bash scripts/install.sh --project

オプション 3：ツールごとの設定

{
    "skills": {
        "urls": ["https://fluttersdk.github.io/ai/"]
    }
}

/plugin marketplace add https://raw.githubusercontent.com/fluttersdk/ai/main/.claude-plugin/marketplace.json
/plugin install fluttersdk@fluttersdk-marketplace

mkdir -p .cursor/rules
cp tool-templates/cursor/fluttersdk.mdc .cursor/rules/

mkdir -p ~/.gemini/commands
cp tool-templates/gemini/*.toml ~/.gemini/commands/

mkdir -p .github
cp .github/copilot-instructions.md .github/

仕組み

skills/index.json              ← OpenCode fetches this from GitHub Pages
  → wind-ui/SKILL.md           ← Skill definition + className rules
  → wind-ui/references/*.md    ← On-demand widget docs, layout patterns, tokens
  → magic-framework/SKILL.md   ← Skill definition + framework laws
  → magic-framework/refs/*.md  ← Controllers, ORM, facades, routing, auth, ...

OpenCode：fluttersdk.github.io/ai/index.json を取得し、一覧に記載されたスキルファイルをダウンロードして、ローカルにキャッシュします。

Claude Code：プラグインマニフェスト（.claude-plugin/plugin.json）により、このリポジトリをインストールできるようになります。skills/ 内のスキルは自動検出され、/fluttersdk: 名前空間の下に配置されます。

デプロイ：main にプッシュすると、GitHub Actions が skills/ を GitHub Pages に自動的にデプロイします。

コントリビューション

新しいスキルを追加する

1. YAML フロントマター（name、description）を含む skills/<skill-name>/SKILL.md を作成します
2. skills/<skill-name>/references/ に参照ファイルを追加します
3. skills/index.json を更新します：files 配列にすべてのファイルを記載します
4. .claude-plugin/plugin.json と .claude-plugin/marketplace.json のバージョンを更新します
5. main にプッシュします

詳しい仕様については CLAUDE.md を参照してください。

重要：すべてのファイルを index.json に記載する必要があります。OpenCode は一覧に記載されたファイルのみをダウンロードします。ファイルを記載し忘れると、ユーザーが不完全なスキルを受け取ることになります。

ライセンス

MIT。詳細については LICENSE を参照してください。

_{FlutterSDK が心を込めて作成
時間の節約に役立ったら、スターを付けてください}