qiaomu-codex-imagegen

Qiaomu Codex ImageGen

Codex には、ほかのエージェントからは呼び出せない画像ジェネレーターが付属しています。このパッケージはそれを経由して画像を生成し（codex app-server）、画像を実用的なものにするための工夫を加えます。689 件の参考プロンプトから厳選した 24 種類のテンプレート（48 種類のプリセット）、Mondo のポスター制作技法、シナリオのプリセット、事実・テキスト・アイデンティティに関するルールセットを備えています。

呼び出し方

1. MCP ツールが使える場合（suggest_directions、compose_prompt、generate_image、search_prompts、get_prompt、build_prompt、list_catalog。Claude Code では mcp__qiaomu-codex-imagegen__*）：これらを使用してください。
2. MCP が使えない場合：このスキルのフォルダーから CLI を実行します：node scripts/cli.mjs suggest|compose|generate|search|prompt|list（--help を参照）。
3. どちらも使えない場合：ユーザーにインストールを案内してください（README）。Codex CLI が必要で、ログイン済みである必要があります。コードで画像を偽装してはいけません。

ワークフロー：提案、選択、作成、生成、確認

1. ヒアリング（まだツールを呼び出さない）

次の内容を抽出します：トピック、成果物（用途）、比率、テキストモード、正確に表示する必要がある事実、参考資料とそれぞれの役割（identity 人物、product 実物のパッケージ、style スタイル、layout レイアウト）、必ず維持する要素、避ける要素。

• テキストモード：none（テキストなし）、exact_short（指定した短いテキストのみ）、typeset_later（タイトルを後から組める余白を残した、テキストなしのベース画像）。
• ポスター、表紙、カード、スライドにはタイポグラフィのレイヤーが必要です。 完成したポスターには、見出し、小見出し、1～2 行の情報、小さなタグからなる階層があります。見出しだけ、または見出しがない場合、仕上がりはポスターではなくコンセプトアートになります。したがって、これらの成果物では exact_short を使い、完全な短文セットを指定してください。つまり、headline に加え、copy を ｜ で区切った行として指定します。ユーザーが提示した事実から文言を作成してください。何も提示されていない場合は質問するか、架空のサンプル文言を明確にそう断ったうえで作成してください。実際の価格、実際のイベントの日付、名前、統計情報を決して捏造してはいけません。
• none は、ポートレートや写真（T09～T11）、情報を含まない製品のマクロ撮影、ユーザーが後から文字を組むベース画像に適しています。文字列はすべて短くしてください。また、仕上がりを確認してください。モデルは誤字を出すことがあり、特に長い中国語ではその傾向が強くなります。
• 作業を進めるうえで必要な質問だけを、最大 3 つまで行ってください。不明な被写体、実在人物のアイデンティティを示す参考資料、または必ず表示する事実について質問します。リスクの低い不足情報は、明示したデフォルト値で補ってください。

2. 違いのある方向性を少なくとも 4 つ提案する

トピック、成果物、指定があれば見出しやテキストモードを添えて suggest_directions を呼び出します。異なるビジュアル表現の仕組み（タイポグラフィ主導、グラフィック構成、写真、製品マクロ、素材・空間、ポスター風の作品向けの Mondo アーティストの選択肢）を用いた4 つ以上の方向性が返されます。1 枚の画像に異なる仕組みを混在させてはいけません。

各方向性を 1 項目ずつ、番号付きのリストで簡潔にユーザーへ提示します。

• 名前とテンプレート ID。
• そのトピックをこの表現の仕組みで描くとどうなるかを、具体的な一文で説明します（ロックテキストをコピーせず、mechanism とトピックをもとに自分で書きます）。
• ユーザーからまだ必要な情報（被写体、データ、参考写真）。
• 利用できる場合は、各方向性について references[].image のサムネイルを 1 つ確認し、実際の見た目に合う説明文にします。

そのうえで、どれを作成するかを尋ねます。1 つ、複数、「すべて」、または「あなたに任せる」から選べるようにします。これらの方向性を除外して別の案を提案すること（exclude）もできます。

ユーザーがすでにスタイルを指定している場合（「Mondo 風で」「T03」「このスタイルで」）、または進めるよう指示している場合（「そのまま作って」「あなたに任せる」）は、質問を省略します。「あなたに任せる」と言われた場合は、異なる系統から最適な方向性を 2 つ選び、その選択と理由を伝えてください。

3. プロンプトを作成する

選んだ各テンプレートの方向性について、具体的な変数を指定して compose_prompt を呼び出します。

• トピックを、目に見えるシルエット、動作、または関係性のいずれか1つに置き換え、それがトピックとどう結び付くのかを説明します。メインのシンボルは最大1つ、交差する動作は最大1つです。
• 色は（背景、プライマリ、アクセント、インクという）役割であり、固定の16進数値ではありません。素材はプリセットが指定する場所に使います。ノイズをすべての要素に重ねないでください。
• 事実を創作しないでください。価格、統計、タイトル、名前、日付、天気、引用、QR コード、ロゴなどは不可です。
• missing_required が空でない場合は、その内容だけを正確に尋ねます。weak_variables がある場合は、まだ汎用のデフォルト値が設定されているため、先に具体的な値を入力します。
• プリセットに structural_override がある場合は、プロンプトを手作業で書き換えます。上書き対象のベース文を削除し、矛盾する構造を残さないようにしてから、避免：… の行とともに結果を raw_prompt として送ります。
• テキストなしのタイポグラフィテンプレートでは、タイトルを組版した後に初めてベース画像がスタイルの要件を満たすことをユーザーに伝えます。
• copy は ｜ 区切りの行で指定します。文字列に日付や数値が含まれる場合は、ホワイトリストと正確に一致するよう、すべて列挙します（または完全な text_rule を渡します）。

