Claude Code ActionとGitHub Appで実現するリポジトリ横断のAIコードレビュー

参考になった

レビュー投稿日の情報になります

株式会社tacoms / yoda

CTO・VPoE / CTO / 従業員規模: 51名〜100名

最終更新日2025/07/07投稿日2025/07/07

ツールの利用規模	ツールの利用開始時期	事業形態
11名〜50名	2021年4月	B to B

ツールの利用規模	11名〜50名
ツールの利用開始時期	2021年4月
事業形態	B to B

アーキテクチャ

アーキテクチャの意図・工夫

標準のGITHUB_TOKENでは他リポジトリへのアクセスができません。そのため、GitHub Appを作成し、適切なリポジトリの権限を付与したトークンをClaude Code Actionへ渡しました。さらに、Claude Code Actionの内部でghコマンドを許可することで、他リポジトリの参照を可能にしました。

具体的な工夫：

GitHub Appに最小限の権限（Contents: Read, Issues: Read, Metadata: Read, Pull requests: Write）を付与
Bash(gh:*)を許可してghコマンドでの他リポジトリアクセスを実現
custom_instructionsで参照すべきリポジトリとファイルを明示的に指定

導入の背景・解決したかった問題

導入背景

前提

GiHhub Actionsの導入についてではなく、GitHub Actionsを活用したClaude Code ActionとGitHub Appで実現したコードレビューの導入背景について記載します。

ツール導入前の課題

Claude Code Actionは複雑な設定なしにコードレビューに活用できます。しかし、標準設定では同一リポジトリ内のコードやドキュメントを参照したレビューのみで、他のリポジトリを参照することができません。これは、Actionsファイル内で参照できるGITHUB_TOKENが他リポジトリにアクセスできない権限設定になっているためです。

具体的には以下のような課題がありました：

APIスキーマが別リポジトリにあるケース
インフラ・データベースの仕様ドキュメントが別リポジトリにあるケース
共通ライブラリが別リポジトリにあるケース
フロントエンド・バックエンドの実装が分かれているケース
マイクロサービスなど、依存するサービスのリポジトリが分かれているケース
GitHub上でPRDやADRなどを管理しており、作業リポジトリとは別リポジトリにあるケース

どのような状態を目指していたか

精度の高いAIレビューを実現するため、リポジトリ横断でAIが確認できる状態を目指しました。複数のリポジトリを参照して、API実装と仕様の整合性、フロントエンドとバックエンドの互換性、インフラ定義との整合性などを包括的にレビューできることを目標としました。

https://zenn.dev/tacoms/articles/6b0934ac9fd069

比較検討したサービス

Code Rabbit
GitHub Copilot コードレビュー
PR-Agent

比較した軸

導入コスト
運用コスト
複数リポジトリ参照の可能性
カスタマイズ性（プロンプト調整など）
コード修正の汎用性
今後の拡張性

選定理由

今後の拡張可能性。コードレビューに特化したツールでは実現できない、レビューから自然言語での修正依頼というワークフローを実現するためにClaude Code Actionを試してみたかった

導入の成果

改善したかった課題はどれくらい解決されたか

複数リポジトリを参照したAIコードレビューという課題は解決されました。さらに、カスタムプロンプトでリポジトリの要件に合わせて参照先のリポジトリをコントロールしています。

どのような成果が得られたか

API実装と仕様の整合性チェック

破壊的変更がフロントエンドに与える影響を事前に検知
ビジネスロジックとAPI設計の意図の一致を確認

インフラ・データベースドキュメントを踏まえたレビュー

例えばexample-terraformリポジトリのインフラ定義を参照した上で、環境変数や設定値の依存関係を考慮したレビューなど

共通ライブラリ・実装参照の課題解決

共通ライブラリにある実装を確認してコードの重複を検出
共通ライブラリ内部の実装を確認した上で、関数などが正しく利用できているかを確認

リポジトリ間の依存関係の確認

フロントエンドとバックエンドの互換性を包括的にレビュー
AサービスからBサービスへの連携など、サービスの依存関係を踏まえたレビュー

導入時の苦労・悩み

別リポジトリの情報取得方法をコマンドで指定しないと仮想マシン上でgit cloneしてしまう問題への対処
GithubAppにリポジトリをインストールした上で、 'actions/create-github-app-token@v1' の'repositories'パラメータに指定しないと権限が付与されない