Generate2dsprite
このスキルは、アプリビルダーサンドボックス(TanStack Start + ブラウザゲーム)内で、自己完結型の2Dスプライトまたはアニメーションアセットを生成するために使用します。
大規模なゲームやプレイアブルなプロトタイプでスプライトが必要な場合、このスキルで可視スプライトアセットを生成し、ランタイム/ゲームアセンブリは別にしてください(エクスポート後、Phaser / Canvas / DOMに組み込みます)。リクエストされたスプライトアセットをコード描画のプレースホルダーで代替しないでください。
App-builder / Grok 環境
| 項目 | 値 |
|---|---|
| スキルディレクトリ | .grok/skills/generate2dsprite/ |
| スクリプト | python3 .grok/skills/generate2dsprite/scripts/<script>.py … |
| 画像ツール | imagine_text_to_image / imagine_image_to_image(パスベース。プロンプト作成は**imagine**スキルを参照) |
| 画像の確認 | PNGパスに対してread_file(Codexのview_imageは不可) |
| 生成画像のパス | imagine_text_to_imageはサンドボックス内のfile_pathを返します。処理前にそのパスを実行ディレクトリにコピーしてください |
| Python依存関係 | Pillow + numpy(イメージにプリインストール済み) |
| 出力先 | /workspace以下assets/sprites/<name>/にすることを推奨。アプリがインポート可能になります |
| エンジンターゲット | ブラウザ: Canvas 2D、Phaser、またはDOM/<img> — ユーザーが明示的に要求しない限りGodot/Unityは対象外 |
関連スキル: imagine(画像ツールの使用)、game-asset-core(+ game-animation-frames / game-character-consistency:QCおよびエンジン対応デフォルト)、generate2dmap(マップ/小道具)、video2dsprite(imagine_image_to_videoによる密度の高いモーション)、building-games(ゲームループ/統合)。
パラメータ
ユーザーリクエストから推論します:
asset_type:player|npc|creature|character|spell|projectile|impact|prop|summon|fxaction:single|idle|cast|attack|shoot|jump|hurt|combat|walk|run|hover|charge|projectile|impact|explode|deathview:topdown|side|3/4sheet:auto|2x2|2x3|2x4|3x3|3x4|4x4|5x5|custom_grid|strip_1x3|strip_1x4frames:autoまたは明示的なフレーム数bundle:single_asset|unit_bundle|spell_bundle|combat_bundle|line_bundle|hero_action_bundle|engine_atlaseffect_policy:all|largestanchor:center|bottom|feetmargin:tight|normal|safeart_style:pixel_art|clean_hd|pixel_inspired|retro_pixel|map_style|project-nativereference:none|attached_image|generated_image|local_filelayout_guide:none|optional|recommendedprompt: ユーザーのテーマまたはビジュアル方向性role: アセットが明らかにNPCの役割である場合のみname: オプションの出力スラッグ
リクエストが曖昧な場合は、references/modes.md を参照してください。
エージェントルール
- アセット計画は自分で決定してください。リクエストがすでにシートサイズ、フレーム数、バンドル構造を暗示している場合、ユーザーにそれらを詳細に指定させないでください。
- 無関係なアクションを、
4x4、5x5、またはカスタムエンジンアトラスを満たすためだけに、1つの生生成シートに詰め込まないでください。生生成シートは、1つのアクションファミリー、1つの連続シーケンス、1つの正規の方向移動シート、または1つの小道具/アセットパックを表すべきです。 - 操作可能なヒーロー、メインキャラクター、および複数のアクションを持つ価値の高いプレイヤーアセットについては、まずアクションごとに個別のグリッドシートを生成し、各アクションをQCしてから、グリッドがビジュアルレビューに合格した後に、決定論的にエンジン必須のアトラスを組み立ててください。
- 操作可能なヒーロー、メインキャラクター、および価値の高いプレイヤーボディアクションについては、デフォルトで攻撃/射撃/詠唱のボディシートをボディのみにしてください。大きな斬撃弧、マズルフラッシュ、投射物、衝撃バースト、分離したダスト、長いトレイル、または幅広の分離FXをボディシートに含めないでください。これらは別の
fx、projectile、またはimpactシートとして生成し、ゲーム内でレイヤー化してください。 - ターゲットランタイムが明示的に、アクションごとに広いセルとアクションごとの原点/アンカーメタデータをサポートしている場合にのみ、幅広の攻撃FXを同じ生ボディシートに含めてください。そうでなければ、幅広のFXバウンディングボックスにより、固定セル内でボディが縮小することを強制されます。
- アートプロンプトは自分で作成してください。プロンプトビルダースクリプトをデフォルトにしないでください。
- すべての生画像には、組み込みの
imagine_text_to_imageを使用してください。 - Three.js、Canvas、SVG、HTML/CSS描画、PIL図形描画、手続き型ジオメトリ、プレースホルダープリミティブ、またはコードレンダリングされたスクリーンショットで生スプライトアートを作成しないでください。ランタイムコードは完成した生成アセットを表示してもよく、スクリプトはレイアウトガイドを作成したり生成画像を後処理したりしてもかまいませんが、リクエストされたスプライトアートは組み込みの
imagine_text_to_imageから生成される必要があります。 - ユーザーがビジュアルリファレンスを提供または暗示する場合、そのリファレンスのサンドボックス
file_pathをimagine_image_to_imageに渡してください(ツールがファイルを読み取ります)。また、ローカルリファレンスもread_fileで確認できるようにしてください。プロンプト内で言及されているだけのパスはビジュアル入力ではありません。 - アセットが
$generate2dmapのマップ小道具である場合、またはユーザー/プロジェクトが異なるスタイルを要求している場合、ピクセルアートを強制しないでください。まずマップまたはリファレンスのスタイルに合わせてください。 - スクリプトは決定論的プロセッサとしてのみ使用してください。マゼンタ除去、フレーム分割、コンポーネントフィルタリング、スケーリング、配置、QCメタデータ、透明シートのエクスポート、GIFエクスポートを行います。
- クリエイティブな画像プロンプトを生成するためにスクリプトを使用しないでください。レガシープロンプトビルダーコマンドが存在する場合、それは互換性のための歴史的なものとして扱い、通常のスキルワークフローとはしません。
- レイアウトガイドは、画像生成のための決定論的ジオメトリ参照としてのみ許可されます。スロット数、間隔、センタリング、安全なパディングを示すことができますが、クリエイティブなアートの方向性を決して定義してはなりません。
- スクリプトフラグは、ユーザー向けのハードコードされたワークフローではなく、エージェントが選択する実行プリミティブとして扱ってください。
- 生成されたシートがセル端に触れたり、スケールがずれたり、投射物/衝撃ループが壊れたりした場合は、より適切なプリミティブ設定で再処理するか、生シートを再生成してください。
- キャラクター、プレイヤー、操作可能なヒーロー、クリーチャー、NPC、敵、召喚獣、アニメーション小道具、またはボディ/被写体が中央に配置される必要があるアセットには、
1x4、1x6、1x8、1xNなどの生の単一行シートを使用しないでください。単一行の生生成は水平方向にずれたり、不均一に切り取られる可能性が高すぎます。 - アニメーションボディアセットには、デフォルトで複数行グリッドを使用してください。4フレーム ->
2x2、6フレーム ->2x3、8フレーム ->2x4、9フレーム ->3x3、12フレーム ->3x4または4x3、16フレーム ->4x4。 - ゲームエンジンが最終的に単一行ストリップまたは混合アトラスを必要とする場合、まずアクションを複数行グリッドとして生成およびQCしてから、決定論的に配信ストリップ/アトラスを組み立ててください。
- すべてのアニメーションボディグリッドプロンプトで、被写体のボディが各セルの中央に留まり、全身が中央の60%から70%の安全領域内に収まり、すべてのセルで一貫したスケール、該当する場合は安定した足/底部アンカーライン、セル端を越える手足、武器、髪、マント、ダスト、マズルフラッシュ、または分離したFXがないことを要求してください。
- ヒーロー攻撃ボディプロンプトでは、ボディの高さとスケールが承認されたアイドル/ランシートと一致し、安定した足/底部アンカー、武器がボディのバウンディングボックスを広げない程度に近く保たれ、分離した斬撃弧や画面空間の攻撃エフェクトがないことを明示的に要求してください。
- マップ小道具パックの場合、グリッドを選択する前に小道具を分類してください。正方形の
2x2、3x3、4x4パックはコンパクトな小道具にのみ使用します。プラットフォーム、床、橋、壁、はしご、門、ドア、長い障害物、幅/高さのある小道具、衝突判定のあるオブジェクト、タイルセット/ストリップ片を正方形の小道具パックに入れないでください。代わりに、1つずつ、1x3/1x4ストリップ、カスタムワイドセル、またはタイルセット風アトラスを使用してください。 - ユーザーが明示的に異なる処理ワークフローを希望しない限り、
#FF00FFのベタ背景ルールを維持してください。
ワークフロー
1. アセット計画を推論する
最小限の有用な出力を選択してください。
例:
- 4方向の操作可能なヒーロー ->
player+player_sheet - サイドビューの操作可能なヒーロー(アイドル/ラン/射撃/ジャンプ) ->
player+hero_action_bundle- アイドルグリッドシート、通常は4フレームで
2x2 - ラングリッドシート、必要なフレーム数に応じて通常
2x2または2x3 - 射撃グリッドシート(ボディ/武器のみ)、通常
2x2 - ジャンプグリッドシート、通常
2x2 - 必要に応じて投射物/マズルフラッシュを別アセットとして
- アクションごとのQC後に、オプションで組み立てエンジンアトラス
- アイドルグリッドシート、通常は4フレームで
- サイドビューの操作可能なヒーロー(近接攻撃) ->
player+hero_action_bundle- 攻撃ボディグリッドシート、通常
2x2または2x3、ボディのみ - 斬撃弧/武器トレイルを別の
fxシートとして(攻撃に幅広のビジュアルエフェクトが必要な場合) - 衝撃スパークを別の
impactシートとして(ヒットにフィードバックが必要な場合)
- 攻撃ボディグリッドシート、通常
- ヒーラーオーバーワールドNPC ->
npc+single_assetまたはunit_bundle - 大型ボスのアイドルループ ->
creature+idle+3x3 - 魔法のオーブを投げるウィザード ->
spell_bundle- キャスター詠唱シート
- 投射物ループ
- 衝撃バースト
- モンスターラインリクエスト ->
line_bundle- 1〜3のフォームを計画
- フォームごとに、リクエストが実際に必要とするシートを作成
2. プロンプトを手動で作成する
references/prompt-rules.md を参照してください。
プロンプトを作成する前に art_style を選択してください:
- クラシックスプライト、16ビットRPGアクター、および明示的にピクセルアートを要求するリクエストには
pixel_artまたはretro_pixelを使用します。 - マップ小道具や、きれいな手描きHDマップに合わせることを意図したアセットには
clean_hdを使用します。 - レトロな粗さなしでピクセルに近い外観をユーザーが望む場合にのみ
pixel_inspiredを使用します。 - 既存のマップ、ゲーム、またはリファレンスがスタイルを定義する必要がある場合は、
map_styleまたはproject-nativeを使用します。
リファレンスが関与する場合:
- リファレンスを呼び出しに組み込む: そのサンドボックス
file_pathをimagine_image_to_imageに渡すか、2つ以上のリファレンスがある場合はパスリストをimagine_reference_to_imageに渡します(生成画像はすでにfile_pathを持ちます。ローカルファイルはそのサンドボックスパスを使用します)。また、ローカルリファレンスをread_fileで確認できるようにしてください。 - リファレンスの役割を明示的に述べてください: アイデンティティ/スタイルを保存する、同じ被写体のアニメーションシートを作成する、進化/バリアントを作成する、または一致する小道具/FXを導出する。
- リファレンスから安定したアイデンティティマーカーを保存してください: シルエット、パレット、顔/目の特徴、衣装のマーク、主要なアクセサリー、マテリアルの言語。
- リクエストされたアクションまたは進化のみを変更してください。ユーザーが要求しない限り、被写体を再設計しないでください。
- それでも、正確なシート形状、ベタのマゼンタ背景、フレームの封じ込め、全フレームで同じスケールを要求してください。
厳格な部分を維持してください:
- ベタ
#FF00FF背景 - 正確なシート形状
- 全フレームで同じキャラクターまたはアセットのアイデンティティ
- 全フレームで同じバウンディングボックスとピクセルスケール
- 明示的な封じ込め: セル端を越えるものがあってはならない
混合アクションアトラスガードレール:
- 操作可能なヒーローやメインキャラクターについて、
imagine_text_to_imageに無関係なアクション行を1つの生シートで生成させないでください(例:行1 アイドル、行2 ラン、行3 射撃、行4 ジャンプ)。 - 操作可能なヒーロー、キャラクター、クリーチャー、NPC、敵、召喚獣、またはアニメーション小道具について、
imagine_text_to_imageに1x4 アイドル、1x4 ラン、1x4 射撃、1x4 ジャンプのような生の単一行アクションストリップを生成させないでください。 - エンジンが結合された
4x4、5x5、カスタムアトラス、または行ストリップ配信形式を必要とする場合、アクショングリッドを個別に生成し、個別に処理およびQCしてから、決定論的に配信アトラスを組み立ててください。 - 例外は、正規の方向移動シート、1つの連続した長いアクションシーケンス、小道具パック、タイルセット風アトラス、および重要度の低いコンパクトな敵戦闘シートです。これらでも一貫性のあるプロンプトとビジュアルQCが必要です。
- 投射物、マズルフラッシュ、衝撃、ダストトレイル、および分離したFXは、意図的に同じアクションシルエットの一部であり、しっかりと取り付けられたままである場合を除き、別のシートに保持してください。
- 操作可能なヒーローやメインキャラクターの場合、エフェクトがアクションのバウンディングボックスをアイドル/ランよりもはるかに広くまたは高くする場合、「しっかり取り付けられている」だけでは不十分です。幅広の斬撃弧、マズルフラッシュ、長い武器トレイル、ダストクラウド、および衝撃バーストは、デフォルトで別のFXシートに分割してください。
アニメーションボディグリッドガードレール:
1x4およびその他の生の単一行シートは、アニメーションボディの有効なデフォルトではありません。これには、プレイヤー、操作可能なヒーロー、クリーチャー、NPC、敵、召喚獣、アニメーション小道具、およびボディに取り付けられた戦闘アクションが含まれます。- 4フレームのボディアクションには
2x2を使用します。これは、アイドル、短い攻撃、射撃ボディ、ジャンプ、被ダメージ、ホバー、およびコンパクトなサイドビューの歩行/ランのデフォルトです。 - 6フレームのボディアクション(詠唱、攻撃、召喚、ラン、チャージ、変身など)には
2x3を使用します。 - より長いボディアクションには
2x4、3x3、3x4、または4x4を使用します。長い行よりもコンパクトなグリッドを優先してください。 - 4方向トップダウン歩行の場合、
4x4は生生成形状として残すことができます。これは4つの無関係なアクション行ではなく、正規の方向移動シートであるためです。 - 最終的なランタイムが行ストリップを必要とする場合、処理後の複数行グリッドフレームからQC後に組み立ててください。
- キャラクターをすべてのセルの中央に保ちます。ボディの中心線はセルの中央近くに留まり、足/底部アンカーは可視の場合同じy位置に留まり、被写体は中央の安全領域のみを占有し、余分なマゼンタパディングを残す必要があります。
- 攻撃、射撃、詠唱、チャージ、およびその他のボディアクションでは、ボディの高さは承認されたアイドル/ランのボディ高さに近く保つ必要があります。固定セルランタイムを使用している場合、
edge_touch_framesが空であっても、ボディがアイドル/ランよりも約10〜15%以上小さく見える場合は、ボディアクション出力を拒否してください。
マップ小道具パックガードレール:
- 正方形の
2x2、3x3、4x4生小道具パックは、コンパクトな小道具(岩、低木、樽、木箱、ランプ、小さな看板、鉢、がれき、小さな装飾品など)にのみ使用してください。 - 幅の広いものや衝突判定が重要なマップオブジェクトには正方形の小道具パックを使用しないでください: 床、プラットフォーム、棚、地形チャンク、橋、壁走行、はしご、道路、レール、パイプ、長いスパイクトラップ、門、ドア、建物、大きな木、チェックポイント、出口、ビルドパッド。
- ユニーク、大型、重要、高さがある、不規則、または衝突判定に合わせる必要がある小道具には、1つずつ生成を使用してください。
- 繰り返し可能なプラットフォーム/床アセットには
1x3または1x4ストリップを使用し、左キャップ、中央リピート、右キャップ、およびオプションで傾斜/コーナー/端バリアントを含めます。 - 複数の小さな小道具(エリアパック)や衝突判定のないアセットには、カスタムワイドセルと1つのマゼンタ背景を使用します。