【要約】各リポジトリに workflow を撒かずに Claude Code Action で PR レビューする Hub 型基盤 [Qiita_Trend] | Summary by TechDistill
> Source: Qiita_Trend
Execute Primary Source
// Problem
メグリ株式会社は、数百規模のリポジトリ運用において、AIレビューの標準化と管理コストの増大という課題に直面した。具体的には以下の問題が発生していた。
- ・各リポジトリにworkflowを配置すると、レビュー観点の変更時に全リポジトリへの展開作業が発生する。
- ・トークンや権限設定が各リポジトリに分散し、一元的な管理が困難になる。
- ・GitHub Copilotのライセンス有無により、AIレビューの適用範囲に不均衡が生じる。
// Approach
開発チームは、対象リポジトリに手を加えず、Hubリポジトリから外部PRを操作する「Hub型基盤」を構築した。以下の手法を用いて課題を解決している。
- ・Hub Issueをトリガー兼キューとして利用し、GASや手動メンションでClaude Code Actionを起動する。
- ・
EXTERNAL_GH_TOKEN(fine-grained PAT) を用い、Hub側から対象リポジトリのdiff取得やレビュー投稿を行う。 - ・PRの規模に応じて Haiku / Sonnet / Opus を使い分ける「3段モデルルーティング」によりコストを最適化する。
- ・GitHub APIの制約を回避するため、差分外の指摘はインラインコメントではなくレビュー本文へ集約する運用ルールを設ける。
// Result
この基盤の導入により、レビュー品質とコストの高度な中央制御を実現した。成果は以下の通りである。
- ・レビュー観点やモデル選択を、Hub側の設定変更のみで全リポジトリへ即時反映できるようになった。
- ・モデルルーティングにより、コストとレビュー品質のバランスを中央から動的に調整可能となった。
- ・今後はPAT依存を解消するため、GitHub App化による短命なトークン発行への移行を計画している。
Senior Engineer Insight
> 大規模環境における「設定の分散」は技術負債の温床だ。本構成は、各リポジトリをクリーンに保ちつつ、中央でポリシーを統制する点で極めて合理的である。特に、モデルルーティングによるコスト制御や、API制約を前提とした出力形式の制御は、実運用を深く理解した設計と言える。ただし、PATによる権限集中はセキュリティ上の急所だ。早期のGitHub App化が、真のプラットフォームとしての完成度を左右するだろう。