プルリクエスト(PR)
概念プルリクエスト(PR)は「この変更を取り込んでほしい」という提案の仕組みです。 コードレビューを通じて品質を高め、安全に main ブランチへマージします。
プルリクエストの流れ
🌿
feature ブランチを作成
main から新しいブランチを切って作業開始。ブランチ名は機能の内容がわかるように命名する。
💻
変更を加えてコミット
機能を実装し、git add → git commit で変更を記録。こまめにコミットするのが良い習慣。
📤
GitHub に push
git push -u origin feature/xxx でブランチを GitHub に送る。
🔀
プルリクエストを作成
GitHub の画面で PR を作成。タイトル・説明・レビュアーを設定する。
👀
コードレビュー
レビュアーがコードを確認してコメントを付ける。修正依頼があれば対応してさらにコミット・push。
✅
マージ
レビューが通ったら「Merge pull request」をクリック。feature ブランチが main に取り込まれる。
PR を作成する(コマンド例)
ターミナル
# 1. feature ブランチを作成して移動 $ git switch -c feature/add-login # 2. 変更を加えてコミット $ git add . $ git commit -m "feat: ログイン画面を追加" # 3. GitHub に push $ git push -u origin feature/add-login # GitHub の画面で PR を作成するか、gh コマンドを使う場合: $ gh pr create --title "ログイン機能を追加" --body "## 変更内容\n..."
良い PR の書き方
✗ 悪い PR
タイトル
"修正"
説明
(空欄)
何をなぜ変えたかがわからない
✓ 良い PR
タイトル
feat: メールアドレスでのログイン機能を追加
説明
## 変更内容
- ログインフォームを追加
- バリデーション処理を実装
## テスト方法
1. /login にアクセス
2. メール・パスワードを入力
コードレビューでよく使うコメント
用語 用語
LGTM Looks Good To Me
問題なし、マージして OK という意味
用語
nit: nitpick
細かい指摘。直しても直さなくても良い軽微な改善提案
用語
MUST: must fix
必ず修正してほしい重要な問題
用語
Q: question
質問。修正を求めているわけではなく、理解のために聞いている
レビューコメントへの対応
ターミナル
# レビューで修正を求められた場合 # 同じ feature ブランチで修正してコミット $ git add . $ git commit -m "fix: レビュー指摘のバリデーション修正" # push すると自動的に PR が更新される $ git push To https://github.com/ユーザー名/リポジトリ名.git a1b2c3d..e4f5g6h feature/add-login -> feature/add-login