PR Lens by Coldtea

個々の行より先にシステムの変化を理解する

PR Lensは、どのコンポーネントがサービスを呼ぶようになったか、リファクタリング後にデータがどこへ流れるか、といった疑問に答えるためのツールです。追加・変更・削除を別の見せ方で表現し、関係する周辺コンポーネントも残して背景を理解できるようにします。

例えばメール送信をキューへ移す変更なら、「API → キュー → worker」として示すと議論しやすくなります。これは確認する関係の一例であり、どのPRでもこの図が生成されるという意味ではありません。

実際のPRで図を試す

1. 少数のファイルに明確な変更があるPRを選び、公式GitHub Appまたはスキルを使います 。
2. その変更について、アーキテクチャ図またはデータフロー図を生成します。
3. キャンバスを開き、変更されたコンポーネントと接続をたどります。
4. 重要な接続をソースと照合し、誤解を招くラベルはリポジトリの設定で直してから、コードレビューを続けます。

ドキュメントに記載されたスキルのインストールコマンドです。

npx skills add coldteadotai/pr-lens

図を使って確認すべき点を見つける

失敗時にどうなるか、どの呼び出し元が旧経路を使い続けるか、テストが新しい境界を通るかを確認してください。こうした問いによって、図がレビューの助けになります。整った図もコードを表したモデルであり、正しい動作の証明ではありません。