レッスン一覧 › Lesson 10
プルリクエストでチーム開発
clone → ブランチ → push → プルリクエスト → レビュー・マージ → pull。GitHub を使った開発の 1 サイクルを通しで体験します。
難易度: 応用 ・ 所要時間: 約 15 分 ・ 学ぶコマンド: clone / push / Pull Request / GitHub Flow
このページはブラウザ上のターミナルで実際にコマンドを打ちながら進めるレッスンです(JavaScript を有効にしてください)。手順は次のとおりです。
STEP 1: clone する
今回は、すでに GitHub 上にチームのリポジトリがある状態から始めます(右の「リモート (GitHub)」タブを見てください)。ローカルにはまだ何もありません。
リモートリポジトリを丸ごと手元に複製するのが clone です。
git clone https://github.com/team/recipe-app.git
ls
git log --onelineclone すると、origin の登録と main の upstream 設定まで自動で済んでいます(git remote -v で確認できます)。
STEP 2: 作業用ブランチを切る
チーム開発では main に直接コミットしない のが鉄則です。main は「いつでも動く状態」に保ち、変更は必ずブランチで作ってプルリクエスト経由で取り込みます。
git switch -c feature/add-recipe-listブランチ名は「何をするブランチか」が分かるように付けます。
STEP 3: 変更してコミット
レシピ一覧のファイルを作ってコミットします。
echo -e "# レシピ一覧\n\n- カレー\n- オムライス" > recipes.md
git add recipes.md
git commit -m "レシピ一覧ページを追加"git log --oneline --graph --all で、feature ブランチだけが origin/main より 1 つ先に進んでいることを確認しましょう。
STEP 4: ブランチを push する
このブランチをリモートに送ります。新しいブランチなので -u 付きで。
git push -u origin feature/add-recipe-listリモートタブに feature/add-recipe-list ブランチが現れます。main はまだ変わっていません。
STEP 5: プルリクエストを作る
プルリクエスト(PR) は「このブランチを main に取り込んでください」という 依頼 です。Git のコマンドではなく、GitHub などのサービスの機能です。
右の「リモート (GitHub)」タブで:
- Pull requests タブを開く
- New pull request を押す
- compare に
feature/add-recipe-listを選び、タイトルを付けて Create pull request
PR にはコード差分が表示され、チームメンバーがコメントを付けてレビューします。「ここはこう直したほうがいい」というやりとりを経て、OK が出たらマージします。
STEP 6: レビューの指摘を反映する
レビューで「オムライスの後にハンバーグも追加してほしい」と言われたとしましょう。PR は 同じブランチに push すれば自動で更新されます。作り直す必要はありません。
echo "- ハンバーグ" >> recipes.md
git commit -am "レビュー対応: ハンバーグを追加"
git push2 回目以降は -u なしの git push で OK です。リモートタブの PR のコミット数が 2 になります。
STEP 7: マージする
レビューで承認されたら、GitHub 上の Merge pull request ボタンでマージします。マージ作業は GitHub のサーバー上で行われ、リモートの main にマージコミットが作られます。
右の「リモート (GitHub)」タブ → Pull requests → Merge pull request を押してください。
実際の現場では、PR の作者ではなくレビュアーやリーダーがマージすることも多いです。誰が押すかはチームのルール次第です。
STEP 8: ローカルの main を最新にする
マージされたのは リモートの main です。あなたのローカルの main はまだ古いままです。
git switch main
git pull
git log --oneline --graph --all
lsrecipes.md が main に入りました。Merge pull request #1 というマージコミットも見えます。
STEP 9: 作業ブランチを片付ける
マージ済みのブランチは削除します。ローカルとリモート、両方です。
git branch -d feature/add-recipe-list
git push origin --delete feature/add-recipe-list
git branch -aこれで GitHub Flow の 1 サイクルが完了です:
ブランチを切る → コミット → push → PR → レビュー → マージ → main を pull → ブランチ削除
まとめ
GitHub Flow(このレッスンの流れ)
git switch -c feature/xxx— main からブランチを切る- コミットを積む
git push -u origin feature/xxx— ブランチを push- GitHub で Pull Request を作る
- レビュー → 指摘があれば同じブランチに push(PR は自動更新)
- Merge ボタンでマージ(リモートの main が進む)
git switch main && git pull— ローカルの main を最新に- ブランチを削除
なぜ PR を挟むのか
- レビュー: 他人の目が入ることでバグや設計ミスを早期に見つけられる
- 記録: 「なぜこの変更をしたか」の議論が残る
- 安全: main に直接 push できない設定にしておけば、事故が起きない
詳しくは プルリクエストの解説 を読んでください。 プレイグラウンドの「GitHub から clone した直後」シナリオで、何度でも練習できます。
関連する解説
- プルリクエストとチーム開発の流れ — PR とは何か、レビューの意味、GitHub Flow。
次のレッスン: 作業を一時退避する(stash)