Mondo の方向性では、この手順を省略します。generate_image { prompt, style: <artist>, preset: <video-cover|poster|…> } を使用します。

ルールの全文とエージェント向けの正式な指示については、references/design-system/agent-guide.md を参照してください。

4. 生成する

選んだ方向性ごとに画像をデフォルトで1枚生成します。最大4枚までとし、それぞれ別の generate_image 呼び出しを使用します（並行して実行できます）。同じ方向性のバリエーションを生成する場合にのみ count を使います。所要時間は30～180秒で、Codex のクォータを消費することを伝えます。ユーザーがプロジェクトを指定した場合、out_dir はそのプロジェクト内に設定します。reference_images には絶対パスを渡します（本人確認用写真、製品写真、スタイルの参考画像、または編集対象画像）。

シリーズを作成する場合は、テンプレート、文字の階層、色の役割、テクスチャの配置、交差する動作を固定します。変更するのは、シーン、物語の焦点、色相、モジュールの幅のうち1つか2つにします。最初の画像を、残りの画像の reference_images として渡します。

5. 確認して納品する

保存した各画像を読み込み、ツールが出力する acceptance_checks に照らして確認します。最初に目が向く箇所、成立すべき関係性、意図した場所だけに使われている素材、テキストと人物の同一性の正確さ、創作された要素がないことを確認してください。合格か、不合格の場合はどの関係性が成立していないかを伝えます。

ローカルのコーパスパックがインストールされている場合は、参考資料と比較します。 生成結果を、同じテンプレートの references[].image のうち1枚または2枚と並べて確認します（suggest_directions に一覧があります）。生成結果が明らかにデザイン不足（主題だけで構成されている、文字の階層がない、副次的なレイヤーがない）なら、それも不合格です。コピー一式または不足しているレイヤーを追加し、もう一度生成してください。

不合格の場合は、その関係性を示す文だけを変更して、もう一度生成します。「より高級に」といった形容詞を重ねないでください。結果に含まれる透明な領域は自動的に白の上に合成されます（transparent_background: true はそのまま保持します）。各画像の絶対パス、使用した方向性、サイドカーの .json（正確なプロンプト）を併せて納品します。実際に生成して確認した画像に限り、「生成しました」と伝えてください。

ルール

• 生成のたびにユーザーのクォータを消費します。テスト生成は行わず、依頼がない限り count を3より大きくしないでください。
• 人物は、顔を求められている場合を除き、シルエット、後ろ姿、手、またはシンボルを優先します。人物の同一性を保つには本人確認用の参考写真が必要です。写真がない場合は、人物が架空であることを伝えます。実在する人物の肖像を使って、誤解を招くコンテンツを作成してはいけません。
• 事実や数値はユーザーから提供されたものだけを使用します。複雑なグラフや長文コピーはモデルで描画せず、後から組版します。
• 参考コーパス：search_prompts / get_prompt は、689件の参考プロンプトを収録したローカルパックを読み込みます（ユーザーのマシンにのみインストールされています）。仕組みの説明方法を調べるために使用してください。コーパスのプロンプトをそのままユーザー向けのプロンプトとして送ってはいけません。
• シンプルな方法：方向性を選ぶ手順を省略して手軽に画像を生成したいユーザーには、prompt + preset + style（66種類のスタイル、20人のMondoアーティスト）を使用します。

出力仕様

返信には、絶対パス、ピクセルサイズ、画像ごとの方向性（テンプレート／プリセットまたは Mondo のアーティスト）、行った仮定、受け入れ結果、プロンプトのサイドカーの場所を含めてください。失敗した場合は、ツールのエラーと、試すべき修正を1つ（Codex にログインする、プロンプトを短くする、参照パスを確認する）を示してください。

リソース

• エージェントガイド：ルールセット、入出力の形式、ルーティングテーブル
• テンプレートライブラリ：24 個のテンプレート、ロック、プリセット、エビデンス、機械可読な templates.json と routing.json、記入例
• シナリオ：プラットフォームごとのアスペクト比とセーフエリア、プロンプトの作成、Mondo ポスターの作成、アーティストのスタイル
• references/styles.json（66 種類のスタイル）、mondo-artists.json（20 名のアーティスト）、presets.json（13 個のシナリオ）

Copyright (c) 向阳乔木. X https://x.com/vista8, GitHub https://github.com/joeseesun/. テンプレートライブラリは https://vip.xiaoxiaodong.ai/open-source の公開エリアにあるサンプルを抽出してまとめたものです。Mondo の素材は qiaomu-mondo-poster-design（MIT）から取得しています。