Claude Code チーム開発 — CLAUDE.md・Git Hooks・レビュー自動化で実現するAIペアプログラミング

#!/bin/bash
# .git/hooks/pre-commit（または .husky/pre-commit）
 
echo "🔍 Claude Code によるコミット前チェックを実行中..."
 
# ステージングされたファイルを取得
STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(ts|tsx|js|jsx)$')
 
if [ -z "$STAGED_FILES" ]; then
  echo "✅ チェック対象のファイルがありません"
  exit 0
fi
 
# Claude Code でコード品質チェック
claude -p "以下のファイルの変更内容をレビューしてください。
重大な問題（セキュリティ脆弱性、型エラー、未処理の例外）がある場合のみ
'BLOCK' と出力してください。問題がなければ 'PASS' と出力してください。
 
対象ファイル:
$STAGED_FILES
 
$(git diff --cached -- $STAGED_FILES)" 2>/dev/null | tail -1 | grep -q "BLOCK"
 
if [ $? -eq 0 ]; then
  echo "❌ 重大な問題が検出されました。コミットを中止します。"
  echo "   'git diff --cached' で変更内容を確認してください。"
  exit 1
fi
 
echo "✅ コード品質チェック通過"
exit 0

#!/bin/bash
# .git/hooks/prepare-commit-msg
 
COMMIT_MSG_FILE=$1
COMMIT_SOURCE=$2
 
# マージコミットやアメンドの場合はスキップ
if [ "$COMMIT_SOURCE" = "merge" ] || [ "$COMMIT_SOURCE" = "squash" ]; then
  exit 0
fi
 
# 変更差分からコミットメッセージを生成
DIFF=$(git diff --cached --stat)
DETAILED_DIFF=$(git diff --cached | head -500)
 
SUGGESTED_MSG=$(claude -p "以下のgit diffからConventional Commits形式の
コミットメッセージを1行で生成してください。
日本語で、50文字以内で記述してください。
型は feat/fix/refactor/docs/test/chore から選んでください。
 
変更概要:
$DIFF
 
変更詳細:
$DETAILED_DIFF" 2>/dev/null | tail -1)
 
if [ -n "$SUGGESTED_MSG" ]; then
  echo "$SUGGESTED_MSG" > "$COMMIT_MSG_FILE"
fi

# プロジェクトの .githooks/ ディレクトリを使用する設定
git config core.hooksPath .githooks
 
# package.json に postinstall スクリプトを追加
# "postinstall": "git config core.hooksPath .githooks"

# .github/workflows/ai-code-review.yml
name: AI Code Review
on:
  pull_request:
    types: [opened, synchronize]
 
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - name: Get changed files
        id: changes
        run: |
          FILES=$(gh pr diff ${{ github.event.pull_request.number }} \
            --name-only | grep -E '\.(ts|tsx|js|jsx)$' | head -20)
          echo "files=$FILES" >> $GITHUB_OUTPUT
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
      - name: AI Review
        if: steps.changes.outputs.files != ''
        run: |
          # Claude API を使用したレビュー（実装例）
          DIFF=$(gh pr diff ${{ github.event.pull_request.number }})
          # レビューコメントを生成して PR に投稿
          echo "Review complete"
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

## コードレビュー基準（CLAUDE.md に追記）
 
### 必須チェック（BLOCK判定）
- SQL インジェクションの可能性
- XSS 脆弱性（dangerouslySetInnerHTML の不適切な使用）
- 認証・認可チェックの欠落
- 環境変数・シークレットのハードコーディング
- 無限ループ・無限再帰の可能性
 
### 推奨チェック（WARNING判定）
- 不要な re-render を引き起こす実装
- N+1 クエリの可能性
- エラーハンドリングの欠落
- マジックナンバーの使用
- 複雑度の高い関数（循環的複雑度 > 10）

# タスク開始時にコンテキストを明示的に設定
claude "現在のタスク: ユーザー認証機能のリファクタリング
担当: フロントエンド（バックエンドAPIは @tanaka が並行作業中）
目標: JWT から Session Cookie への移行
制約: 既存のAPIレスポンス形式は変更不可
参考PR: #234（バックエンド側の変更）"

## ブランチ別ルール（CLAUDE.md に追記）
 
### feature/* ブランチ
- 新機能の実装に集中
- テストコードの同時作成を推奨
- TypeScript の strict モードを遵守
 
### hotfix/* ブランチ
- 最小限の変更に留める
- 関連するテストの追加を必須とする
- パフォーマンスへの影響を必ず確認
 
### release/* ブランチ
- 新機能の追加は禁止
- バグ修正とドキュメント更新のみ許可