Claude CodeでコミットメッセージとPR本文を作る

git差分の確認から、要約・コミットメッセージ案・PR本文作成までの手順

この記事では、修正後の差分を「チームに共有しやすい形」に整える。
実装の良し悪しだけでなく、説明可能性を高める工程。

このステップでやること

• git status / git diff で差分確認
• 変更内容と影響範囲を要約
• コミットメッセージ案を作成
• PR本文を作成

作業前チェック（2分）

cd /path/to/your-project
git status --short
git branch --show-current

• main/master で直接作業している場合は先に作業ブランチへ移動する
• 生成物や関係ない差分が混ざっていないか確認する

最低限の実行コマンド

以下を順番に実行してから、Claude Code に要約を依頼する。

git status
git diff --stat
git diff

実行依頼テンプレート

git diff を確認して、以下を作成してください。

1. 変更内容の要約
2. 影響範囲
3. 確認したコマンドと結果
4. コミットメッセージ案
5. PR本文

必要なら次も追加で依頼する。

現在の差分のみを対象に、Conventional Commits 形式でコミットメッセージを3案ください。
そのうち最も適切な1案を理由付きで選んでください。

出力フォーマット例

コミットメッセージ案

• fix(contact): require email before submit

PR本文テンプレート

## Summary
- 問い合わせフォームでemail未入力でも送信できる不具合を修正
- 入力バリデーションとエラーメッセージ表示を追加
- 関連テストを追加

## Changes
- `src/...` フォーム送信条件を修正
- `src/...` バリデーションロジックを追加
- `tests/...` 未入力ケースのテストを追加

## Test plan
- pnpm lint
- pnpm typecheck
- pnpm test
- pnpm build

レビュー前に見るべき点

• 仕様外の差分が混ざっていないか
• 破壊的変更の有無
• テスト観点が要約に反映されているか
• PR本文に再現手順/確認手順があるか

実際のコミット例（手動）

Claude Codeが作った文面を確認後、人間が実行する。

git add <対象ファイル>
git commit -m "fix(contact): require email before submit"

このシリーズの到達点

03〜06 を通せば、次の流れを一通り実践できる。

• 調査（関連ファイル・影響範囲）
• 最小実装（仕様外変更を抑制）
• 検証（lint/typecheck/test/build）
• 共有（コミット/PR）

次は運用安定化として、CLAUDE.md と安全運用（Hooksや禁止操作）を整理するとよい。
公式ドキュメントも併せて確認しておくと運用しやすい。

• Claude Code overview
• Claude Code hooks