GitHub practical

CodexとGitHub連携の使い方

GitHub連携では、便利さよりも接続範囲、ブランチ、PR確認、重要情報の混入確認を先に決めます。

このページは非公式の実践ガイドです。Codexの仕様や利用条件は変わる可能性があります。最新情報が必要な場合は提供元の情報を確認してください。

このページで分かること

最初に分かること

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差分を確認する
  • 重要情報の混入を確認する
  • 不要ファイルを確認する
  • 人間レビューも行う

関連ページ