最終画像アセット
<skill-dir> はこのSKILL.mdを保持するフォルダ、<plugin-root> はその2階層上のフォルダです。コマンド内ではこれらを実際のパスに置き換えてください。(Claude Codeでは、それぞれ ${CLAUDE_SKILL_DIR} と ${CLAUDE_PLUGIN_ROOT} です。)
入力: 1つのアセットまたはリスト(例:「ストリークフリーズアイコン」や「daily-quests GDDの6つの報酬アイコン」)。出力: ゲームのアセットパスにPNGファイルとして保存され、各ファイルはプロンプトとモデルとともにログに記録されます。
最初に <plugin-root>/shared/conventions.md とリポジトリ設定(アートセクション)を読んでください。
GI="<skill-dir>/scripts/gen_image.py" # Python 3のみ; キーを出力することはありません
python3 "$GI" check # 使用されるキーとモデルを確認(無料)
python3 "$GI" generate --prompt "…" --out <file.png> [--size WxH] [--background transparent] [--ref <art.png> …] [--log <log.jsonl>]
0. このプロジェクトでは画像生成は有効ですか?
設定: 画像生成 を読んでください:
on: ステップ1に進みます。off: 生成しません。既存のアートまたはリポジトリのプレースホルダパターンを使用し、レポートにはまだ必要なアセット(名前、サイズ、用途)をリストします。再度尋ねないでください。not setまたは 未設定: このプロジェクトで最初の画像です。checkを実行し、質問ツールを使って尋ねます:- キーが見つからなかった場合、最終アセットはOpenAIのGPT画像(最新バージョン、2以降)を使用し、APIキーが必要であることを質問で伝えます。選択肢は以下の通りです:
- 今すぐキーを設定する(推奨): 以下の設定手順を表示し、ユーザーが完了したと言うまで待ちます。その後、再度
checkを実行します。準備完了したら、onと書き込みます。 - このプロジェクトでは使用しない:
off (opted out <YYYY-MM-DD>)と書き込み、生成アートなしで続行します。 - 後で: 今回の画像はスキップし、フィールドは
not setのままにし、次回再度尋ねます。
- 今すぐキーを設定する(推奨): 以下の設定手順を表示し、ユーザーが完了したと言うまで待ちます。その後、再度
- キーが見つかった場合(リポジトリの
.env、環境変数、または別のプロジェクト用に設定済み)、質問ではキーが見つかった場所とcheckで選択されたモデルを伝えます。checkが.envファイルがgitで追跡されていると報告した場合、キーがコミットされていることを警告し、ローテーションを推奨し、gitの管理外に移動するよう勧めます。選択肢は: このプロジェクトで使用する(推奨、その後onと書き込む)、このプロジェクトでは使用しない(off)、後で。
- キーが見つからなかった場合、最終アセットはOpenAIのGPT画像(最新バージョン、2以降)を使用し、APIキーが必要であることを質問で伝えます。選択肢は以下の通りです:
APIキー設定(ユーザーに表示)
- platform.openai.com → API keys → Create new secret key にアクセスします。プロジェクトスコープのキーが最適です。
- Billing にクレジットがあることを確認します。GPT画像モデルは、組織の確認(Settings → Organization → General)を要求する場合もあります。確認後、アクセスが有効になるまで数分かかることがあります。
- キーをこのマシンに保存します。チャットに貼り付けないでください。
- macOS(推奨): ターミナルで以下を実行します。キーを画面に表示せずに入力でき、キーチェーンに保存します:
security add-generic-password -U -a "$USER" -s gd-toolkit-openai -w - このプロジェクトのみ: リポジトリの
.envまたは.env.localにOPENAI_API_KEY=…を追加します。ファイルが.gitignoreに含まれていることを確認してください。 - どこでも: シェルプロファイル(例:
~/.zshrc)にexport OPENAI_API_KEY=…を追加し、新しいターミナルを開きます。 - または: 自分だけが読み取れるファイルを使用:
~/.config/gd-toolkit/openai_api_key(chmod 600)。
- macOS(推奨): ターミナルで以下を実行します。キーを画面に表示せずに入力でき、キーチェーンに保存します:
- 完了したら教えてください。確認します。この確認は無料です。
キーチェーン、シェル、または設定ファイル内のキーはすべてのプロジェクトで機能します。.env のキーはそのリポジトリで機能し、キーチェーンよりも優先されます。オン/オフの選択はプロジェクトごとに行われます。
1. アセットの計画
- スタイル: 設定: アートスタイル を読み、リストされている参照アートを確認します。最も近い既存アセットを1〜4個
--refとして渡し、新しいアートがゲームに合うようにします。すべてのプロンプトでスタイルを同じ言葉で説明してください: パレット、線の太さ、シェーディング、カメラアングル、マテリアル。 - 仕様: 各アセットについて、最終サイズ、形式、透過が必要かどうか、ファイル名、パス(設定: アセットディレクトリ とリポジトリの命名パターンに従う)。
- リストを総数とモデルとともに表示し、ユーザーが承認したら生成します。一度の確認でバッチ全体をカバーします。
2. 生成
- モデル:
--model auto(デフォルト)は、キーが使用可能な最新のgpt-imageモデル(バージョン2以降)を使用し、最終アートには詳細バリアントを優先します。--fast(--prefer fastとして渡す)は下書き専用です。設定: 画像モデル がモデルを指定している場合、--modelで渡します。 - サイズ: モデルの最大正方形または最も近いアスペクト比で生成し、その後最終サイズにスケールダウンします(macOSでは
sips -Z <px>)。拡大はしないでください。 - 透過: アイコン、アイテム、スプライトには
--background transparentが必要です。出力でモデルが透過を拒否したと示された場合、画像は不透明で生成されています: プロンプトで指定した単色の平らな背景色で再生成し、その色を除去し、レポートでその旨を伝えます。 - プロンプト: 被写体を説明し、次にスタイルブロック、次に構図(中央揃え、余白、要求がない限りテキストなし)を説明します。アセットにテキストが必要でない限り、単語、ロゴ、透かしを要求しないでください。
- すべての生成を 設定: アートログ に記録します(
--log)。出荷されたアセットの隣にメタデータファイルを置かないでください。
3. 各画像の確認
保持する前にすべての画像を確認します。コンテキストを節約するため、小さなコピーを使用します。スタイルの参照と一致しない、余分なテキストやアーティファクトがある、切り抜きが間違っている、ゲーム内最小サイズで読めない場合は、最大3回まで再生成します。それでも失敗する場合は、最良のものを保持し、フラグを立てます。
4. レポート
各アセットをパス、サイズ、モデル、およびフラグとともにリストします。まだ必要なアセット(生成が off またはスキップされた場合)とログパスも記載します。画像がAI生成であることを伝え、オーナーが開示が必要な場所(ストアのリストなど)を判断できるようにします。