1仕組みと動作原理

Codex 内部からのみ呼び出し可能な画像生成機能を `codex app-server`（stdio JSON-RPC）経由で中継し、実用レベルに引き上げるクラフト層（24 種のテンプレート／48 種のプリセット／20 人の Mondo デザイナーおよび捏造防止ルール）を追加する。

SKILL.md

Codex ships an image generator that other agents cannot call. This package relays to it (`codex app-server`) and adds the craft that makes the pictures usable: a library of 24 templates (48 presets) distilled from 689 reference prompts, Mondo poster techniques, scenario presets, and a rule set for facts, text and identity.

処理内容：アーキテクチャの定義。独自の画像生成バックエンドを構築するのではなく、Codex を中継し、生成画像を活用可能にするためのクラフトマンシップとルールを付加する。

呼び出しエントリポイントには明確な優先順位を設定：MCP ツールを最優先し、次に本ディレクトリの CLI を使用。双方が利用できない場合はインストールを案内し、コードによる画像の偽装を厳禁とする。

SKILL.md

**No MCP**: run the CLI from this skill's folder: `node scripts/cli.mjs suggest|compose|generate|search|prompt|list` (see `--help`).…Neither available: tell the user to install (README). Requires the Codex CLI, logged in. Never fake an image with code.

処理内容：フォールバックパスと不正防止のレッドラインを設定し、エージェントがローカルの描画ライブラリを使って偽の画像を納品するのを防ぐ。

初回の要求では、メカニズムの異なる少なくとも 4 つの方向性（タイポグラフィ主導／平面構成／写真／製品クローズアップ／マテリアル空間、および Mondo デザイナーの方向性を 1 つ）を提示しなければならず、単一の画像に複数のメカニズムを混在させてはならない。

SKILL.md

Call `suggest_directions` with the topic, deliverable and any headline/text mode. It returns **four or more directions with different visual mechanisms** (typography-led, graphic structure, photographic, product macro, material/space, plus a Mondo artist option for poster-like work). Never mix two mechanisms into one image.

処理内容：「案出しをしてから生成する」ワークフローを厳密に規定。メカニズムの多様性により「同一画像へのフィルター掛け替え」を防止する。

ポスター／カバー／カード／スライドには必ずタイポグラフィ層を含める：exact_short を用いて見出しと `｜` 区切りのセット短文を提供。タイトルのみや文字なしの場合はポスターではなくコンセプトアートとみなされる。

SKILL.md

**Posters, covers, cards and slides need a typographic layer.** A finished poster has a hierarchy: headline, subtitle, one or two info lines, a small tag. With only a headline, or none, the result is concept art, not a poster.

処理内容：タイポグラフィ層を納品基準として設定。テキストはユーザー提供の事実のみに基づき、不足時は再確認するか架空のサンプルであることを明記する。

プロンプト変数のセマンティクスを制限：色は固定の HEX ではなく役割（背景／メイン／アクセント／インク）で指定。事実や数値はユーザー提供のものに限定し、価格、統計、人名、日付、QR コード、ロゴの捏造を禁止する。

SKILL.md

Colours are **roles** (background, primary, accent, ink), not fixed hex values.…No invented facts: prices, statistics, titles, names, dates, weather, quotes, QR codes, logos.

処理内容：事後修正ではなく、生成前の変数層に捏造防止を組み込む。

デフォルトでは選択された方向性ごとに各 1 枚（最大 4 枚）を並列生成し、`count` は同一方向のバリエーションにのみ使用する。生成ごとにユーザーの Codex クォータを消費するため、テスト目的の生成は禁止する。

SKILL.md

Default **one image per chosen direction**, up to four, each its own `generate_image` call (they can run in parallel). Use `count` only for variants of the same direction.…Each generation spends the user's quota: no test generations, `count` above 3 only if asked.

処理内容：並行度とクォータ消費を管理し、「単発生成の無駄な繰り返し」を防止する。

生成後は、ツールが出力する acceptance_checks（第一視覚焦点、必須の構成関係、マテリアルの位置、文字とアイデンティティ、捏造の有無）と各画像を照合してレビューを必須とし、不合格の場合は該当関係を担う 1 文のみを修正して 1 回だけ再生成する。

SKILL.md

Read each saved image and test it against `acceptance_checks` (the tool prints them): first-glance focus, relations that must hold, materials only where intended, exact text and identity, nothing invented.

処理内容：検収を「生成完了」から「目視で 1 項目ずつ照合する」プロセスへと変革する。

ローカルにある 689 件のリファレンスプロンプトコーパスは「特定のメカニズムがどのように記述されているか」を学習する目的でのみ使用し、コーパスのプロンプトをそのままユーザープロンプトとして送信することは禁止する。

SKILL.md

