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 自身の作業手段を縛る意図ではない。文面をそのまま転記すると意味が変わる。

指示書テンプレ（この順で書く）

# 共通の約束（最優先）
- 作業ディレクトリ <repo>（WSL では /mnt/<drive>/<path>）。
- 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回で完了。