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

読み方の1ポイント

目的、対象、確認項目を分けて読む

このページでは、Codex作業を安全に進めるための考え方を整理します。実行前に、対象、触らないもの、確認項目を分けて見ると迷いにくくなります。

まなぶちゃん

このページも、全部を一度に覚えないとダメ?

GPTガイドくん

必要なところから読めば大丈夫です。作業前に対象と停止条件、作業後に確認項目を見ると安全です。

目的を見る注意点を見る確認する

Codex practical hub

CodexとGitHubの作業フロー

CodexとGitHubを組み合わせて、リポジトリ接続、作業ブランチ、Pull Request確認、報告書整理まで安全に進めるための中継ページです。

このサイトは、CodexやGitHubを実務で使うための非公式の実践ガイドです。機能、料金、利用条件、連携条件は変わる可能性があるため、最新情報が必要な場合は提供元の情報を確認してください。

このページで分かること

CodexとGitHubを組み合わせると、リポジトリ内のファイル確認、差分確認、Pull Requestレビュー、作業報告書作成を進めやすくなります。ただし、接続範囲や権限を広げすぎず、秘密情報をリポジトリに置かないことが前提です。

CodexのGitHub連携やPull Requestレビュー関連の機能は、環境や時期によって変わる可能性があります。最新情報が必要な場合は、提供元が公開している情報を確認してください。

リポジトリ接続前に確認すること

接続前には、対象リポジトリ、public/privateの違い、個人用と業務用の分離、秘密情報の混入候補、作業ブランチ運用を確認します。全リポジトリを前提にせず、必要な対象だけに絞ります。

作業ブランチとPRで確認する

本番相当のmainへ直接大きな変更を入れるのではなく、作業ブランチを使い、Pull Requestで差分を確認します。Codexには、差分の概要、重大な不具合、不要ファイル、SEOタグ変更、秘密情報の混入候補を優先して見てもらいます。

ChatGPTでPR説明を整理する

ChatGPTは、Issue文、PR本文、確認チェックリスト、リリース前メモの整理に向いています。Codexが見た差分や報告書を、人間が読みやすい形に整える補助として使えます。

Codex × GitHub作業フローテンプレート

対象リポジトリと作業ブランチを前提に、今回のPull Requestを確認してください。重大な不具合、SEOタグの意図しない変更、不要ファイル、秘密情報の混入候補、戻しにくい変更を優先して報告してください。修正はまだ行わず、指摘と確認結果だけ出してください。

やってはいけないこと

  • 全リポジトリ接続を前提にする
  • mainへ直接大きな変更を入れる
  • 秘密情報をリポジトリに置く
  • AIレビューだけで完了にする
  • PR差分を見ずに反映する
  • 提供元情報を確認せず最新仕様を断定する

確認チェックリスト

  • 接続範囲が必要最小限
  • 秘密情報の混入候補を確認
  • 作業ブランチを使う
  • PRで差分を確認
  • Codexレビューを補助として使う
  • ChatGPTで説明文を整理
  • 人間が最終確認する

関連ページ

図表と具体例で見る実務ポイント

このページで分かること

  • CodexとGitHubの作業順
  • リポジトリ接続前の確認
  • PRで差分を見る理由
  • ChatGPTで説明文を整理する流れ
  1. 1接続するリポジトリを絞る
  2. 2秘密情報がないか確認する
  3. 3作業ブランチを使う
  4. 4PRで差分を出す
  5. 5Codexにレビュー観点を頼む
  6. 6人間が最終確認する
場面確認すること
接続前必要最小限のリポジトリだけにする
作業中対象外ファイルに触れていないかを見る
PR確認SEOタグ、秘密情報、戻しにくさを見る
merge前人間レビューと戻し方を確認する
このリポジトリで今回触ったファイルを確認し、触ってはいけないファイルに変更がないか、READMEや公開HTMLに秘密情報が混じっていないかを確認してください。

この場合は止める

  • 対象ファイルが分からない
  • HTTP 500またはHTTP 404が出た
  • SEOタグ変更が必要になった
  • .htaccess変更やDB変更が必要になった
  • 秘密情報が関係しそう
  • 共通パーツを大きく変える必要がある
  • 未作成URLへリンクしそう
  • GitHub権限やSecrets変更が必要になった

Codexの機能、料金、利用条件は変わる可能性があります。最新情報が必要な場合は提供元の情報を確認し、コードやファイルの変更後は人間が確認してください。秘密情報や認証情報は渡さず、重要な判断は人間が行います。AIレビューは人間レビューの補助として扱います。

GitHubの使い方シリーズも読む

この内容に関連して、GitHubの入門からCodex・ChatGPT連携までを段階別に整理しています。

GitHubを実務でどう使うか

GitHubをコードの図書館から、変更履歴、差分確認、Codex作業対象、公開前チェックの記録場所へ広げて使うための具体例です。

GitHubをCodexで使える作業場所に育てる

GitHubを接続しただけで終わらせず、リポジトリ整理、ブランチ、Pull Request、AGENTS.md、Actionsを段階的に整える考え方を確認できます。