Delegate Imagegen

delegate-imagegen

画像生成・画像編集を Codex 子プロセスへ委譲する。task_type=imagegen、既定モデル gpt-5。他 delegate と同じモデル解決を使うが、画像生成 capability bridge のため実行系は gpt* → Codex のみに限定し、Claude パスは使わない。

スクリプトパス

• Claude Code: skill_dir=.claude/skills/delegate-imagegen
• Codex: skill_dir=.agents/skills/delegate-imagegen

以降のコマンド例は Claude Code の .claude/skills/delegate-imagegen を使う。Codex で使う場合は、同じ相対構造の .agents/skills/delegate-imagegen に読み替える。

モデル価格参照

コスト分析・単価比較が必要な場合のみ、<skill_dir>/model-token-prices.json を読む。このデータは参照用であり、delegate の起動可否判定には使わない。

委譲する前に

この skill は、main agent が画像生成 capability を持たない場合、または画像生成に関する試行錯誤を worker 側へ隔離したい場合に使う。ユーザーが求める成果物が SVG / HTML / CSS / canvas / 既存デザインシステム内のコードで表現する方が適切なら、この skill ではなく通常の実装・編集として扱う。

ユーザーから出力先の明示がない場合、worker には DELEGATE_IMAGEGEN_OUTPUT_DIR の既定出力先へ保存させる。既存画像を編集する場合は、対象ファイルパス、保持すべき要素、変更点、許容されるスタイル変更を request に明記する。

実行フロー（one-shot）

1. リクエスト作成: Objective / Scope / Context / Acceptance criteria / Verification / Constraints の Markdown を stdin で渡す。出力先指定がなければ Constraints に DELEGATE_IMAGEGEN_OUTPUT_DIR の既定出力先を使う旨を書く。既存画像を編集する場合は、対象ファイルパス、保持すべき要素、変更点、許容されるスタイル変更を request に明記する。
   • DELEGATE_IMAGEGEN_MODEL は effort suffix に対応しない。@ 付きモデルは prepare が exit 6 で fail-closed する。
2. 実行: out="$(printf '%s' "$req_md" | bash .claude/skills/delegate-imagegen/scripts/run-imagegen.sh "$PARENT_TASK_TYPE_CHAIN" "$REQUESTER_SESSION_ID")"（top-level 起動なら $PARENT_TASK_TYPE_CHAIN は空でよい）。
   • run-imagegen は内部で prepare-imagegen → delegate-imagegen-codex → read-response を順に実行し、stdout は成功・失敗とも単一 JSON（exit_code / status / content / content_truncated / response_file / observe_file / run_dir）を返す。
   • selector 省略時の既定は auto。
   • exit code は内部スクリプトを透過する。exit 3=前提不足 / exit 4=委譲サイクルなら中止する。exit 6 の場合は、許容値列挙を含む stderr の 1 行をそのままユーザーへの説明に使う。
   • run-imagegen.sh は dispatch 前に observe_file: <path> を stderr へ先出しする。run-imagegen.sh が Bash timeout で background へ退避しただけの場合は再実行しない（再実行は worker の二重起動になり、implement / chore では同一 worktree の同時書き換えになる）。復旧は bash .claude/skills/delegate-imagegen/scripts/read-json.sh .state.phase "$observe_file" を見て分岐する。ended または stalled なら終端なので、どちらでも bash .claude/skills/delegate-imagegen/scripts/read-json.sh .run.response_file "$observe_file" で応答パスを取得して bash .claude/skills/delegate-imagegen/scripts/read-response.sh で読む（stalled でも failed response が書かれる）。running の間は .heartbeat.ts が進んでいれば待つ。running のまま .heartbeat.ts が DELEGATE_OBSERVE_HEARTBEAT_INTERVAL（既定 10 秒）を大きく超えて進まない場合は dispatcher ごと停止しているので応答は来ない。この場合に限り新しい run を出してよい。background 退避した出力ファイルは stdout と stderr が合流するが、read-json.sh は既知の harness 行（空行 / observe_file: 行 / [exited with ...] 行）に囲まれた JSON object を切り出して読める。
   • 非対話モードの親（claude -p 等）では run-imagegen を必ずフォアグラウンドで実行し、委譲所要時間より長い Bash timeout（Claude Code なら BASH_DEFAULT_TIMEOUT_MS / BASH_MAX_TIMEOUT_MS または Bash tool の timeout 引数）を設定する。
3. レスポンス消費と検証: status="$(printf '%s' "$out" | bash .claude/skills/delegate-imagegen/scripts/read-json.sh .status)" / content="$(printf '%s' "$out" | bash .claude/skills/delegate-imagegen/scripts/read-json.sh .content)" を読む。content_truncated が true なら response_file="$(printf '%s' "$out" | bash .claude/skills/delegate-imagegen/scripts/read-json.sh .response_file)" を取り出し、bash .claude/skills/delegate-imagegen/scripts/read-response.sh "$response_file" <N> で Generated files / Verification / Blockers など必要 section だけ段階読みする。読了後、worker の本文を再要約しない。main のユーザー向け応答は生成ファイル一覧と短い結果だけに留める。Generated files のパスが存在することを main 側で確認し、必要に応じて画像ファイルを開いて Acceptance criteria と明らかに矛盾しないか確認する。

