codex-implementer: codex を実装役 subagent として利用する plugin を新設する (luna 委任 + rate limit ガード + 段階的 max 対応)

[natsuume]

概要

codex を実装役 subagent として利用する新規 plugin codex-implementer を新設する (親 issue)。Phase 1 (sub-issue) で gpt-5.6-luna への委任 + rate limit 50% ガードを実装し、Phase 2 (sub-issue) で reasoning effort を max へ引き上げる。

背景

調査結果 (2026-07-15 実施、詳細な検証手順は各 sub-issue に記載):

• モデル: GPT-5.6 ファミリー (Sol / Terra / Luna) は 2026-07-09 リリース。luna は「Fast and affordable agentic coding model」($1 入力 / $6 出力 per 1M tokens)。app-server の model/list RPC 実測で、luna の supported reasoning efforts は low / medium / high / xhigh / max (ultra は sol / terra 専用で luna 非対応)
• 性能: Terminal-Bench 2.1 で luna 84.3% (sol 88.8%)、luna (max) はコスト約 8 割減 (Artificial Analysis)。一方 SWE-Bench Pro では sol ですら Fable 5 に 15pt 劣後しており、難タスクの委任はスイートスポット外。よくスコープされた実装タスクの委任先として luna を既定とする
• companion の制約: 公式 codex plugin (openai/codex-plugin-cc) の companion script v1.0.6 は --effort を none〜xhigh に制限し max を拒否する。修正 PR fix: accept max and ultra reasoning efforts for task --effort openai/codex-plugin-cc#454 が open だがメンテナ応答なし (2026-07-15 時点)。--model gpt-5.6-luna --effort xhigh は現行 companion で通る
• ハングの罠: 未サポートの model×effort ペアを送ると app-server は 400 を返さず無イベントでハングする (app-server: turn/start accepts a model+reasoningEffort pair the model catalog says is unsupported, then hangs with zero events openai/codex#31552)。effort の扱いは常に検証済みペアに限定する必要がある

確定済みの方針 (ユーザ承認済み):

• 役割分離: codex-advisor = read-only 相談 / pre-push-review codex-reviewer = review / 本 plugin = write 可の実装委任。既存 2 plugin の役割・挙動は変更しない
• モデル戦略: 実装委任は luna 既定 (コスト効率と review 枠保護)。sol は review 用 + 明示エスカレーション先として温存
• ガード: codex 週次枠の使用率 50% 超なら委任しない。取得失敗時も fail-closed (委任中止)
• 段階導入: Phase 1 は companion が現在受理する xhigh で開始。max は upstream 対応後 (経路 A) または Plan B 直叩き (経路 B) で Phase 2 として対応

受入基準

• sub-issue (Phase 1 / Phase 2) がすべて完了していること
• 実装単位の受入基準は各 sub-issue に記載する (本 issue は方針と進捗の管理用)

I/O 契約

各 sub-issue に記載。

制約

• spark (GPT-5.3-Codex-Spark、独立枠) への降格運用はスコープ外 (必要になったら別 issue)
• statusline への codex 枠表示はスコープ外
• ultra effort は対象外

想定ファイル

• plugins/codex-implementer/ (新規、詳細は sub-issue に記載)
• .claude-plugin/marketplace.json
• README.md

関連 issue

• sub-issue: codex-implementer: Phase 1 — gpt-5.6-luna 委任 subagent を実装する #247 (Phase 1)、codex-implementer: Phase 2 — 委任 effort を max へ引き上げる (upstream openai/codex-plugin-cc#454 待ち / Plan B 直叩き) #248 (Phase 2)
• 依存部品: rate-limit: codex の rate limit を取得する /rate-limit:codex-status skill を追加する (app-server RPC + 閾値判定) #245 (/rate-limit:codex-status skill)