GitHub practical
CodexとGitHub連携の使い方
GitHub連携では、便利さよりも接続範囲、ブランチ、PR確認、重要情報の混入確認を先に決めます。
このページは非公式の実践ガイドです。Codexの仕様や利用条件は変わる可能性があります。最新情報が必要な場合は提供元の情報を確認してください。
CodexとGitHubを連携するとできること
CodexはGitHubの差分確認、Pull Requestレビュー、変更ファイルの整理、READMEや報告書の作成補助に使えます。実装とレビューを近い場所で扱えるため、サイト制作やコード管理と相性があります。
ただし、接続するリポジトリは必要最小限にします。すべてを接続するのではなく、今回の作業に必要な対象だけを選ぶ考え方が安全です。
PR確認で見る項目
重大な不具合、セキュリティ上の問題、SEOタグの意図しない変更、重要情報の混入、不要ファイルの混入、戻しにくい変更を優先して確認します。好みの指摘より、実害がありそうな点を先に見ます。
GitHub連携でやってはいけないこと
mainへ直接大きな変更を入れる、権限範囲を広げすぎる、接続情報を貼る、PRを読まずに取り込む、AIレビューだけで完了扱いにする、といった進め方は避けます。
悪い例 / 良い例
| 悪い例 | 良い例 |
|---|---|
| 全リポジトリを接続する | 必要なリポジトリだけ接続する |
| mainへ直接大きく反映する | 作業ブランチとPRで確認する |
| PRを読まずに取り込む | Codexレビューを人間レビューの補助にする |
差分を読む時に見る順番
変更内容が多いと、どこから見ればよいか迷います。全部を丁寧に読むより、リスクの高い順に見る方が確実です。
| 順番 | 見るもの | ここで見つかること |
|---|---|---|
| 1 | 変更されたファイルの一覧 | 頼んでいないファイルが混ざっていないか |
| 2 | 設定ファイル・共通ファイルの変更 | 影響範囲が広い変更が入っていないか |
| 3 | 削除された行 | 意図しない削除がないか |
| 4 | 追加された行 | 依頼した内容が実際に入っているか |
1番目を最初に見る理由は、ファイル一覧を見るだけで異常の大半が分かるからです。1ページの修正を頼んだのに10ファイル変わっていれば、中身を読む前に問題だと判断できます。逆に、想定どおりのファイルだけなら、あとは中身の確認に集中できます。
また、削除行を追加行より先に見るのは、消えたものの方が気づきにくいためです。追加された内容は依頼と照らせば分かりますが、消えた内容は元を知らないと気づけません。
Codexレビュー依頼文例
このPull Requestをレビューしてください。重大な不具合、セキュリティ上の問題、SEOタグの意図しない変更、重要情報の混入、不要ファイルの混入、戻しにくい変更がないか確認してください。軽微な好みの指摘ではなく、実害がありそうな点を優先してください。
やってはいけないこと
- 対象を決めずにサイト全体を一気に変える
- 重要情報や接続情報をそのまま貼る
- 同じサイト内で複数作業を重ねすぎる
- 報告書を読まずに次の作業へ進む
- AIレビューだけで完了扱いにする
確認チェックリスト
- 接続するリポジトリを絞った
- 作業ブランチを使う
- main直変更を避ける
- PR差分を確認する
- 重要情報の混入を確認する
- 不要ファイルを確認する
- 人間レビューも行う


