Claude CodeでGit差分をレビューする手順｜コミット前の5項目
更新日：2026年9月29日
AIにコードを書かせた後、コミット前に何を確認するかを固定します。
対象は、Claude Codeで変更を作り、Gitで差分を確認できる開発者です。レビュー手順の提案であり、品質や安全性を保証するものではありません。
レビュー手順
git statusで変更ファイルを確認する。git diff --statで変更量を見て、想定外の大きな変更を止める。- Claude Codeに「差分の目的、影響範囲、未確認のリスクを列挙」と依頼する。
- 変更ごとに、仕様、エラー処理、秘密情報、テストの4点を読む。
- テストを実行し、失敗時のログと修正内容を記録する。
- 自分のレビュー結果を残してからコミットする。
確認表
| 項目 | 質問 |
|---|---|
| 仕様 | 依頼した動作だけを変えたか |
| 範囲 | 設定・依存関係まで変わっていないか |
| 安全性 | キー、個人情報、ログを追加していないか |
| 品質 | 正常系・異常系のテストがあるか |
| 復旧 | 切り戻し方法が分かるか |
差分の読み方の例
次の変更なら、行数が少なくても確認が必要です。
- return total
+ return total + tax
レビューでは、税率の出所、丸め規則、税が不要な処理への影響、既存テストの期待値を確認します。Claude Codeには「この差分が変える仕様を3つ、影響を受ける呼び出し元、追加すべきテストを表で示して」と依頼できます。
失敗例
git diff --statだけ見て、設定ファイルや依存関係の変更を見落とすことがあります。git diff --name-onlyで一覧を出し、ロックファイル、CI設定、マイグレーションを別枠で確認します。テストが通っても、秘密情報やログの出力はテストでは検出できないため、検索でも確認します。
差分が説明できない場合はコミットを保留します。レビュー担当者へ渡すときは、変更理由とテスト結果を添えます。
完了条件
変更ファイル、目的、テスト結果、未解決の懸念、切り戻し方法を説明できれば完了です。
関連記事
AI開発学習ロードマップでは、評価記録の作り方も扱っています。
コメント