Community画像github.com

アセット生成

OpenAIの最新GPT画像モデル(バージョン2以降)を使用して、ゲーム内最終画像アセット(アイコン、アイテム、背景、キャラクター、ストアアート)を生成します。

アセット生成 とは?

このスキルは、ゲーム開発プロジェクトにおいて、OpenAIの最新GPT画像モデル(バージョン2以降)を使用して最終的なゲーム内画像アセット(アイコン、アイテム、背景、キャラクター、ストアアートなど)を生成するためのものです。既存のゲームアートスタイルに合わせて、一貫性のある高品質な画像を生成できます。 主な機能として、単一またはリスト形式のアセット生成、透過画像対応、アートスタイル参照、生成履歴のログ記録などがあります。初回使用時にはOpenAI APIキーの設定をガイドし、プロジェクトごとに画像生成のオン/オフを選択できます。 Claude Code環境で動作し、`/gd:asset`コマンドやユーザーが最終アートを要求したときに自動的に起動します。GDD(ゲームデザインドキュメント)のモックアップ作成には使用せず、HTMLとCSSで表現されるモックアップと区別されています。 生成プロセスは4ステップで構成されています:(1)画像生成の有効化確認とAPIキー設定、(2)アセットの計画(スタイル、サイズ、透過性の指定)、(3)実際の生成(モデル自動選択、プロンプト記述)、(4)生成画像の確認とレポート作成。各生成はログファイルに記録され、生成画像はAI生成であることが報告されます。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/robson-work/gd-toolkit/tree/HEAD/skills/asset

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

最終画像アセット

<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キーが必要であることを質問で伝えます。選択肢は以下の通りです:
      1. 今すぐキーを設定する(推奨): 以下の設定手順を表示し、ユーザーが完了したと言うまで待ちます。その後、再度 check を実行します。準備完了したら、on と書き込みます。
      2. このプロジェクトでは使用しない: off (opted out <YYYY-MM-DD>) と書き込み、生成アートなしで続行します。
      3. 後で: 今回の画像はスキップし、フィールドは not set のままにし、次回再度尋ねます。
    • キーが見つかった場合(リポジトリの .env、環境変数、または別のプロジェクト用に設定済み)、質問ではキーが見つかった場所と check で選択されたモデルを伝えます。check が .env ファイルがgitで追跡されていると報告した場合、キーがコミットされていることを警告し、ローテーションを推奨し、gitの管理外に移動するよう勧めます。選択肢は: このプロジェクトで使用する(推奨、その後 on と書き込む)、このプロジェクトでは使用しない(off)、後で。

APIキー設定(ユーザーに表示)

  1. platform.openai.com → API keys → Create new secret key にアクセスします。プロジェクトスコープのキーが最適です。
  2. Billing にクレジットがあることを確認します。GPT画像モデルは、組織の確認(Settings → Organization → General)を要求する場合もあります。確認後、アクセスが有効になるまで数分かかることがあります。
  3. キーをこのマシンに保存します。チャットに貼り付けないでください。
    • 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)。
  4. 完了したら教えてください。確認します。この確認は無料です。

キーチェーン、シェル、または設定ファイル内のキーはすべてのプロジェクトで機能します。.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生成であることを伝え、オーナーが開示が必要な場所(ストアのリストなど)を判断できるようにします。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル