Codex GitHub diff
Codexの変更差分をGitHubで見るには
差分は、Codexがどこをどう変えたかを赤と緑で見る確認画面です。
まず一言でいうと
Codexで作業し、GitHubで確認します
差分は、Codexがどこをどう変えたかを赤と緑で見る確認画面です。
| 用語 | 一言でいうと | 何を見るか |
|---|---|---|
| Codex | 作業を頼むAI | ファイル修正・確認・報告 |
| Git | 変更履歴の仕組み | commit・branch・差分 |
| GitHub | 変更を保管して見る場所 | PR・diff・履歴 |
| PR | 変更を入れる前の確認場所 | 内容・差分・未確認事項 |
| diff | どこが変わったか | 追加行・削除行・変更ファイル |
このページで整理すること
Codexで作業した後に、GitHubやGitで何を確認すればよいかを初心者向けに整理します。GitHub公式やOpenAI公式の案内ではなく、実務で事故を避けるための確認メモとして読んでください。
Codexでできること
- なぜ変えたかを報告する
- 変更範囲を説明する
- 公開前チェックを補助する
- 余計な変更があれば止める
GitHub / Gitで確認すること
- 追加行
- 削除行
- 変更ファイル
- 想定外ファイル
- 戻す対象
実際の作業フロー
- Codexに作業を頼む対象URL、対象ファイル、やること、やらないことを明確にします。
- 変更ファイルを見る作業対象以外のファイルが変わっていないか確認します。
- GitHubで差分を見る追加行、削除行、変更理由を確認します。
- Secretsや余計なファイルを確認するAPIキー、認証情報、ログ、.env が混ざっていないか見ます。
- PR本文を読む未確認事項、停止条件、確認結果を把握します。
- 人間がmerge判断するmain直pushや勝手なmerge、本番deployは軽く扱いません。
差分で見つかる問題の種類
差分確認は「間違いを探す」作業ですが、探すものには種類があります。種類を知っていると、見るべき場所が絞れます。
| 種類 | 差分のどこに現れるか | 見つけ方 |
|---|---|---|
| 頼んでいない変更 | 変更ファイル一覧 | 依頼した対象と一覧を突き合わせる。最初にやる |
| 意図しない削除 | 削除行(マイナス側) | 消えた行が本当に不要だったか見る |
| 依頼内容の抜け | 追加行(プラス側) | 頼んだ内容が実際に入っているか確認 |
| 秘密情報の混入 | 追加行の中身 | キーやパスワードらしき文字列がないか |
| 巻き込み事故 | 差分に現れない | 差分では分からない。公開URLで実物を見る |
最後の行が重要です。差分は「変更した内容」しか映しません。正しく変更した結果、別の場所の表示が崩れるといった副作用は差分には現れません。差分確認と公開URLでの目視は、どちらも必要で互いの代わりにはなりません。
差分が大きすぎて読めない時
変更が数十ファイルに及ぶと、丁寧に読むこと自体が現実的でなくなります。その場合は読み方を変えます。
- まずファイル一覧だけ見る:中身を読む前に、想定外のファイルが混ざっていないかを確認します。ここで異常が見つかれば、中身を読む必要はありません。
- 設定ファイルを優先して読む:本文の変更より、設定の変更の方が影響が広く、間違いの代償も大きくなります。
- 削除行だけ先に通して見る:追加は依頼と照らせば分かりますが、削除は元を知らないと気づけません。
- 次からは作業を分割する:差分が読めない規模の依頼は、そもそも分けるべきだったというサインです。
最後の項目が本質的な対策です。「確認できる量」が依頼できる量の上限だと考えてください。作れる量ではなく、確かめられる量が基準になります。
差分を読む順番|全行読まない前提で、何を必ず見るか
AIの変更は差分が大きくなりがちで、「全行読む」は現実には続きません。続かない精読より、順番を決めた抜き取りのほうが事故を防ぎます。実際に使っている順番です。
- 1. 中身より先に、ファイル一覧だけを見る。「触るはずのないファイルが混ざっていないか」はここで分かります。1行も読まずに検出できる最重要チェックです。
- 2. 想定外のファイルがあれば、そこで止める。中身の良し悪しを検討する前に、なぜ触ったのかを確認します。理由が説明できない変更は差し戻します。
- 3. 意図したファイルは「削除が混ざっていないか」を先に見る。追加だけのはずの作業に削除行が混ざっているのが、事故の典型です。
- 4. 数字・URL・パス・日付だけは1文字単位で精読する。文章の言い回しと違い、ここの1文字ミスはそのまま実害になります。精読の対象をここに絞ります。
- 5. 同じ形の変更が大量にある時は、先頭の数件と途中の数件を抜き取る。一括置換系は全件が同じ形のはずなので、抜き取りで形が揃っていれば残りも信用できます。揃っていなければ全件見ます。
意図しない変更の典型と、気づき方
差分レビューで実際に引っかかるのは、凝ったバグより次のような機械的な混入です。それぞれ「どこで気づけるか」が決まっています。
| 典型 | 何が起きるか | 気づき方 |
|---|---|---|
| 改行コードの一括変更 | 1文字も変えていないのに全行が差分になる | 差分の行数がファイルの行数とほぼ同じ。この形を見たら中身でなく改行コードを疑う |
| フォーマッタの巻き込み | 依頼と無関係のインデント・空白の変更が大量に入る | 差分にスペースだけの行が並ぶ。依頼した変更が差分のどこにあるか探せなくなったら、これ |
| 無関係ファイルの巻き込み | 「ついでに整えました」型の変更が別ファイルに入る | 手順1のファイル一覧で検出。中身を読む必要はない |
| 削除の混入 | 追加を頼んだのに既存の行が消えている | 削除行数を見る。追加系の作業で削除が2桁あれば必ず中身を確認 |
| 生成物・ロックファイルの混入 | 自動生成されるファイルがコミットに入る | ファイル一覧に自分で書いた覚えのない名前がある |
共通するのは、ほとんどがファイル一覧と行数の形だけで検出できることです。差分レビューの負担が重いと感じたら、読み方をこの型に変えるだけで、かかる時間は減り、見落としも減ります。
やってはいけないこと
差分を見ずに公開やmergeへ進めると、関係ないファイル変更や秘密情報混入に気づけないことがあります。
- GitHub上の重い操作は、人間が範囲と結果を確認してから判断する。
- main直push、勝手なmerge、本番deployを軽作業扱いしない。
- APIキー、トークン、秘密鍵、GitHub Secrets、認証情報を本文に出さない。
- DB、cron、.htaccess、AdSense、Search Console確認タグ、robots.txt、ads.txtを触らせない。
- 成果や検索順位、安全性を約束する表現を書かない。
| 場面 | 見ること | やらないこと |
|---|---|---|
| 外出先 | 報告書、URL、差分 | 本番deploy |
| スマホ | 表示確認、軽い指示 | merge判断の即決 |
| 別PC | PR確認、差分確認 | 認証情報の表示 |
| 移動中 | 次の指示整理 | 危険ファイル変更 |
関連ページ
FAQ
Codexにcommitやpushを任せていいですか?
作業範囲やチームルールによります。初心者向けには、まず差分とPRを人間が確認し、main直pushや勝手なmergeを避ける方が安全です。
GitHub Secretsの値をCodexに貼ってもいいですか?
貼らないでください。Secrets、APIキー、トークン、秘密鍵、認証情報は具体値を出さず、必要になった時点で停止条件にします。
スマホでPRをmergeしてもいいですか?
スマホでは差分や報告の確認までに留め、mergeやdeployのような重い判断はPCで落ち着いて確認するのが安全です。
Gitの危険なコマンドも覚える必要がありますか?
初心者ページでは危険なコマンド例を扱いません。戻し作業が必要な時は、対象を確認して別作業として慎重に進めます。
GitHub IssueでCodex作業を管理する
Codex作業をIssueに整理すると、作業依頼、停止条件、PR差分、報告書、未完了タスクをつなげて確認しやすくなります。秘密情報はIssueに書かず、PRや報告書で差分を確認します。
CodexとClaude Codeを勝ち負けではなく使い分ける
CodexとClaude Codeは、どちらが上かではなく、Web制作、GitHub作業、指示書、報告書、安全確認のどこで使うかを分けて考えると実務で扱いやすくなります。
差分がゼロ・差分が出ない時の確認
変更したはずなのに差分が出ない場合、コードの問題ではなく作業場所の問題であることがほとんどです。
- 別のフォルダを見ている:似た名前のコピーが複数あると起きます。作業したフォルダの絶対パスと、確認しているフォルダのパスを突き合わせます
- 保存されていない:エディタ側で未保存のまま差分を見ている状態です
- 無視設定に入っている:変更したファイルが追跡対象から外れていると、変更しても差分に出てきません。設定ファイルや環境ファイルでよく起きます
- ブランチが違う:作業したブランチと確認しているブランチが別です
「差分が出ない」と「変更されていない」は別なので、まずファイルを直接開いて中身が変わっているかを見るのが最短です。中身が変わっているなら上の4つのどれかです。
Codexに差分を説明させる時の頼み方
差分を自分で読む前に、Codex側に説明させると読む負担が下がります。ただし頼み方で有用性が変わります。
効かないのは「差分を説明して」です。変更内容をなぞった説明が返ってくるだけで、差分を読むのと手間が変わりません。効くのはリスクの観点を指定する形です。
- 「この差分で、意図せず動作が変わる箇所があれば挙げて」
- 「今回の依頼と関係のない変更が混ざっていないか確認して」
- 「この変更で他のページに影響が出る可能性がある箇所は?」
そのうえで、挙がった箇所だけ自分で現物を確認します。指摘が無くても最終確認は人がやる前提は変わりませんが、見る場所の当たりが付くだけで所要時間が大きく減ります。
関連クエリの戻り導線
関連ページからCodex親ハブと勝ちページへ戻す
このページで個別テーマを確認した後は、Codex親ハブ、status、ホームページ制作、Google Drive、GitHub、公開前チェックへ戻ると、Search Consoleで反応している主要テーマを一続きで読めます。