メインコンテンツへスキップ
12 / 26|5分で読めます

Git連携 — コミットからPRまでをAIと共に

Claude Codeによるgit status確認、差分分析、コミットメッセージ生成、PR作成。日常のGitワークフローがどう変わるかを扱う。

Gitの操作は開発の根幹だ。Claude Codeは、状態確認からコミット、PR作成まで、Gitワークフロー全体を一貫して支援する。


Claude CodeのGit哲学

Claude Codeには、Gitに関する明確な安全哲学がある。

  1. 新規コミットを優先: --amend よりも新しいコミットを作る
  2. Hooksをスキップしない: --no-verify は使わない
  3. force pushしない: --force は原則禁止
  4. 破壊的操作を避ける: reset --hardcheckout . は慎重に

この哲学は「取り消しの効かない操作を避ける」という原則に基づいている。


コミットワークフロー

ステップ1: 状態確認

> 今の変更状況を教えて

Claude Codeは git statusgit diff を実行し、変更内容を分析する。

ステップ2: コミットメッセージの自動生成

> この変更をコミットして

Claude Codeは以下の手順を踏む。

  1. git status で未追跡ファイルを確認
  2. git diff でステージ済み・未ステージの変更を確認
  3. git log で最近のコミットメッセージのスタイルを確認
  4. 変更内容を分析し、Conventional Commits形式でメッセージを生成

Conventional Commits

<type>: <description>

<optional body>
タイプ説明
feat新機能
fixバグ修正
refactorリファクタリング
docsドキュメント
testテスト
chore雑務
perfパフォーマンス改善

PR作成ワークフロー

> PRを作成して

Claude Codeは以下の手順でPRを作成する。

  1. 現在のブランチとmainブランチの差分を分析
  2. すべてのコミット履歴を確認(最新だけでなく全コミット)
  3. PRタイトルとサマリーを自動生成
  4. gh pr create でPRを作成

PRの構成

## Summary
- 変更の概要を箇条書きで

## Test plan
- [ ] テスト項目1
- [ ] テスト項目2

/commit スキルの活用

/commit スラッシュコマンドを使うと、コミットワークフロー全体が自動化される。手動で指示するよりも、一貫したプロセスが保証される。


ブランチ戦略

> feature/add-bmi-calculator ブランチを作成して作業を始めて

Claude Codeはブランチの作成、チェックアウト、作業後のpush(-u フラグ付き)まで一貫して行える。


マージコンフリクトの解決

コンフリクトが発生した場合もClaude Codeが支援する。

> マージコンフリクトを解決して

Claude Codeは両方の変更を読み取り、意図を分析した上で、最適な解決策を提案する。ただし、コンフリクトの解決は慎重を要するため、提案内容は必ず人間が確認すべきだ。


Git安全プロトコル

Claude Codeに組み込まれたGit安全ルール。

ルール理由
git push --force を使わないリモートの変更を上書きするリスク
git reset --hard は慎重にコミットされていない変更が失われる
--no-verify を使わないpre-commitフックは品質の最後の砦
機密ファイルをコミットしない.env、認証情報のチェック
git add -A より個別追加不要なファイルの混入防止

この章のポイント

  • Claude CodeはGit操作全体(status確認、diff分析、コミット、PR作成)を一貫して支援する
  • Conventional Commits形式でコミットメッセージを自動生成する
  • force push禁止、hooks スキップ禁止など、安全なGit操作の哲学が組み込まれている
  • PR作成時は全コミット履歴を分析し、包括的なサマリーを生成する
  • /commit スキルで一連のワークフローを自動化できる