まなぶちゃんがCodex作業の読み方を確認しているイラスト GPTガイドくんがCodex作業の確認ポイントを説明しているイラスト

GitHubを見る前に

コード管理と秘密情報を分けて考える

GitHubはコード履歴や差分確認に向いています。APIキー、パスワード、DB情報などを置かないこともセットで確認しましょう。

まなぶちゃん

GitHubには何でも保存していいの?

GPTガイドくん

コード管理には便利ですが、秘密情報は入れません。差分を見るページと、入れてはいけないもののページを一緒に確認しましょう。

コードを見る差分を確認する秘密情報を避ける

GitHub + Codex target

GitHubをCodexに見せる作業対象として使う方法

GitHubリポジトリをCodexの作業対象として使う時の、範囲指定と確認の基本を整理します。

このページは非公式の実践ガイドです。GitHubの画面や機能、仕様は変わる可能性があります。最新情報が必要な場合は、提供元が公開している情報も確認してください。コードやファイルの変更後は人間が確認してください。

このページで分かること

対象を絞る

Codexに見せるリポジトリやファイルを必要最小限にします。

作業ブランチを使う

mainへ直接大きな変更を入れず、差分を確認しやすくします。

報告書と差分を見る

Codex報告書とGitHub差分の両方を見て判断します。

Codexにリポジトリを見せる意味

リポジトリが整理されていると、Codexはファイル構成や変更対象を理解しやすくなります。サイト全体のコードを雑に渡すのではなく、今回の作業に必要な範囲を明確にします。

対象リポジトリは必要最小限にする

複数のサイトや複数のリポジトリを同時に混ぜると、前提がずれやすくなります。Codexに見せる対象は、今回の1作業に必要なリポジトリへ絞ります。

Codexに明記すること

項目書く理由
対象URLどの公開ページを見るかを明確にする
対象ファイルどのファイルを触るかを明確にする
触ってよい範囲作業範囲の広がりを防ぐ
触らない範囲SEOタグや共通設定の意図しない変更を防ぐ
停止条件危ない状態で作業を続けない
報告書形式確認結果を読みやすくする

Codex指示文例

このリポジトリで今回変更されたファイルを確認してください。title、canonical、robots、H1、sitemap.xml、robots.txt、ads.txt、.htaccess、外へ出せない情報に意図しない変更がないかを確認し、修正はまだ行わず報告してください。

悪い例 / 良い例

悪い例良い例
全部見て直して対象ページと対象ファイルを指定する
mainへ直接反映する作業ブランチで差分を見る
重要な接続情報を貼る必要な範囲だけ説明する
報告書を読まず次へ進む報告書と差分を見てから次へ進む

Codex用GitHubチェックリスト

  • 対象リポジトリを絞った
  • 作業ブランチを使う
  • main直変更を避ける
  • 触ってよいファイルを書いた
  • 触らないファイルを書いた
  • 差分確認を依頼した
  • 外へ出せない情報の混入を確認した
  • Codex報告書とGitHub差分を合わせて見た

やってはいけないこと

  • mainへ大きな変更を直接入れる
  • 外へ出せない情報を通常ファイルへ置く
  • AIレビューだけで完了扱いにする
  • 複数サイトやリポジトリを同じ前提で混ぜる
  • 差分や報告書を読まずに次へ進む

関連ページ