高度なフロー（個別スクリプト）

dispatch 中の observe 監視、background 実行など、途中で親の判断を挟むフローでは従来の個別スクリプトを使う。

1. 準備: Objective / Scope / Context / Acceptance criteria / Verification / Constraints の Markdown を stdin で渡す。出力先指定がなければ Constraints に DELEGATE_IMAGEGEN_OUTPUT_DIR の既定出力先を使う旨を書く。exit 3=前提不足 / exit 4=委譲サイクルなら中止。
   • DELEGATE_IMAGEGEN_MODEL は effort suffix に対応しない。@ 付きモデルは prepare が exit 6 で fail-closed する。
   • out="$(printf '%s' "$req_md" | bash .claude/skills/delegate-imagegen/scripts/prepare-imagegen.sh "$PARENT_TASK_TYPE_CHAIN" "$REQUESTER_SESSION_ID")"（top-level 起動なら $PARENT_TASK_TYPE_CHAIN は空でよい）
   • model="$(printf '%s' "$out" | bash .claude/skills/delegate-imagegen/scripts/read-json.sh .model)" / request_file="$(printf '%s' "$out" | bash .claude/skills/delegate-imagegen/scripts/read-json.sh .request_file)" / response_file="$(printf '%s' "$out" | bash .claude/skills/delegate-imagegen/scripts/read-json.sh .response_file)" / run_dir="$(printf '%s' "$out" | bash .claude/skills/delegate-imagegen/scripts/read-json.sh .run_dir)" / observe_file="$(printf '%s' "$out" | bash .claude/skills/delegate-imagegen/scripts/read-json.sh .observe_file)"
2. 実行系分岐:
   • model が gpt*: bash .claude/skills/delegate-imagegen/scripts/delegate-imagegen-codex.sh "$model" "$request_file" "$response_file" "$run_dir" "$observe_file"。非対話モードの親（claude -p 等）では子プロセス起動を必ずフォアグラウンドで実行し、委譲所要時間より長い Bash timeout（Claude Code なら BASH_DEFAULT_TIMEOUT_MS / BASH_MAX_TIMEOUT_MS または Bash tool の timeout 引数）を設定する。実行中の通常監視は observe_file から state.phase / state.started_at / heartbeat.ts / heartbeat.stdout_bytes / heartbeat.stderr_bytes / heartbeat.last_stream_change_at だけを read-json.sh で読む。state.phase は prepared | running | superseded | stalled | ended。prepared / superseded は dispatch されなかった observe（state.started_at == null、usage は未設定で read-json.sh では null 相当）なので、usage を集計する場合は分母から除外する。
   • それ以外: 画像生成 capability bridge として扱えないため中止する
3. レスポンス読み取り: bash .claude/skills/delegate-imagegen/scripts/read-response.sh "$response_file" auto。auto が大きな response と判定した場合は status + index + Summary section を返すので、Generated files / Verification / Blockers など必要 section だけ ... "$response_file" <N> で追加取得する。読了後、worker の本文を再要約しない。main のユーザー向け応答は生成ファイル一覧と短い結果だけに留める。
4. 検証フェーズ: Generated files のパスが存在することを main 側で確認する。必要に応じて画像ファイルを開いて、Acceptance criteria と明らかに矛盾しないか確認する。

待ち時間の隠蔽（対話親向け）

対話親では体感待ち時間を隠蔽できる。経路は起動スクリプトで異なる。delegate-imagegen-codex.sh 経由は prepare-imagegen.sh で response_file を事前取得済みなので、delegate-imagegen-codex.sh を background で実行し、observe_file の state.phase / heartbeat を確認して ended または stalled になった後に read-response.sh する。run-imagegen.sh 経由は response_file を事前に取得できないので、run-imagegen.sh を background で実行した場合は read-json.sh .run.response_file "$observe_file" で応答パスを取るか、合流した出力 JSON をそのまま read-json.sh で読む。総所要時間（wall time）は変わらない体感改善であり、非対話モードの親では従来どおりフォアグラウンド実行必須。

Worker report

worker の report Markdown は次の見出しを基本にする。

• Summary: 生成・編集結果の短い説明
• Generated files: 作成・更新した画像ファイルのパス
• Parameters: 使用したプロンプト、サイズ、枚数、参照画像、重要な生成条件
• Verification: ファイル存在確認、目視確認、失敗時の再試行内容
• Blockers: 生成不能・入力不足・安全上の制約・ツール不在

制約

• DELEGATE_IMAGEGEN_MODEL → gpt-5 の順でモデル解決する
• Codex 限定で起動する。gpt* 以外に解決された場合は Claude パスへ落とさず中止する
• ユーザーに画像生成モデル選択を求めない。必要な場合は環境変数で運用側が切り替える
• 出力先が明示されていなければ DELEGATE_IMAGEGEN_OUTPUT_DIR の既定出力先に保存する
• task_type_chain 内種別への再委譲はしない（別種別 delegate は可）
• main は worker の試行錯誤ログを echo / 再要約しない。生成ファイル一覧と短い結果だけを返す