Agent Sprite Forge

言語：English | 繁體中文 | 简体中文 | 日本語 | 한국어

0.4 ティザー：すべてのフレームが ASF の実際の出力です。

このページは英語版と同期した要約です。詳しい説明は English README が正です（繁體中文は全訳）。

一枚の原画 → ゲームで使えるスプライト一式

Claude Code（プラグイン）、Codex、Grok 向けのエージェント skills です。エージェントが手元で最良の画像生成経路で原画（master still）を一枚作り、その原画からアクションごとに一本の image-to-video 動画を生成します。決定的な Python ツールが各アクションを検査、キー抜き、位置合わせ、ループ選択、リタイム、仕上げ（finish）、パッケージ化し、Godot、Aseprite、Web ゲームに渡します。

原画一枚（ローカル Codex CLI で生成）→ アクションごとに Grok の image-to-video → 6 アクション。すべてのフレームは 2026-10-06 の実機実行の出力です。

0.4 の新機能：大型アップグレード

実機での計測	以前	0.4
ピクセルの狐（48x64、8 フレーム）：フレームあたりの色数	594–709	16–19
ピクセルの狐：アルファ段階 / フレームあたりの孤立ピクセル（平均）	199 / 732	2 / 75
キー抜き：紫フリンジ（外周の色漏れ、平均）	0.704	0
キー抜き：145 フレームで漏れたキー画素 / 処理時間	7,780 / 271 秒	0 / 44 秒
攻撃：ワンショットの長さ	4.1 秒	0.7 秒
カラーロック：隣接フレーム間の色相反転（走りループ）	352	170
QC：誤って却下された良いテイク	24 本中 18 本	24 本中 0 本

• 画像生成が最優先： すべての画像と動画は route_media.py を通ります。設定済みの API キー（OpenAI、Google Gemini、xAI、BytePlus、fal.ai）→ サインイン済みのローカル Codex / Grok CLI → 最後の手段としてコードアート（codeart2d）。
• 原画一枚： master_still.py が候補を生成し、編集で直し、master.json として承認します。
• アクション一式： sprite_set.py がアクションごとに動画を生成し、自動 QC とリテイク、ソフトマット（紫フリンジなし）、位置合わせ、ループの自動選択、ワンショットの自動リタイム、HD カラーロック、既定の HD 仕上げ（依頼があればくっきりしたピクセル仕上げ）、エンジン書き出しまで行います。
• エンジン書き出し： animation.json 3.0、PNG アトラス、WebM alpha、packed MP4、Godot SpriteFrames / Sprite3D、Aseprite JSON。マップは Tiled、Godot、LDtk。

ビフォー・アフターの画像と詳細：What's new、CHANGELOG、実機記録。

クイックスタート

1. インストール。 Claude Code：

   claude plugin marketplace add 0x0funky/agent-sprite-forge --sparse .claude-plugin skills
   claude plugin install agent-sprite-forge@agent-sprite-forge
   python -m pip install "numpy>=1.26" "Pillow>=10.1" "scipy>=1.11"
   

   Codex / Grok：git clone https://github.com/0x0funky/agent-sprite-forge.git、python -m pip install -r requirements.txt、続けて python tools/install_skills.py --apply --host codex（Grok は --host grok）。動画には ffmpeg 5.1+ が必要です。

2. 原画： Use $generate2dsprite to make a master still of <あなたのキャラクター>, side view, facing right, HD.

3. アクション一式： Use $video2dsprite to animate the approved master: idle, walk, run, attack, jump and hurt.

生成経路と API キー

順序	経路	使う場面
1	API：設定済みのキー（OpenAI、Gemini、xAI、BytePlus、fal.ai：Kling v3、Veo 3.1、Luma、MiniMax、Wan、Vidu、LTX）	キーの設定が同意とみなされ、毎回の確認はありません
2	ローカル CLI：サインイン済みの Codex（image_gen）または Grok（画像、ACP モードの動画）	キーがない、またはアカウント理由で API が拒否したとき。サブスクリプションの枠を使用
3	コードアート（codeart2d）	最後の手段：経路がまったくないとき、または明示的に依頼されたとき

キーは環境変数（OPENAI_API_KEY、GEMINI_API_KEY、XAI_API_KEY、ARK_API_KEY、FAL_KEY）またはユーザー設定ファイル（Windows：%APPDATA%\agent-sprite-forge\config.json、macOS／Linux：~/.config/agent-sprite-forge/config.json）に置きます。詳細は Routes and providers。

リンク

• パイプラインとエンジン書き出し、マップ、Showcase、ツール、必要環境
• エンジン／エディタへのインポートは未検証：Engine exports を参照
• 既知の制限、生成アセットのライセンス

ライセンス

MIT。LICENSE を参照。