codex-imagegen

Codex Imagegen

Claude が指示とレビューを行い、Codex は生成のみを行います。ユーザーの Codex サブスクリプションを使用し、別途料金が発生する画像 API は決して使用しないでください。Python 3.9 以降、macOS/Linux、およびログイン済みの Codex CLI 0.153.4 以降（codex login）が必要です。このファイルを基準に <SKILL_DIR> を解決してください。

意図に応じて振り分ける

リクエスト	アクション	必要な場合のみ読む
明確なリクエスト／「すぐ作って」	追加の参考資料なしで、画像を 1 枚すぐに生成する	なし
方向性が不明／「質問して」	重要な質問を 1～3 件まとめて尋ねる	interview.md
「案」「시안」、複数の方向性	数が指定されていない場合は、異なる候補を 3 つ作る	directions.md
既存の画像を変更する	画像を確認し、変更点と維持する要素のリストを伝え、画像を添付する	editing.md
正確なテキスト、写真撮影、複雑な構図	関連する制作上の詳細のみを追加する	prompting-guide.md
モデルについての質問、または実行の失敗	確認済みの機能を説明するか、失敗を修正する	cli-reference.md

すべての参考資料、リポジトリのドキュメント、ランチャーのソースを読み込まないでください。すでに文脈にある回答や、関連するプロジェクトのスタイルに関する情報を再利用してください。このプロジェクトのスタイルに合わせる場合のみ、DESIGN.md を読んでください。Codex を使って質問、計画、評価を行わないでください。

ブリーフを作成する

ユーザーの言語を使用してください。この画像の用途、被写体、媒体、構図、光、配色、制約を、画像の制作に影響する場合にのみ指定してください。ユーザーの詳細な指示は維持し、関係のない項目は省略してください。通常の画像では 80～180 語を目安にし、部分編集では短くします。正確なコピーと必要な維持ルールを優先してください。

$imagegen
Asset: website hero, landscape 16:9, one image
Request: a handmade terracotta cup on pale limestone
Look: editorial product photograph; soft window light from the left;
matte glaze, natural surface imperfections; warm ivory and rust palette
Composition: cup in the right third; quiet empty left half for page copy
Constraints: no text, watermark, border, or extra objects

正確なテキストは、配置とともに引用し、1 回だけ出現するよう指定してください。参考画像を添付する場合は、添付順に Image 1: base to edit; Image 2: material reference only を追加してください。この最終ブリーフと必要な画像のみを Codex に送信し、会話、質問への回答、調査内容、このスキル、またはデザインドキュメント全体は送信しないでください。

生成と確認

ホストのファイル書き込みツールを使って UTF-8 の brief を書き込み、バックグラウンドで開始します。

python3 "<SKILL_DIR>/scripts/image_project.py" --prompt-file "<BRIEF>" --out-dir "<NEW_DIR>" --background
# Attach inputs with --image "<BASE.png>" (repeat in reference order).

ジョブディレクトリがすぐに返されます。依頼された独立した作業を続けてください。 後で image_project.py --out-dir "<DIR>" --status を使って確認します（Codex の呼び出しは不要です）。 ステータスが queued/running の間は、繰り返し状態を確認したり、完了したと主張したりしないでください。マニフェストから 完了したパスを読み取り、確認してください。画像だけが作業対象の場合は、 ホストのバックグラウンドタスク機能を使って待ち、適切な間隔で確認してください。 複数画像のプランでは、デフォルトで 2 つのワーカーを使います（設定可能な範囲は 1～4）。directions.md を参照してください。 基盤となる run_codex_imagegen.py は、フォアグラウンドでの実行にも引き続き使用できます。

ランチャーはデフォルトで、軽量な gpt-5.6-luna リレー、推論 none、 簡潔なリレー指示、スキルカタログなし、無関係なツールの無効化を使用します。 --model はテキストリレーを選択するもので、画像モデルではありません。Flare は速度を重視し、Sunburst は高度な品質と正確な編集を重視します。Codex 組み込みツールが画像バックエンドを管理するため、このランチャーではどちらも固定できません。特定の画像 モデル、API の品質設定、ネイティブ 4K、またはピクセル単位で完全に保持されたことを使用したと主張しないでください。

検証済みの stdout PNG パスのみを、ユーザーの保存先または output/imagegen/<purpose>/ にコピーします。元のファイルは保持し、編集にはバージョン付きのファイル名を使用してください。 Claude の画像読み取りツールで、全体表示と関連する詳細を確認します。 意図、構図、文字の正確さ、人体や製品の形状、保持された詳細、端を確認してください。 パスが有効でも、品質確認を通過したことにはなりません。目に見える未解決の欠陥があれば明記してください。

透明化が求められている場合は、次を実行します。

python3 "<SKILL_DIR>/scripts/verify_png_alpha.py" --require-transparent-corners "<PNG>"

四隅フラグは、切り抜きが単独で配置されている場合にのみ使ってください。市松模様のピクセルをアルファと見なさないでください。透明部分の編集については editing.md を参照してください。書き出す前に実際の寸法を測定してください。旧版 0.153.2 の基準は約 1.57 MP であり、現在の解像度を保証するものではありません。 縦横比を保ってサイズを変更し、必要に応じて意図的に切り抜きまたはパディングを行ってください。引き伸ばしはしないでください。アップスケーリングは正直に明記してください。

依頼された枚数だけ生成してください。却下された画像の修正は、対象を絞って最大 1 回までとし、承認済みの画像を自動的に仕上げたり、タイムアウトを再試行したり、セット全体を再実行したりしないでください。ユーザーが依頼した修正は、新しい編集として開始します。プレビューと使用可能なファイルパスに加えて、「2 を選んで、変更したい点を教えてください」のような役立つ次のステップを 1 つ提示してください。