このページで整理すること
- GitHub repoとは何か
- Codexにrepoを扱わせる時の考え方
- 触るファイルと触らないファイル
- branch、diff、PRの確認
- private repositoryとSecretsの注意
Codexでできること
Codexは、GitHub作業で確認したい観点を整理したり、PRやdiffを見る時のチェックリストを作ったり、release noteを読む時の確認項目を並べたりする補助に使えます。どのrepoを対象にするか、どのファイルを触るか、どのファイルを触らないかを文章にしてから渡すと、作業範囲が明確になります。
Codexだけに任せないこと
CodexがGitHubを何でも自動操作できるとは考えません。PRのマージ、releaseの採用、private/publicの判断、Secretsや.envの扱い、公式情報の確認は人間が行います。特に認証情報やトークンを貼り付けて相談する使い方は避けてください。
GitHubで確認すること
GitHubでは、repository、branch、diff、PR、release、private/public、Secretsの扱いを分けて見ます。Codexの報告だけで終わらせず、GitHub上の差分と公開範囲を確認してから次の作業に進みます。
| 項目 | 見ること | 注意点 |
|---|---|---|
| repository | 作業対象の場所 | repoを間違えない |
| branch | 作業ブランチ | 本番反映前に確認 |
| file | 変更対象ファイル | 触らないファイルを明記 |
| diff | 変更差分 | 想定外の差分がないか |
| PR | 変更確認 | 人間がレビューする |
リポジトリの分け方
複数のサイトや案件を扱う場合、1つにまとめるか分けるかで運用が変わります。判断材料を整理します。
| 1つにまとめる | 案件ごとに分ける | |
|---|---|---|
| 管理する数 | 少なくて済む | 数が増える |
| 取り違えのリスク | 低い（1つしかない） | あるので対象の明示が要る |
| 公開範囲の設定 | 全体で1つの設定になる | 案件ごとに変えられる |
| 他人に渡す時 | 関係ない部分も渡ることになる | 必要な範囲だけ渡せる |
| 問題が起きた時 | 影響範囲が全体に及ぶ | その案件に収まる |
判断の目安は「他人に渡す可能性があるか」です。渡す可能性があるなら分けておくべきで、後から分けるのは手間がかかります。個人のサイトだけなら、まとめておく方が管理は楽です。
作った後に決めておくこと
リポジトリを作った直後に決めておくと、後から困りません。
- 公開範囲：privateで始めるのが無難です。publicへ変えるのは簡単ですが、逆は取り返しがつきません。
- 入れないファイルの決め方：認証情報を含むファイルや、一時的な作業ファイルは最初から対象外にします。
- 何を管理するか：サイト全体か、一部だけか。範囲を絞るほど扱いは簡単になります。
- 公開サーバーとの関係：記録することと公開することは別の操作です。混同すると「記録したのに反映されない」状態になります。
2番目は最初に決めておくべき項目です。一度入れてしまった認証情報は、後からファイルを消しても履歴に残り続けます。入れない仕組みを先に作る方が、後始末より簡単です。
秘密情報・公開範囲の注意
private repositoryでも秘密情報を入れてよいわけではありません。APIキー、トークン、SSHキー、.env、顧客情報、社内情報、サーバーパス、認証情報は公開・共有前に伏せます。GitHub公式ロゴ、Octocat、公式画像もこのページ群では使いません。
関連ページ
FAQ
CodexにGitHubのトークンを貼ってもいいですか？
貼らないでください。Personal Access Token、APIキー、Secret、SSHキー、認証情報はCodexに入力しない方が安全です。
private repositoryなら秘密情報を入れても安全ですか？
いいえ。privateでも共有範囲や権限、履歴、誤公開のリスクがあります。Secretsや.envの中身をそのまま置かないよう確認します。
CodexだけでPRをレビューできますか？
Codexは確認観点の整理に使えますが、最終レビューやマージ判断は人間が行います。