プルリクエスト作成

Claude Code を使って、変更内容の要約からプルリクエスト（PR）の作成、レビューまでを効率的に行う方法を学びます。

プルリクエストとは

プルリクエスト（PR）は、コードの変更を チームに共有してレビューしてもらう仕組み です。

作業ブランチで開発
        ↓
変更内容をコミット
        ↓
プルリクエストを作成  ← Claude がここを手伝う
        ↓
チームメンバーがレビュー
        ↓
メインブランチにマージ

Claude Code の PR 作成機能

Claude Code は、Git の変更履歴を分析して、PR のタイトルや説明文を自動生成できます。手動で書くよりも、変更内容を正確かつ網羅的に記述してくれます。

PR 作成の基本フロー

Step 1: 変更内容を要約する

まず、Claude に現在の変更内容を要約してもらいましょう。

# 現在の変更内容を確認
> 現在の変更内容を要約してください

# 特定のブランチとの差分を確認
> main ブランチとの差分を要約してください

Claude は以下のような情報を整理してくれます。

要約項目	内容
変更の概要	何を変更したかの簡潔な説明
変更ファイル一覧	変更・追加・削除されたファイル
変更の目的	なぜこの変更が必要なのか
影響範囲	この変更が他の機能に与える影響

Step 2: プルリクエストを作成する

# PR を作成してもらう
> この変更内容でプルリクエストを作成してください

# 詳細な指示をする場合
> この変更内容で PR を作成してください。
  - タイトルは日本語で
  - 変更理由と影響範囲を含めて
  - テスト方法も記載してください

PR の作成方法

Claude Code は gh コマンド（GitHub CLI）を使って PR を作成します。GitLab を使っている場合は、glab コマンドを使うこともできます。

Claude が生成する PR の例

## タイトル
ユーザー認証のバリデーションロジックを改善

## 概要
ユーザー登録時のメールアドレスとパスワードのバリデーションを
強化しました。

## 変更内容
- メールアドレスの形式チェックを RFC 5322 準拠に更新
- パスワードの最小文字数を 8 文字から 12 文字に変更
- バリデーションエラーメッセージの日本語対応

## テスト方法
1. /signup ページにアクセス
2. 不正なメールアドレスを入力して送信
3. エラーメッセージが日本語で表示されることを確認

Step 3: PR をレビューする

Claude は他の人が作った PR のレビューも手伝ってくれます。

# PR をレビューしてもらう
> PR #42 をレビューしてください

# セキュリティ観点でのレビュー
> PR #42 をセキュリティの観点からレビューしてください

# パフォーマンス観点でのレビュー
> PR #42 のパフォーマンスへの影響を確認してください

レビューの観点

Claude は以下の観点からコードレビューを行えます。

• バグの可能性 - ロジックエラーやエッジケースの見落とし
• セキュリティ - SQL インジェクション、XSS などの脆弱性
• パフォーマンス - 不要なループや重い処理
• 可読性 - 命名規則、コードの構造
• テスト - テストカバレッジの十分性

実践例

例 1: 機能追加の PR

> 今回追加した検索機能の PR を作成してください。
  以下の情報を含めてください:
  - ユーザーストーリー: 「ユーザーとして商品を名前で検索したい」
  - 技術的な変更点
  - スクリーンショットの代わりに動作説明

例 2: バグ修正の PR

> Issue #15 のバグ修正 PR を作成してください。
  原因と修正内容を明確に記載してください。

Claude は Issue の内容を読み取り、PR の説明文に以下を含めます。

## 修正した問題
Fixes #15

## 原因
`UserService.getById()` が存在しないユーザー ID を受け取った場合に
null チェックなしで `.name` プロパティにアクセスしていた。

## 修正内容
- null チェックのガード句を追加
- ユーザーが見つからない場合は 404 エラーを返すように変更
- 回帰テストを追加

例 3: リファクタリングの PR

> 今回のリファクタリングの PR を作成してください。
  動作に変更がないことを強調してください。

PR を作成する前に確認すること

• すべてのテストがパスしていること
• 不要なデバッグコードが残っていないこと
• コミットメッセージが適切であること
• ブランチが最新の main と同期していること

PR 作成のコツ

1. コミットを整理してから PR を作る

# コミット履歴を確認
> コミット履歴を確認して、整理が必要か教えてください

# コミットメッセージを改善
> コミットメッセージをより分かりやすく書き直してください

2. PR のサイズを小さく保つ

# 大きな変更を分割する
> この変更を複数の PR に分割する方法を提案してください

小さな PR のメリット

PR のサイズが小さいほど、レビューが早くなり、マージまでの時間が短くなります。目安として 変更ファイル数が 10 以下 に収まるようにしましょう。

3. セルフレビューを依頼する

# PR 作成前にセルフレビュー
> PR を作成する前に、この変更をセルフレビューしてください。
  問題があれば指摘してください。

PR ワークフローの自動化

Claude Code を使えば、PR に関連する一連の作業を一括で依頼できます。

> 以下を順番に行ってください:
  1. 変更内容を確認して要約
  2. テストが全てパスするか確認
  3. lint を実行してエラーがないか確認
  4. PR を作成

Claude Code でできる PR 関連タスク

• PR のタイトル・説明文の自動生成
• レビューコメントへの対応（修正の実行）
• コンフリクトの解消
• CI/CD のエラー対応
• PR テンプレートに沿った記述

まとめ

ステップ	やること	ポイント
1. 要約	変更内容を確認・要約	差分を分析して整理
2. 作成	PR を作成	タイトル・説明・テスト方法を含める
3. レビュー	PR をレビュー	セキュリティ・パフォーマンス等の観点

これで Step 4 の実践開発は完了です。次は Claude Code をさらに使いやすくするための Step 5: カスタマイズ に進みましょう。