# Codex へ渡す指示書の書き方: 「シェル禁止」を書くと変更ゼロで止まる／成否は差分で判定する ## 対象 Claude Code（監督）から OpenAI Codex CLI（`codex exec`、approval=never）へ実装を委譲する運用全般。WSL 経由で Windows のリポジトリを編集する構成を含む。 ## 症状（実測） 1. 指示書の「禁止事項」に `シェル経由での実行・パイプを使わないこと` と書いたところ、Codex は「ファイルを読む手段が exec_command（シェル）しか無い」と解釈し、**確認を求めて止まり、変更ゼロ・exit 0** で終了した。approval=never なので誰も答えられない。 2. 指示書に書かれていない行番号の参照や「必ず実機で確認」を混ぜると、Codex はブラウザや外部疎通が無い環境でそのまま失敗する。 ## 原因「シェルを1層も通さずファイルで渡す」は **Claude→Codex の受け渡し経路の規約**であり、Codex 自身の作業手段を縛る意図ではない。文面をそのまま転記すると意味が変わる。 ## 指示書テンプレ（この順で書く） ``` # 共通の約束（最優先） - 作業ディレクトリ（WSL では /mnt//）。 - git commit / add / stash / branch 切替は禁止。指示書に書かれたファイル以外は触らない。外部書き込み・デプロイは禁止（監督が行う）。 - ファイル読み取り・grep・テスト実行には、あなたのシェル（exec_command）を普通に使ってよい。パイプ禁止は指示書を渡す側の規約で、あなたには適用しない。 - 確認を求めて止まらず、上記の範囲で最後まで完了させる。 - この環境にブラウザ/外部疎通は無い。実表示の確認は監督が行うので、コード読みと単体テストで決着させる。 - 完了時に「変更ファイル一覧」「追加したテストと pass/fail 件数（フルスイート込み）」「監督が確認すべきコマンドと期待値」を出力する。 # 本文（背景・対象ファイル・変更内容・テスト・禁止事項） ``` ## 成否判定（exit code を使わない） - `exit 0` でも変更ゼロのことがある。判定は **`git diff --stat` の対象ファイル** と **テストの pass/fail 件数** で行う。 - 「変更ファイル：なし」「テスト：未実行」が出力に含まれていれば失敗として再投入する。 - 再投入時は、止まった理由の1行を削除し「あなたのシェルは使ってよい」を追記するだけでよい（他は変えない）。 ## 環境の前提を指示書に書く - Codex 側（WSL/コンテナ）に Chromium・外部 DNS が無いなら、ブラウザ系の検証を指示書に入れない。入れると「導入失敗→未検証」で終わる。 - 監督側が後から実走する検証コマンドを Codex に書かせる（上記「完了時に出力」）。 ## 効果 - 初回: 変更ゼロ・2回目で完了（所要約10分の手戻り）。テンプレ適用後は1回で完了。 ---