GitHub Pull Request 完全ガイド

作業用ブランチを作るターミナル

まずmainを最新にしてから、作業用のブランチを切ります。ブランチ名は feature/内容 や fix/内容 のように目的がわかる名前にするのが慣例です。

# mainブランチを最新の状態にする
git checkout main
git pull origin main

# 作業用ブランチを作成して移動(-b は「作成して切替」)
git checkout -b feature/login-form
Switched to a new branch 'feature/login-form'

変更してコミットするターミナル

ファイルを編集したら、変更を「コミット」として記録します。コミットは意味のある単位で小さく刻むのがレビューしやすさのコツです。

# 変更されたファイルを確認
git status

# 変更をステージング(コミット対象に載せる)
git add src/components/LoginForm.tsx

# メッセージ付きでコミット
git commit -m "ログインフォームにバリデーションを追加"

GitHubへプッシュするターミナル

手元(ローカル)のブランチをGitHub(リモート)へ送信します。初回プッシュ時は -u を付けてリモートと紐付けます。

git push -u origin feature/login-form
...
remote: Create a pull request for 'feature/login-form' on GitHub by visiting:
remote:   https://github.com/mirise/app/pull/new/feature/login-form

プッシュ直後の出力に、PR作成ページへのURLが親切に表示されます。これをクリックするのが最短ルートです。

PRを作成するGitHub画面

GitHubのリポジトリを開くと、プッシュしたブランチについて黄色い帯で 「Compare & pull request」 ボタンが表示されます。これを押すとPR作成画面へ。

作成画面で入力するのは主に3つです。

ベースブランチが base: main ← compare: feature/login-form になっていること(=mainに対してこのブランチを取り込む方向)を確認し、「Create pull request」を押せば完了です。

レビューを受けて修正するGitHub画面ターミナル

レビュアーはPRの 「Files changed」 タブで差分(削除行=赤、追加行=緑)を確認し、気になる行にカーソルを合わせて青い＋ボタンを押すと、その行に直接コメントを付けられます。

レビュアーは最後に「Review changes」から3種類の判定を出します。

修正を求められたら、同じブランチ上で修正コミットを積んでプッシュするだけ。PRに自動で反映されます。新しいPRを作り直す必要はありません。

# 指摘を修正したら、同じブランチにコミット&プッシュ
git add src/utils/validation.ts
git commit -m "メール形式のバリデーションを追加(レビュー指摘対応)"
git push

対応が済んだ指摘は、コメントスレッドの「Resolve conversation」を押して解決済みにします。全スレッドの解消がマージ条件になっているチームが多いです。

マージして後片付けGitHub画面

Approveが揃ったら、PR画面下部の緑の 「Merge pull request」 ボタンでmainへ合流させます。マージ方式は3種類から選べます。

マージ後は「Delete branch」ボタンで役目を終えたブランチを削除し、手元も掃除しておきます。

git checkout main
git pull origin main          # マージ結果を手元に反映
git branch -d feature/login-form  # ローカルのブランチを削除