Claude Code Review Tool

Claude Codeを使用したGitHub Pull Requestの自動コードレビューツール

✨ 特徴

• 🤖 Claude AIによる高品質なコードレビュー
• 📊 視覚的なHTMLレポート生成
• 🎯 重要度別の問題分類（Critical, High, Medium, Low）
• 🔗 GitHub PR との完全な統合
• 🚀 セットアップが簡単

📋 必要な環境

• Claude Code のインストール
• Git
• Node.js (v18以上)
• GitHub CLI (gh) - PR番号の自動取得に必要
• jq - JSON処理に必要

🚀 セットアップ

1. レビューしたいプロジェクトをクローン

レビュー用の作業ディレクトリを作成してプロジェクトをクローン：

# 作業ディレクトリを作成
mkdir -p ~/reviews/your-project
cd ~/reviews/your-project

# プロジェクトをクローン
git clone https://github.com/YOUR_ORG/YOUR_REPO.git .

または既存のプロジェクトをレビュー用にコピー：

cp -r /path/to/existing/project ~/reviews/your-project
cd ~/reviews/your-project

2. このツールをクローン

レビュー用ディレクトリに移動してからツールをクローン：

# レビュー用ディレクトリに移動（重要！）
cd ~/reviews/your-project

# .claudeディレクトリとしてツールをクローン
git clone https://github.com/keisuke-na/claude-code-review.git .claude

または既存の.claudeディレクトリがある場合：

rm -rf .claude
git clone https://github.com/keisuke-na/claude-code-review.git .claude

3. Claude Codeを起動

プロジェクトディレクトリでClaude Codeを開きます：

claude .

4. 初期セットアップ

Claude Code内で以下のコマンドを実行：

/review-init

これにより以下が自動で実行されます：

• 必要なディレクトリの作成
• npm依存関係のインストール

📖 使い方

基本的な使い方

PR/ブランチのコードレビューを実行：

/review {branch_name}

例：

/review feature/add-auth

レビューモード

Quick レビュー（高速）

/review feature/add-auth q

Deep レビュー（詳細）

/review feature/add-auth d

緊急度指定

重要度7以上の問題のみ表示：

/review feature/add-auth 7

追加オプション

セキュリティ重視

/review feature/add-auth sec

パフォーマンス重視

/review feature/add-auth perf

修正必須項目のみ

/review feature/add-auth fix

📂 ディレクトリ構造

.claude/
├── commands/           # Claude Codeカスタムコマンド
│   ├── review.md      # メインレビューコマンド
│   └── review-init.md # 初期セットアップコマンド
├── review-steps/      # レビュー実行ステップ
├── review/ui/         # HTMLレポート生成UI
├── reviews/           # 出力ディレクトリ（.gitignore）
│   ├── json/         # JSONレビュー結果
│   └── html/         # HTMLレポート
└── *.sh              # ユーティリティスクリプト

🎯 レビュー結果

レビュー完了後、以下のファイルが生成されます：

• JSON形式: .claude/reviews/json/review-latest.json
• HTML形式: .claude/reviews/html/latest.html

HTMLファイルをブラウザで開くと、以下の機能が利用できます：

• 問題の重要度別フィルタリング
• コード位置へのジャンプ（GitHub連携）
• レビューコメントのコピー機能
• 問題のチェックリスト管理

💡 Tip: latest.htmlをブラウザでブックマークしておくと、いつでも最新のレビュー結果にアクセスできて便利です。

🔧 トラブルシューティング

GitHub CLI認証

PR番号の自動取得にはGitHub CLIの認証が必要です：

gh auth login

依存関係の再インストール

問題が発生した場合、依存関係を再インストール：

cd .claude/review/ui
rm -rf node_modules package-lock.json
npm install

🤝 貢献

Issue報告やPull Requestは歓迎です！

📄 ライセンス

MIT License

🙏 謝辞

このツールはClaude Codeのカスタムコマンド機能を活用しています。

---

Made with ❤️ by keisuke-na