Reference corpus: `search_prompts` / `get_prompt` read the local pack of 689 reference prompts (installed on the user's machine only). Use them to study how a mechanism is described; never send a corpus prompt unchanged as the user's prompt.

処理内容：サードパーティ製コーパスの利用境界を明確化（検索・学習は可、そのままの転送は不可）。

納品規約として、絶対パス、ピクセル寸法、採用した方向性（テンプレート／プリセットまたは Mondo デザイナー）、前提条件、検収結果、および prompt sidecar の保存場所の報告を義務付ける。

SKILL.md

Reply with: absolute path(s), pixel size, direction (template/preset or Mondo artist) per image, assumptions made, acceptance result, and where the prompt sidecar is.

処理内容：成果物を検証可能なチェックリストとして固定し、再現性のために実際のプロンプトを sidecar に記録することを義務付ける。

2コア機能

017 つの MCP ツールと本ディレクトリ CLI のデュアルエントリ（suggest_directions / compose_prompt / generate_image / search_prompts / get_prompt / build_prompt / list_catalog）

0224 種のシナリオテンプレート × 48 種のプリセットで構成されるデザインシステム（各カテゴリにスタイルロック、置換可能変数、失敗条件、検収項目を完備）

0313 種のプラットフォームシナリオプリセット（アスペクト比、ピクセルサイズ、デフォルトスタイル、セーフゾーン、サムネイルのロジック、タイトルの余白設計を網羅）

0466 種の汎用スタイル + 20 人の Mondo ポスターデザイナーのスタイル（シルクスクリーン、ネガティブスペース、書籍／アルバムジャケット専用スタイルを含む）

05Image-to-Image／画像編集：reference_images にて人物写真、製品写真、スタイル参照、または編集対象画像の絶対パスを受け付け

06事実・テキスト・アイデンティティに関する 3 つのルール：人物は原則シルエット／後ろ姿／ジェスチャー／シンボルで表現、アイデンティティの一致には参照写真が必須、複雑な図表や長文は事後タイポグラフィで対応

07ローカル 689 件のリファレンスプロンプトコーパスの検索および閲覧（リポジトリには同梱されずローカル構築が必要。データパッケージがない場合でも基本機能は動作）

08生成後の透明領域を自動で白背景にフラット化（`transparent_background: true` で透過維持可能）、プロンプト層で背景の不透明化を要求

3外部依存関係

Kind	Dependency / Endpoint
cli	Codex CLI（`codex app-server --listen stdio://`；需已安装并登录、账号具备图片生成权限）
mcp	MCP 客户端（Claude Code / Cursor / Codex 等注册 `scripts/mcp-server.mjs`）
env	环境变量 `QIAOMU_CODEX_BIN` / `QIAOMU_CORPUS_DIR`（Codex 可执行路径与本地语料目录）

4推奨統制措置と判定根拠

安全運用のための推奨統制措置

Agent 向け

段階的・都度認可、サンドボックス推奨

管理者向け

承認フロー、ロールバック可能、全履歴監査

判定根拠（ファイルパスと抜粋）

scripts/: ローカルスクリプトまたはコマンドの実行: node scripts/cli.mjs …（suggest|compose|generate|search|prompt|list、メインエントリ）
网络端点: 外部ネットワークアクセスの宣言: 本 skill ディレクトリ内に HTTP リクエストを行うコードは一切存在しない（リスクスキャンの「ネットワークリクエスト」検出ゼロ）
本地工作目录: ファイルの読み書きと成果物の出力: 画像出力ディレクトリ（デフォルトは ~/Pictures/qiaomu-codex-imagegen/<日付>、またはユーザー指定の out_dir）

監査ノート： 評価対象は本 skill ディレクトリ（SKILL.md + scripts/*.mjs + references/* + docs/samples + agents + evals + reports、計約 88 ファイル）。オレンジ判定の理由は、ステートメントに記載された「ユーザー素材の外部送信」に起因します。skill 内のスクリプト scripts/lib/codex.mjs が codex app-server 子プロセスを起動し、ユーザーが指定したテーマ／テキストおよび reference_images（人物写真、製品写真、編集対象画像）を Codex 内蔵の画像生成（OpenAI アカウントとクォータを利用）に送信するため、codex-image-to-eagle や baoyu-article-illustrator と同等の生成バックエンド系に分類されます。レッドではありません：リバースエンジニアリング、なりすまし、保護の回避、任意コード実行は一切なし。skill 自体は API キーを読み取らず（Codex CLI のログイン済み認証情報を利用）、外部コンテンツの取得やユーザー入力の eval 実行も行いません。リスク軽減要因：codex 子プロセスのサンドボックスは出力ディレクトリへの書き込みのみを許可し、approvalPolicy は never、networkAccess は false、対話リクエストはすべて拒否。テスト生成は行わず、サードパーティコーパスはローカルデータのみでそのままの転送を禁止しています。留意事項：画像生成によってユーザーの Codex クォータが消費され、プロンプトおよび参照画像がローカル環境からモデルサービスへと送信されます。

5二重目の独立検証

[ok] 架构陈述与文件清单一致：SKILL.md 说 relay 到 `codex app-server`，§1 有 scripts/lib/codex.mjs(11655B) 与 scripts/mcp-server.mjs(1550B) 支撑 — §3 沙箱条目给出 scripts/lib/codex.mjs:81/87 的 approvalPolicy/ sandboxPolicy 原文，与 agents/interface.yaml:29 的 subprocess 声明互证，relay 说法成立。
[ok] 「无网络请求」结论：风险扫描「網路請求」标注「無命中」，与 README 大量 https:// 文档链接不矛盾 — URL 命中 26 条全部为文档/作者/上游链接（README、SKILL.md 版权行、manifest/package 的 homepage/repository），无执行期端点；出网只可能发生在 spawn 出的 codex 子进程。
[ok] 凭证面：只读两个路径类环境变量，不接触任何 key — §3 凭证命中 23 条中与本 skill 相关的是 QIAOMU_CORPUS_DIR / QIAOMU_CODEX_BIN，其余为 mondo 文案里的 credentials 一词与测试用 FAKE_CODEX_MODE / QIAOMU_CORPUS_DIR；无 API_KEY/TOKEN/SECRET 类读取。
[ok] 写盘面：29 条写盘命中集中在输出目录、sidecar、语言包与测试假图，未触及源文件 — scripts/lib/tools.mjs:144 写 sidecar；scripts/lib/png.mjs:64 写压平 PNG；scripts/build-corpus.mjs 写 ~/.local/share/.../corpus；tests/fake-codex.mjs 写 tmpdir；符合「只写输出目录」的沙箱声明。
[ok] 判级取样：与站内同类的 codex-image-to-eagle（orange）、ian-xiaohei-illustrations（orange）、baoyu-article-illustrator（orange）口径一致 — 同类「调用外部生图后端并消耗账号额度」均落橙；本 skill 无 red 特征（无逆向/冒充/绕过/任意执行），也无 blue 的可能（自身脚本会触发外部生成）。
[ok] 第三方语料授权风险已被作者显式隔离，不构成 red — README 明写 689 条语料「没有看到开放授权，所以只做成你本机的数据包，不随仓库分发」，SKILL.md 亦禁止原样转手；仅记为 verdict.risks。
[ok] meta 核定值核对：license MIT、official_desc 逐字取自 SKILL.md frontmatter、commit 与 audit 一致 — commit=c03a1ccaf77938257bb93f64e09afa9cd08efe29，与骨架 audit.skill_commit 相同；stars/last_push/installs 维持 null（无 per-skill 可定位值）。

6結論

Codex 独自の画像生成機能を完全に疎結合化：同一コアから MCP、CLI、Agent Skill の 3 つのインターフェースを同時に提供し、コマンド実行可能なあらゆるエージェントで利用可能。優先順位とフォールバックパスも明確に定義。

「生成前にメカニズムの異なる方向性を少なくとも 4 つ提示し、ユーザーが選定してから出力する」というデザインスタジオさながらのプロセスにより、画像生成を「プロンプト 1 回ごとの運任せ」から提案・レビュー型のワークフローへと昇華。

捏造防止とタイポグラフィ層をハードな制約（テキストモード、exact_short による短文セット、役割に応じた配色、ユーザー提供の事実に限定、偽装画像の禁止）として組み込み、同種の画像生成スキルと比較して極めて高い納品品質を実現。

厳格なクォータおよび実行規律：テスト生成の禁止、呼び出しごとの独立した一時セッション、出力ディレクトリのみに限定されたサンドボックス書き込み、approvalPolicy は never、対話要求の全拒否、外部依存ゼロ（Node 18+）。

サードパーティ権利関係への配慮：ライセンスが不明瞭な「小小東」の 689 件のコーパスはローカル専用データパッケージとし、そのままの転用を禁止。テンプレート化はメカニズムの抽出であり、元画像の複製ではないことを明記。

最適な用途： あらゆるエージェント（Claude Code / Codex / Cursor など）内で、動画サムネイル、小紅書向け画像、WeChat 公式アカウントのヘッダー、ポスター、カバー、PPT スライドの一括作成や Image-to-Image による画像編集を行いたいユーザー。特に、生成前に案出しを確認したいブランド・コンテンツ制作チームや、テキスト・事実の正確性を重視する現場に最適。Codex CLI のログインが完了しており、クォータの消費を許容できる環境で最もスムーズに動作します。

不向きな用途： 非推奨：ローカルツールのみで写真レタッチを行いたい場合、データからグラフやフローチャートを描きたい場合、UI モックアップの作成、動画生成、API キーベースの外部画像サービス（Codex 以外）を必要とするユースケース。Codex CLI がない環境や、アカウントのクォータを消費したくない場合は使用しないでください。

Install Agent-Ready

① Verified Mirror 2026-10-10

Option A · Direct DownloadDownload qiaomu-codex-imagegen.tar.gz

sha256: 30d89f420fcbc925…

Option B · Copy Guide for Agent

install.json

Agent はこの JSON ガイドから自動的にダウンロードして検証します。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit c03a1ccaf7.