codex-review

name

codex-review

description

agmsg の inbox を確認したうえで、新しい cmux ペインで codex (gpt-5.6-sol / reasoning effort xhigh = extra high) によるコードレビューを起動するスキル。ユーザーが「codex でレビュー」「codex review」 「5.6 sol でレビュー」「extra high でレビュー」「agmsg 起動してレビュー」「別ペインでレビューを回して」等と 言ったとき、または現在の変更を codex に第三者レビューさせたいときに必ず使う。cmux セッション内 (CMUX_SOCKET_PATH が設定されている) が前提。単に diff を自分で読むのではなく、独立した codex プロセスに 高リーズニングでレビューさせたい意図があればこのスキルを起動すること。対話型で起動し、 完了を agmsg 経由で親へ通知できる。

codex-review

現在の作業を codex に第三者レビューさせる ためのスキル。agmsg の受信箱を確認してから、 新しい cmux ペインで対話 codex を起動し、レビュープロンプトを渡して高リーズニングで 走らせる。親が agmsg team 参加済みなら、レビュー完了を親へ通知する配線も行う。

デフォルト設定:

• モデル: gpt-5.6-sol
• reasoning effort: xhigh（extra high）
• 対象: 未コミット変更（--uncommitted）
• 分割方向: right

なぜこの構成か

レビューを独立した codex プロセスに委ねると、実装した本人（＝このセッション）の思い込みに 引きずられない指摘が得られる。effort を xhigh まで上げるのは、レビューは実装より 「見落としの発見」に価値があり、多少遅くても深く考えさせる方が費用対効果が高いため。 新ペインで対話起動するのは、ユーザーが指摘を目で追いながら必要なら追質問できるようにするため。

前提

• cmux セッション内であること（CMUX_SOCKET_PATH が必要）。cmux 外ではペイン分割できない。
• codex CLI がインストール済みで PATH 上にあること。
• agmsg は任意。未参加・未インストールでもレビュー起動は止めない。

実行手順

1. agmsg の inbox を確認（非ブロッキング）

~/.agents/skills/agmsg/ が無ければ、プラグインの install.sh を一度だけ実行してブートストラップする。 その後 whoami.sh で identity を解決し、参加済みなら inbox.sh で受信箱を確認する。未参加・未インストール なら一言添えてスキップし、レビュー起動へ進む。詳細な分岐は /codex-review コマンド（commands/codex-review.md） の Step 1 と同じ。

2. codex レビューを起動

bin スクリプトを実行する。cmux ペインを分割し、そのペインで対話 codex にレビュープロンプトを送信する。

"${CLAUDE_PLUGIN_ROOT}/bin/cmux-codex-review" [引数]

主な引数（すべて任意、詳細は bin のヘッダコメント参照）:

引数	意味
right / down / left / up	分割方向（default: right）
--base <branch>	未コミット変更ではなく base ブランチとの差分をレビュー
--commit <sha>	指定コミットの変更をレビュー
-m <model> / -e <effort>	モデル / effort の上書き（default: gpt-5.6-sol / xhigh）
-- <指示>	codex へのカスタムレビュー指示
--team <team> --reviewer <name> --parent <agent>	レビュー完了の agmsg 通知配線

bin は surface= / token= を出力する。通知配線時はこの token を bin/cmux-codex-wait に渡して完了を待つ（/codex-review コマンドの Step 3 参照）。

3. 報告

bin が出力する起動サマリ（codex review 起動: <surface> (...)）を 1 行で伝える。 codex 側でレビューが流れ始めるので、このセッションでのポーリングは不要 （通知配線時は cmux-codex-wait を background task で回して wake を待つ）。

起動される codex コマンド（参考）

対話 codex にレビュープロンプトを渡して起動する（codex review サブコマンドは使わない）:

codex --sandbox workspace-write \
  -c model="gpt-5.6-sol" -c model_reasoning_effort="xhigh" \
  '未コミットの変更をレビューし、問題点・改善点を具体的に指摘せよ。'

--team/--reviewer/--parent 指定時は、プロンプト末尾に「レビュー提示後に send.sh で親へ完了通知せよ」を 注入する。親側は bin/cmux-codex-wait を background task で回して wake される。

サンドボックスを read-only にしてはいけない: 完了通知の send.sh は agmsg の SQLite DB へ INSERT する（＝書き込み）。config.toml の [sandbox_workspace_write] writable_roots（agmsg の db/teams/run）は workspace-write モードにしか適用されないため、read-only では通知が撃てなくなる。