minecraft-imagegen

Minecraft Image Generation Skill

Minecraft プロジェクト向けに新しいラスターアートやビジュアルコンセプトが必要で、後からリソースパック、リリース告知、ストア掲載、またはサーバーのブランドアセットに仕上げる場合に、このスキルを使用します。

対象範囲

使い分けの境界

• 使用する場合：pack.png、リリースアート、ストアのサムネイル、コンセプトテクスチャ、UI モックアップ、サーバーやバナーのアートなど、Minecraft プロジェクト用のビットマップ画像を生成または編集するタスクです。
• 使用しない場合：pack.mcmeta、ブロック／アイテムのモデル JSON、ブロックステート、フォント、サウンド、シェーダーファイルなど、決定論的なリソースパック実装の作業です（minecraft-resource-pack）。
• 使用しない場合：ベクター／コードネイティブの UI、既存の SVG／ロゴシステム、または画像以外のコード／アセットを扱うタスクです。
• 使用しない場合：現在のホストで、組み込みの画像生成機能または同等の画像編集ツールを利用できない場合です。

参照資料

• 依頼の内容が曖昧な場合、または生成／編集プロンプトのテンプレートが必要な場合は、プロンプトパターンを参照してください。
• パックアイコン、リリースバナー、サーバーヘッダー、テクスチャのコンセプトシートについては、アセットのレシピを参照してください。
• 保存済みのブリーフが関係者からのフィードバックや複数回の作業に役立つ場合に限り、scripts/scaffold-asset-brief.sh を使用してください。画像の依頼が明確であれば、そのまま作業を進められます。
• プロジェクトのワークスペースから、インストール先の絶対パスを指定してヘルパーを呼び出してください。相対パスで指定した --out の値は、そのワークスペースを起点として解決されます。インストール済みスキルのディレクトリから実行する場合は、プロジェクトの絶対パスを --out に渡すか、CODEX_WORKSPACE_ROOT を設定してください。

---

デフォルトの実行方法

• 現在のホストで、組み込みの画像生成機能または同等の画像編集ツールを利用できない場合は、作業を中止し、このホストではスキルを利用できないことをユーザーに伝えてください。そのうえで、プロンプト／ブリーフの準備、または画像生成ツールを利用できるホストの使用を提案してください。
• ホストが対応している場合は、デフォルトで組み込みの image_gen ツールを使用してください。
• 求められている成果物に合わせてください。アセットの完成を求められた場合は完成させ、探索を求められた場合はコンセプトを作成してください。明確な生成／編集依頼に対して、別途コンセプトの承認を必須にしないでください。
• 組み込みの画像生成ワークフローでは、新規生成と、既存のローカル画像／参照画像の編集に対応しています。手作業で上から描き直す手順を説明するより、こちらを優先してください。
• ホストで出力ファイルを取得できる場合は、依頼されたプロジェクトアセットを指定されたワークスペースのパスに保存してください。取得できない場合は、生成した画像を返し、ローカルへの保存を確認できなかったことを伝えてください。
• ユーザーから上書きを明示的に依頼されていない限り、バージョン付きのファイル名を使い、既存のアセットを非破壊的に保持してください。
• ローカル画像を編集する場合は、編集を依頼する前に画像を読み込むか添付し、エージェントが画像を確認できる状態にしてください。

---

適したユースケース

• MOD、データパック、リソースパック用の pack.png のコンセプトや差し替え
• GitHub、Modrinth、CurseForge、ソーシャルメディア投稿用のリリースバナーアート
• 最終的なピクセルアートに手作業で仕上げるテクスチャのルック開発用リファレンス
• サーバーのロゴ、バナー、スプラッシュアート、ルール画面のアート
• プラグインや MOD の UX 計画用 HUD／メニューのモックアップ
• ブロック、モブ、またはテーマに沿った環境をゲーム内の状況に合わせて示すプロモーションシート

---

ワークフロー

1. 依頼内容から、アセットの種類、対象の寸法、出力先のパス、生成か編集かを特定します。編集の場合は既存画像を確認し、必要な場合に限りスタイルの参考資料を集めます。
2. 利用可能なツールで依頼されたアセットを生成します。題材、構図、Minecraft のスタイル、制約を説明してください。編集の場合は、変更内容と変更せずに残す部分を明示してください。
3. 想定されている表示サイズで結果を確認します。見つかった不具合は、対象を絞って編集し、依頼を満たす結果になった後に追加の作業を必須にしないでください。
4. 依頼された結果を保存または返し、保存したパスを確認します。統合作業が対象範囲に含まれる場合は、ピクセルの調整、タイリング、パックの参照設定を完了します。追加のスキルの使用は任意です。

---

アセット別のガイダンス

パックアイコン

• 正方形にトリミングされることと、小さなサイズでも読みやすいことを意識してデザインします。
• シルエットははっきりとさせ、テキストは最小限に抑えます。
• 64x64 での読みやすさを確認します。これは便利なプレビューサイズですが、pack.png に必須の解像度ではありません。プロジェクトの目標寸法と、ホストでサポートされている画像編集ワークフローを使用してください。

テクスチャのコンセプト

• 正面から見たフラットな構図で、均一なライティングと遠近感を抑えた表現を指定します。
• テクスチャをバニラに忠実な雰囲気、ノイズのある粗い雰囲気、手描き風、または様式化された雰囲気のどれにするかを明記します。
• リリース前に手動で調整することを前提にします。生成したテクスチャは、すぐに使える素材ではなく、コンセプトや上から描き込む際の参考として最適です。

UI モックアップ

• ラベル、スロット、ステータステキスト用の余白を確保します。
• テキストは大きく、コントラストを高くします。
• モックアップをバニラ風、MOD 風のテクノロジー表現、ファンタジー風、または管理パネル風のどれにするかを明記します。

プロモーションアートとサムネイル

• リリースタイトルやキャッチコピー用に、テキストを重ねても問題のない余白を確保します。
• 小さなテキストや、モバイル画面やストアカードでつぶれてしまうようなごちゃついた要素は避けます。
• 出力にゲームプレイ風の構図、ヒーローアート、またはすっきりとしたショーケースレイアウトのどれを含めるかを指定します。

---

レビューチェックリスト

• 実際の目標サイズで画像がはっきりと読み取れます。
• テキストに誤字がなく、指定どおりの位置に配置されています。
• 余計なロゴ、透かし、無関係なオブジェクトが追加されていません。
• スタイルが、指定された Minecraft のコンテキストに合っています。
• テクスチャのコンセプトの場合、上から描き込んだり、簡略化したり、手作業でタイル状に並べたりしやすい仕上がりです。

---