> ## Documentation Index > Fetch the complete documentation index at: https://docs.magicblock.gg/llms.txt > Use this file to discover all available pages before exploring further. # MagicBlock Dev Skill > AI コーディングエージェント向けの MagicBlock Ephemeral Rollups 開発 skill。委任、Magic Actions、cranks、VRF、lamports トップアップ、commit スポンサーシップ、swaps を含む private payments、デュアルコネクションアーキテクチャなどの MagicBlock 固有パターンを含みます。 リポジトリ、インストール手順、skill のソースファイルをご覧ください。 ## これは何か MagicBlock Dev Skill は AI 開発 skill であり、MagicBlock 固有のパターンを再利用可能なワークフローとしてパッケージ化したものです。MagicBlock や Ephemeral Rollups について質問すると自動的に有効化されます。プロンプトのたびに同じ統合の詳細を説明し直す必要はなく、この skill がコーディングエージェントに対し MagicBlock 上で構築するための構造化されたガイダンスを与えます。 以下のような取り組みを行うチームを想定しています: * MagicBlock Ephemeral Rollups の統合 * Solana アカウントの委任および委任解除 * Solana + MagicBlock のデュアルコネクション アーキテクチャ * 高性能かつ低レイテンシなトランザクションフロー * 定期的な自動トランザクションのための Cranks * 検証可能なランダム性のための VRF * Magic Actions — ER commit にアトミックに連結されるベースレイヤー命令 * `lamportsDelegatedTransferIx` を使った委任アカウントへの lamports トップアップ * Commit スポンサーシップ、および `magic_fee_vault` でデフォルトの 10 commit 上限を引き上げる方法 * Private payments — Payments API を介した入金、送金、出金、swaps、プライベート読み取り用の challenge/login bearer トークンフローを含む * Solana 上のゲームおよびリアルタイムアプリ開発 * Anchor および TypeScript ベースの統合 ## インストール ### クイックインストール ```bash theme={null} npx add-skill https://github.com/magicblock-labs/magicblock-dev-skill ``` ### 手動インストール ```bash theme={null} git clone https://github.com/magicblock-labs/magicblock-dev-skill cd magicblock-dev-skill ./install.sh ``` デフォルトでは、`./install.sh` は skill を次の 2 つの個人用 skill ディレクトリにインストールします。 * `~/.claude/skills/magicblock` * `${CODEX_HOME:-~/.codex}/skills/magicblock` ### 特定のエージェントを指定する グローバル / ユーザー単位のターゲット: ```bash theme={null} ./install.sh --claude ./install.sh --codex ``` プロジェクトスコープのターゲット(常に現在のディレクトリにインストール): ```bash theme={null} ./install.sh --cursor # .cursor/rules/magicblock.mdc ./install.sh --windsurf # .windsurf/rules/magicblock.md ./install.sh --cline # .clinerules/magicblock.md ./install.sh --continue # .continue/rules/magicblock.md ./install.sh --agents-md # ./AGENTS.md ``` 組み合わせ: ```bash theme={null} ./install.sh --all # 現在のプロジェクトに全てインストール ./install.sh --project # Claude + Codex をプロジェクト内の .claude / .codex にインストール ./install.sh --path /custom/path/magicblock ``` Cursor、Windsurf、Cline、Continue、`AGENTS.md` の単一ファイルターゲットは `dist/` artifact から生成されます。`dist/` がない場合、`install.sh` は自動で `./build.sh` を実行します。 ### dist artifact を手動でビルドする ```bash theme={null} ./build.sh ``` 生成されるもの: * `dist/AGENTS.md` - 完全に展開された skill(`SKILL.md` とすべての references) * `dist/system-prompt.md` - Chat 専用プラットフォーム向けの短縮版 `SKILL.md` と reference URL * `dist/magicblock.cursor.mdc` - `.mdc` frontmatter 付きの Cursor rule * `dist/magicblock.zip` - Claude.ai アップロード用に圧縮された `skill/` フォルダ ## 利用 MagicBlock や Ephemeral Rollups について質問すると、この skill は自動的に有効化されます。 * Claude Code では `/magicblock` でも直接呼び出せます。 * Codex では名前で明示的に指定できます。例: `use the magicblock skill` * Cursor / Windsurf / Cline / Continue では、MagicBlock のトピックに触れたときにルールの説明文がコンテキストに応じて発火します。 * Chat 専用プラットフォームでは、`dist/system-prompt.md` をシステムプロンプト、custom instructions、または project context として一度ロードします。 例: ```text theme={null} Add delegation hooks to my player account Change my roll_dice function to use VRF Set up a crank that updates game state every 100ms Add a Magic Action that updates my onchain leaderboard after every commit Top up my delegated fee payer with lamports Build a private USDC transfer flow using the Payments API Help me integrate MagicBlock into my Anchor program ``` ## この Skill が提供するもの この skill は単純なプロンプトテンプレートにとどまりません。メインのエントリポイントと参考資料が、MagicBlock 固有の実装詳細にエージェントを導きます。例えば: * ベースレイヤー接続を使うべきか、ephemeral rollup 接続を使うべきかの判断 * `MagicIntentBundleBuilder`(SDK 0.11+)を使った委任、commit、委任解除フローの正しい組み立て方 * `#[ephemeral]`、`#[delegate]`、`#[commit]` の典型的な Anchor パターン * Magic Actions: `MagicIntentBundleBuilder.add_post_commit_actions(...)` を使って ER トランザクション内でベースレイヤー命令をスケジュールし、commit の確定後にアトミックに実行する * `lamportsDelegatedTransferIx` による委任アカウントへの lamports トップアップ(ベースレイヤーで一回限りの lamports PDA を投げ、ER 側で入金される) * `magic_fee_vault` PDA と委任 fee payer を intent bundle に付与してデフォルトの 10 commit スポンサー上限を引き上げる方法 * Private Ephemeral Rollups(PER)パターン — permission アカウントを保護対象アカウントと一緒に委任し、メンバー更新を ER 上で実行する * Private Payments API のワークフロー、プライベート残高を読むための challenge → login → bearer トークンフロー、および公開/プライベートの swap モードを含む * リアルタイムアプリやゲームに向けた VRF と crank の設定 * MagicBlock 開発に必要な環境変数、バージョン、依存関係 skill 全体、ソースファイル、インストール手順については、[MagicBlock Dev Skill リポジトリ](https://github.com/magicblock-labs/magicblock-dev-skill)をご覧ください。