PR Lensでプルリクエストを可視化してレビュー

PR Lensは、プルリクエストを可視化するオープンソースのAIツールです。コード差分と必要なリポジトリ文脈を読み取り、アニメーション付きのアーキテクチャ図とデータフロー図を生成してGitHubのPRコメント内に表示します。Reviewerは全体像をつかんでから重要なDiffに集中できます。

PR Lensは何をするサイト？わかりやすく説明

大きなプルリクエストでは、複数のファイル、サービス、呼び出し、削除された経路を頭の中で組み立てる必要があります。PR Lensはそれらを一枚の視覚的な地図にします。Architectureビューは追加・変更・削除されたコンポーネントと、文脈になる未変更部分を示します。Data Flowビューは、実際に順序を持つ処理がある場合に、その流れを段階的に動かします。「このPRはシステムをどう変えるか」を理解するためのツールであり、Bugや脆弱性を自動検出する製品ではありません。

2種類の図がコードレビューに役立つ理由

コンポーネントはシステムの層や境界を表すレーンに整理されるため、変更ファイル一覧だけでは見えない影響範囲を確認できます。API、Queue、Worker、外部連携などは、動くデータフローで実行順序を追えます。大きな変更はフルサイズCanvasで拡大・移動・テーマ切り替え・ガイド付きWalkthroughが可能です。SVGにはJavaScriptが含まれず、検証済みの型付きドキュメントから同じ結果が決定論的に描画されます。

GitHub App・Action・CLI・Agent Skillの選び方

GitHub Appは最も簡単で、対象リポジトリを選ぶとPRごとに一つのコメントを維持し、Pushのたびに更新します。GitHub Actionは自分のCIとモデルKeyで動作し、Gemini、OpenAI、互換Endpointを選べます。CLIはローカルで分析、検証、描画、コメント生成、Exportを個別に実行できます。Agent Skillは既存のCoding Agentのモデルを使ってグラフ文書を作ります。同じリポジトリでAppとActionを併用するとコメントが二つになるため、どちらか一方を選びます。

実践的なPull Requestレビュー手順

Appを導入するかActionを追加し、Ready for reviewのPRを開きます。最初にArchitecture図で境界、新規コンポーネント、削除経路を確認し、次にData Flowで実行順序を追います。変更が大きければCanvasを開きます。図を使って重点的に読むファイルを決めますが、元のDiff、CI、境界値テストも必ず確認します。名前やグループが誤っている場合は、生成SVGを直接直すのではなく、.github/pr-lens.ymlに永続的な補正を記述します。

料金・プライバシー・重要な制約

PR Lensはオープンソースプロジェクトでは無料で、公式リポジトリはMITライセンスです。ActionやCLIでは選択したモデル事業者の分析料金だけを支払います。公式サイトはPrivate Repository向けHosted Appの統一料金を公開していません。Hosted AppはPR Headを使い捨てSandboxへ浅くCloneし、Geminiで分析し、グラフ文書とSVGをObject Storageに保存した後、Sandboxを削除します。保存されたObjectにはアプリが設定する自動有効期限がなく、画像URLを知る人が取得できる可能性があります。機密コードでは公式のデータ処理・保存説明を確認し、必要ならローカルCLIやAgent Skillを選んでください。

よくある質問

PR LensはBugやセキュリティ問題を発見しますか？

いいえ。変更構造の理解を助ける製品です。欠陥検出、Security Scan、人による判断は別途必要です。

API Keyは必要ですか？

Hosted Appでは自分のKeyは不要です。ActionとCLIは自分のProvider Keyを使い、Skillは既存Agentのモデルを利用します。

Private Repositoryで使えますか？

選択したPrivate RepositoryにAppを導入できますが、保存とリンクアクセスの仕組みを評価してください。ローカル方式なら制御範囲を広げられます。

新しいPushの後はどうなりますか？

Appは新規コメントを増やさず、既存のSticky Commentを最新PR Headの図に更新します。

公式リソース

• PR Lensの概要と4つの実行方法
• GitHub Appの導入、読取範囲、権限
• MITソース、設定、Issue