Claude CodeでPR（プルリクエスト）を作成・レビューする

はじめに ― PRワークフローとClaude Code

プルリクエスト（PR）は、チーム開発におけるコード品質の要です。Claude CodeはPRの作成からレビュー、フィードバック対応までを一気通貫でサポートします。

Claude CodeができるPR関連作業

PR作成: タイトルと説明文を変更内容から自動生成
PRレビュー: コードの問題点・改善点を指摘
レビュー対応: 指摘事項の修正を実行
PR説明文の更新: 追加変更に合わせて説明を更新

PRの作成 ― gh pr create

Claude Codeはgh（GitHub CLI）を使ってPRを作成します。

PR作成の手順

作業ブランチで変更をコミット済みであることを確認
リモートにブランチをpush
Claude Codeに「PRを作成して」と依頼
Claude Codeが変更内容を分析してタイトル・説明文を生成
確認後、gh pr createでPRを作成

PR作成の実行例

あなた: PRを作成して。mainブランチに対して。

Claude Code:
ブランチの変更内容を分析しています...

コミット一覧 (main...feature/user-profile):
1. feat: ユーザープロフィールページを追加
2. feat: プロフィール画像のアップロード機能
3. test: プロフィール関連のテストを追加

以下のPRを作成します:

タイトル: ユーザープロフィール機能を追加
本文:
## Summary
- ユーザープロフィールページの新規作成
- プロフィール画像のアップロード・表示機能
- プロフィール関連のテストカバレッジ追加

## Test plan
- [ ] プロフィールページの表示確認
- [ ] 画像アップロードの動作確認
- [ ] バリデーションエラーの確認

作成してよいですか？

PR説明文のフォーマット

Claude Codeが生成するPR説明文は、以下のフォーマットに従います。

## Summary
<変更内容の箇条書き（1-3項目）>

## Test plan
<テスト方法のチェックリスト>

🤖 Generated with Claude Code

PR説明文のカスタマイズ

CLAUDE.mdにPRテンプレートの指示を書くことで、生成される説明文をカスタマイズできます。

## PR規約
- タイトルは70文字以内
- Summaryセクションに変更の背景・理由を含める
- Breaking Changesがある場合は明記
- 関連Issueをリンクする（Closes #123）
- スクリーンショットが必要なUI変更は画像を添付

PRのレビュー

Claude Codeには、既存のPRをレビューする機能もあります。

レビュー依頼の例

あなた: PR #42をレビューして

Claude Code:
PR #42 の変更内容を確認しています...

タイトル: 検索機能の追加
変更ファイル: 8件 (+342, -15)

レビュー結果:

✅ 良い点:
- 検索ロジックがServiceクラスに分離されている
- 入力のサニタイズが適切に行われている
- テストカバレッジが十分

⚠️ 改善提案:
1. src/services/search.ts:45
   - N+1クエリの可能性があります
   - Promise.allで並列化するか、JOINで一括取得を検討

2. src/components/SearchBar.tsx:23
   - デバウンス処理がないため、キー入力のたびにAPIが呼ばれます
   - useDebouncedValueフックの使用を推奨

3. src/types/search.ts:12
   - SearchResult型のscoreフィールドがoptionalですが、
     常に値が入るなら必須にすべきです

レビューフィードバックへの対応

レビューで指摘された内容を、Claude Codeに修正を依頼できます。

あなた: PR #42のレビューコメントを確認して、指摘事項を修正して

Claude Code:
PR #42のレビューコメントを確認しています...

3件の指摘があります:
1. search.tsのN+1クエリ → JOINで一括取得に修正
2. SearchBarのデバウンス → useDebouncedValueを追加
3. SearchResult.scoreの型 → 必須フィールドに変更

修正を実行します...

PRテンプレートの活用

GitHubリポジトリに.github/pull_request_template.mdを配置することで、PRの説明文テンプレートを統一できます。

PRテンプレートの例

## 概要
<!-- この変更の目的を簡潔に記述 -->

## 変更内容
<!-- 主な変更点を箇条書き -->

## 関連Issue
<!-- Closes #Issue番号 -->

## テスト方法
- [ ] ユニットテスト通過
- [ ] 手動テスト実施
- [ ] レスポンシブ確認

## スクリーンショット
<!-- UI変更がある場合に添付 -->

## チェックリスト
- [ ] コーディング規約に準拠
- [ ] テストを追加・更新
- [ ] ドキュメントを更新

まとめ

Claude Codeは変更内容を分析してPRのタイトルと説明文を自動生成する
gh CLIを使ってPRの作成・確認・マージまでClaude Code内で完結
PRレビュー機能でコードの問題点や改善提案を受けられる
レビューフィードバックの修正もClaude Codeに任せられる
PRテンプレートとCLAUDE.mdの設定でチーム全体の品質を統一