Codex / ChatGPT実務
Codex作業用ブランチ名の考え方
Codex作業用ブランチ名を、作業内容が分かり、main直pushを避け、小さく分ける観点で整理します。
このページでわかること
- Codex作業用ブランチ名の考え方で最初に確認すること
- 初心者がつまずきやすいポイント
- CodexやChatGPTと組み合わせる時の注意
- 秘密情報をGitHubへ入れないための考え方
最初に結論
ブランチ名は、何の作業か後から見て分かる名前にするとPR確認がしやすくなります。
初心者向け説明
Codexに広い作業を頼む時ほど、作業単位を分けたブランチ名にすると、差分確認と戻し方を考えやすくなります。
向いている使い方
- 作業前に全体像を確認したい
- GitHub DesktopやCodex作業の判断材料にしたい
- 公開前の安全確認を習慣にしたい
注意が必要な使い方
- 秘密情報をGitHubへ入れない
- わからないまま削除や上書きをしない
- 本番反映前に差分と公開URLを確認する
CodexやChatGPTと組み合わせる場合
CodexやChatGPTと組み合わせる場合は、目的、対象ファイル、触らないファイル、停止条件、確認URLを先に分けて書くと、作業後の差分確認がしやすくなります。
秘密情報・APIキー・パスワード・個人情報の注意
APIキー、パスワード、秘密鍵、FTP資格情報、DB情報、メール設定、個人情報は、HTML、README、ログ、報告書、GitHubの差分に出さない前提で扱います。
名前に入れる3要素
ブランチ名で迷ったら、次の3つを順に並べるだけで実用上は十分です。凝った命名規則は、続かなければ意味がありません。
- 種類：何をするのか（fix / add / update など短い語）
- 対象：どこを触るのか（top / contact / css など）
- 日付か番号：いつのものか（20260814 など）
並べると fix-top-20260814 のようになります。ポイントは後から一覧で見て中身が思い出せることだけです。test や work のような名前は、3本目が出来た時点で区別できなくなります。
AIに任せる時ほど名前が効く理由
自分だけで作業しているうちは、名前が雑でも記憶で補えます。AIに任せ始めると、作業の本数が増えて記憶が追いつかなくなります。1日に何本も枝が増えるためです。
実務的には、依頼のたびにブランチ名を自分で指定して渡すのが確実です。任せると、内容を要約した長い名前や、英語の言い回しが揺れた名前が付きます。名前だけは自分で決め、それを指示文に含めてください。
あわせて、終わった枝を消すのも決めておきます。取り込みが済んだものを残しておくと、一覧が使い物にならなくなり、結局どれが最新か分からなくなります。
関連ページ
FAQ
Codex作業用ブランチ名の考え方は初心者でも読めますか？
はい。操作名を暗記するより、どの順番で確認すればよいかを優先して整理しています。
CodexやChatGPTを使う場合も確認は必要ですか？
必要です。自動化できる部分が増えても、差分、秘密情報、公開URLの確認は人間側で見る前提にします。
秘密情報が混ざったかもしれない時はどうしますか？
commit、push、mergeを急がず、公開範囲と履歴への混入有無を確認します。必要に応じてキーやパスワードを無効化します。
GitHubの仕様が変わることはありますか？
あります。重要な判断や最新仕様が必要な場面では、GitHub側の情報も確認してください。