- このページで分かること
- 報告書に入れる項目
- 良い報告書と悪い報告書
- 報告書テンプレート
- Codex指示文例
- 確認チェックリスト
- 関連ページ
このページで分かること
Codexに作業を依頼する時は、作業後の報告書形式も指定しておくと安全です。報告書が薄いと、何を変えたのか、何を確認したのか、未確認事項があるのかを判断しづらくなります。
報告書に入れる項目
- 作業名
- モード
- 今回やったこと
- 変更したファイル
- 作成したファイル
- 触っていないファイル
- 確認結果
- 未確認事項
- 停止条件該当
- 次にやること
- 実践ログ化候補
良い報告書と悪い報告書
良い報告書は、変更ファイル、確認結果、触っていないファイル、未確認事項が分かれています。悪い報告書は「完了しました」だけで、確認根拠がありません。公開前チェックでは、HTTP 200やnoindexなしなど、具体的な確認結果が必要です。
実際の記入例で比べると違いが分かりやすくなります。
| 項目 | 悪い記入例 | 良い記入例 |
|---|---|---|
| 今回やったこと | 「ページを修正しました」 | 「/about/ のtitleタグを変更(旧→新の両方を記載)」 |
| 確認結果 | 「問題ありません」 | 「公開URLで200確認、新titleの表示確認、noindexなし」 |
| 触っていないファイル | (記載なし) | 「robots.txt・sitemap.xml・他ページには触れていない」 |
| 未確認事項 | (記載なし) | 「スマホ実機での表示は未確認」 |
特に価値が出るのは「未確認事項」の欄です。ここが空欄の報告書は「全部確認した」のか「確認していないことを書き忘れた」のか区別がつきません。「未確認事項:なし」と明記させることと、空欄のまま受け取ることは別物です。指示の時点で「未確認事項がない場合も『なし』と書く」と指定しておくと、この曖昧さが消えます。
報告書テンプレート
━━━━━━━━━━━━━━━━
報告書
━━━━━━━━━━━━━━━━
作業名:
モード:
今回やったこと:
変更したファイル:
作成したファイル:
触っていないファイル:
確認結果:
未確認事項:
停止条件該当:
次にやるべきこと:
━━━━━━━━━━━━━━━━
実践ログ化候補
━━━━━━━━━━━━━━━━
転用可否:
理由:
記事タイトル案:
一般化した作業内容:
次回使える指示文テンプレート:
確認チェックリスト:Codex指示文例
作業後は、作業名、モード、今回やったこと、変更したファイル、作成したファイル、触っていないファイル、確認結果、未確認事項、停止条件該当、次にやるべきこと、実践ログ化候補を含めて報告してください。確認チェックリスト
- 変更ファイルが分かる
- 作成ファイルが分かる
- 触っていないファイルが分かる
- HTTP確認がある
- SEOタグ確認がある
- 未確認事項がある場合は明記されている
- 停止条件該当が書かれている
報告の形を AGENTS.md に書いておく
毎回の指示文に報告の項目を書くと、書き忘れた回だけ報告が薄くなります。公式の説明では、Codex は作業を始める前に AGENTS.md というファイルを読みます。報告の項目をここに書いておけば、指示文に書き忘れても同じ形で報告が返ってきやすくなります。
| 置く場所 | 効く範囲 | 向いている書き方 |
|---|---|---|
Codex のホーム(既定は ~/.codex)の AGENTS.md | どのリポジトリで開いても読まれる | 報告の項目など、いつも同じにしたい決まり |
リポジトリの根の AGENTS.md | そのリポジトリの作業 | このサイトでは「公開URLの200」「noindexなし」を確認結果に必ず書く、など |
作業するフォルダに近い AGENTS.md | そのフォルダの下の作業 | 公開フォルダだけの決まり。近いフォルダのものほど後ろに付き、先の決まりより優先されます |
公式の説明では、Codex は1つのフォルダから1ファイルだけを読み、根から今いるフォルダへ向けて順につなげます。つなげた大きさが既定で 32 KiB(project_doc_max_bytes)に達すると、それより先のファイルは足されません。報告の項目は短く、箇条書きで書くのが安全です。
書いた例:
## 報告のしかた
- 作業後は次の順で報告する:今回やったこと/変更したファイル/作成したファイル/触っていないファイル/確認結果/未確認事項/次にやること
- 未確認事項がないときも「なし」と書く
- 確認結果には、確かめた URL と結果(200・noindexなし など)を書く
読まれているかは、公式の例と同じく codex --ask-for-approval never "Summarize the current instructions." を流すと確かめられます。公式の説明では、Codex は読み込んだ AGENTS.md の項目を挙げてから作業の提案に入ります。報告の項目が挙がらないときは、置き場所かファイル名を見直します。
出典:OpenAI 公式「Custom instructions with AGENTS.md」(2026年11月6日に確認)。画面やコマンドは変わることがあるため、使う前に公式のページをご確認ください。
報告を、後から取り出しやすい形で受け取る
Codex を codex exec で動かすと、途中の経過は標準エラー出力に流れ、標準出力には最後の返事だけが出ます。この最後の返事を、報告書として保存する方法です。
| したいこと | 付けるもの | 結果 |
|---|---|---|
| 最後の返事をファイルに残す | -o(--output-last-message)に保存先を渡す | 返事がファイルに書かれ、画面にも出る |
| 返事の形を決めておく | --output-schema に JSON Schema のファイルを渡す | 決めた項目に沿った JSON で返る |
| 途中の出来事も残す | --json | コマンドの実行やファイルの変更などが、1行ずつの JSON で出る |
公式の例は、required で入れる項目を決める書き方です。例の項目は project_name などですが、ここに「変更したファイル」「確認結果」「未確認事項」のような名前を当てはめれば、項目が抜けた報告を受け取りにくくなります(当てはめ方は編集部の例です)。
既定の codex exec は読み取り専用で動きます。ファイルを変えさせるときは --sandbox workspace-write を付けます。また Git のフォルダの中で動かす決まりで、外す場合は --skip-git-repo-check が要ります。
出典:OpenAI 公式「Non-interactive mode」(2026年11月6日に確認)。
「変更したファイル」の欄は、画面の差分と照らす
報告に書かれた「変更したファイル」と、アプリの差分の画面が一致しないことがあります。公式の説明では、プロジェクトが Git で管理されていると、差分の画面は Git の状態をもとに表示されるため、Codex が編集していない変更も並びます。
| 見たいもの | 公式の説明での切り替え | 報告との照らし方(編集部の目安) |
|---|---|---|
| 直前の1回で Codex が変えた分 | 差分の画面を Last turn の表示にする | 報告の「変更したファイル」と同じ並びか見る |
| まだステージしていない変更 | ステージ済みと未ステージを切り替える | 自分の書きかけが報告に混ざっていないか見る |
| ブランチ全体の違い | main と比べる表示にする | 何回分かの報告をまとめて見直すときに使う |
報告に無いファイルが Last turn に出ていたら、そのファイルについて「なぜ変えたか」を聞き直してから次へ進みます。逆に、報告にあるのに Last turn に出ないファイルは、前の回の変更か、書いたつもりで書けていないかのどちらかです。
出典:OpenAI 公式「Troubleshooting」(2026年11月6日に確認)。右端の列と最後の段落は当サイトの目安です。
編集部が作業報告に残した実測項目
編集部では2026年11月8日、Codex CLI 0.167.0をnpmで入れ、ChatGPT Plusでログインしました。画面上のプラン表示はplusでした。実行環境は、読むだけのread-onlyと、指定した作業フォルダだけを書き換えられるworkspace-writeに分け、後者は--cdで対象フォルダを決めました。0時から11時台までの呼び出しは94回で、1回の中央値は27.6秒でした。
作業内容は、ほかのAIが挙げたウェブページの校正指摘について、Codexにサイト内のファイルを開かせ、指摘箇所が実在するかを判定させることでした。その結果、21の会場ページで出典の会場名が事実と合わない文を見つけ、修正しました。昼前には5時間枠を99%まで使い、利用上限の表示後は2026年11月8日14時すぎまで使えませんでした。この時点の週の枠は15%でした。94回のうち修正を伴った回数と各回の所要時間は記録にないため不明です。
