はじめに

プルリクエスト（Pull Request、略してPR）は、GitHubのコラボレーション機能の中核です。 この章では、プルリクエストの概念から実践的な使い方、そして様々なマージ戦略まで、 チーム開発に必要な知識を包括的に学びます。

3.1 プルリクエストの概念と重要性

プルリクエストとは

プルリクエストは、あるブランチの変更を別のブランチにマージするための提案です。 以下のような特徴があります：

プルリクエストのワークフロー

プルリクエストの利点

• コード品質の向上 - 複数の目によるレビューでバグや問題を早期発見
• 知識共有 - チーム全体でコードベースの理解を深める
• 履歴の透明性 - なぜその変更が行われたかの文脈を保存
• 継続的インテグレーション - 自動テストやビルドとの統合

3.2 プルリクエストの作成

準備作業

プルリクエストを作成する前に、以下の準備を行います：

# 1. フィーチャーブランチで作業
git checkout -b feature/user-authentication

# 2. 変更を実装してコミット
git add .
git commit -m "feat: ユーザー認証機能を実装"

# 3. リモートにプッシュ
git push -u origin feature/user-authentication

# 4. メインブランチの最新変更を取り込む（推奨）
git fetch origin
git merge origin/main
# またはリベース
git rebase origin/main

GitHub上でのプルリクエスト作成

効果的なプルリクエストの書き方

プルリクエストのテンプレート活用

リポジトリに`.github/pull_request_template.md`を作成することで、テンプレートを自動適用できます：

## 概要


## 変更内容

- 
- 

## 関連Issue

Closes #

## テスト

- [ ] ユニットテスト追加/更新
- [ ] 統合テスト確認
- [ ] 手動テスト完了

## レビュー観点


## その他

3.3 コードレビューのベストプラクティス

レビュアーの心得

GitHubのレビュー機能

GitHubは強力なコードレビュー機能を提供しています：

function calculateTotal(items) {
    let total = 0;
    // コメント: forEachの方が読みやすいかもしれません
    for (let i = 0; i < items.length; i++) {
        total += items[i].price;
    }
    return total;
}

効果的なレビューコメントの例

レビュー対応のベストプラクティス

3.4 マージ戦略の詳細

3つの主要なマージ方法

GitHubでは3つのマージ方法を選択できます。それぞれの特徴と使い分けを理解しましょう：

     feature
    ●───●───●
   ╱         ╲
●───●───●───●───●  main
              ↑
         マージコミット

git checkout main
git merge --no-ff feature-branch

     feature
    ●───●───●
   ╱
●───●───●───●───●  main
              ↑
         全てを1つのコミットに

git checkout main
git merge --squash feature-branch
git commit -m "feat: 新機能の追加"

Before:      feature
          ●───●───●
         ╱
●───●───●           main

After:
●───●───●───●───●───●  main
         ↑ ↑ ↑
    リベースされたコミット

git checkout feature-branch
git rebase main
git checkout main
git merge --ff-only feature-branch

マージ戦略の選択ガイド

3.5 コンフリクト解決の実践

コンフリクトが発生する理由

コンフリクトは、同じファイルの同じ部分を複数の人が異なる方法で変更した場合に発生します。 これは正常な開発プロセスの一部であり、適切に解決することが重要です。

コンフリクトの解決手順

# プルやマージ時にコンフリクトが発生
git pull origin main
# Auto-merging index.js
# CONFLICT (content): Merge conflict in index.js
# Automatic merge failed; fix conflicts and then commit the result.

# コンフリクトしているファイルを確認
git status
# Unmerged paths:
#   both modified:   index.js

function calculatePrice(quantity, price) {
<<<<<<< HEAD
    // 自分の変更
    const tax = 0.08;
    return quantity * price * (1 + tax);
=======
    // 他者の変更
    const tax = 0.10;
    const discount = quantity > 10 ? 0.1 : 0;
    return quantity * price * (1 + tax) * (1 - discount);
>>>>>>> feature-branch
}

function calculatePrice(quantity, price) {
    // 両方の変更を統合
    const tax = 0.10; // 新しい税率を採用
    const discount = quantity > 10 ? 0.1 : 0; // 割引機能も採用
    return quantity * price * (1 + tax) * (1 - discount);
}

# 解決したファイルをステージング
git add index.js

# コミットして解決を完了
git commit -m "fix: マージコンフリクトを解決"

# またはマージを続行
git merge --continue

GitHubでのコンフリクト解決

GitHubのWebインターフェースでも簡単なコンフリクトは解決できます：

1. プルリクエストページで「Resolve conflicts」ボタンをクリック
2. エディタでコンフリクトを解決
3. 「Mark as resolved」をクリック
4. 「Commit merge」で変更を保存

コンフリクトを避けるベストプラクティス

3.6 高度なプルリクエスト機能

ドラフトプルリクエスト

作業中の変更を早期に共有し、フィードバックを得るための機能です：

• WIP（Work In Progress）の状態を明示
• 自動的にマージがブロックされる
• 早期のフィードバックが可能
• 「Ready for review」で通常のPRに変換

プルリクエストの自動化

Settings → Branches → Add rule
- Require pull request reviews before merging
- Require status checks to pass before merging
- Require branches to be up to date before merging
- Include administrators
- Restrict who can push to matching branches

name: PR Checks
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run tests
        run: |
          npm install
          npm test
      
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run linter
        run: |
          npm install
          npm run lint

プルリクエストのリンク機能

3.7 まとめと次のステップ

この章で学んだこと

• プルリクエストの概念と重要性
• 効果的なPRの作成方法
• コードレビューのベストプラクティス
• 3つのマージ戦略とその使い分け
• コンフリクト解決の実践
• 高度なPR機能の活用

チェックリスト

理解度チェック

次章への準備

第4章では、GitHubのIssue機能とプロジェクト管理について学びます。 プルリクエストと組み合わせることで、より効果的なプロジェクト管理が可能になります。