PR Lens로 풀 리퀘스트를 시각화하고 리뷰하기

PR Lens는 풀 리퀘스트를 시각화하는 오픈 소스 AI 도구입니다. 코드 변경과 필요한 저장소 맥락을 읽어 애니메이션 아키텍처 및 데이터 흐름 다이어그램을 만들고 GitHub PR 댓글 안에 보여 줍니다. Reviewer는 전체 구조를 먼저 이해한 뒤 중요한 Diff를 집중해서 읽을 수 있습니다.

쉽게 말해 PR Lens는 무엇을 하는 사이트인가요?

큰 풀 리퀘스트를 검토하려면 여러 파일, 서비스, 호출 관계, 삭제된 경로를 한꺼번에 기억해야 합니다. PR Lens는 이 정보를 하나의 시각적 지도에 모읍니다. Architecture 보기는 추가·수정·삭제된 컴포넌트와 맥락이 되는 변경 없는 요소를 표시합니다. Data Flow 보기는 실제 순서가 존재하는 처리 경로를 단계별로 움직여 보여 줍니다. 즉 “이 PR이 시스템을 어떻게 바꾸는가”를 이해하도록 돕는 도구이며, Bug나 보안 취약점을 자동으로 찾는 스캐너는 아닙니다.

두 다이어그램이 코드 리뷰를 돕는 방식

컴포넌트는 시스템 계층이나 경계를 나타내는 Lane으로 묶이므로 변경 파일 목록만으로는 보이지 않는 영향 범위를 판단하기 쉽습니다. 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을 함께 쓰면 댓글이 두 개 생길 수 있으므로 하나를 선택해야 합니다.

실제 풀 리퀘스트 리뷰 순서

App을 설치하거나 Action을 추가하고 Ready for review 상태의 PR을 엽니다. 먼저 Architecture 그림에서 변경된 경계, 새 컴포넌트, 제거된 경로를 확인합니다. 이어서 Data Flow로 실행 순서를 보고, 변경이 크면 Canvas를 엽니다. 그림을 바탕으로 자세히 읽을 파일을 정하되 원본 Diff, CI 결과, 경계 조건 테스트를 생략해서는 안 됩니다. 이름이나 그룹이 잘못됐다면 생성된 SVG를 고치지 말고 .github/pr-lens.yml에 지속되는 보정 규칙을 작성합니다.

비용, 개인정보 및 중요한 한계

PR Lens는 오픈 소스 프로젝트에 무료이며 공식 저장소는 MIT 라이선스입니다. Action 또는 CLI 사용자는 선택한 모델 공급자의 분석 비용만 부담합니다. 공식 사이트에는 비공개 저장소용 Hosted App의 검증 가능한 단일 가격이 공개되어 있지 않습니다. Hosted App은 PR Head를 일회용 Sandbox에 Shallow Clone하고 Gemini로 분석한 뒤 그래프 문서와 SVG를 Object Storage에 저장하고 Sandbox를 삭제합니다. 저장 Object에는 앱이 설정한 자동 만료 기간이 없으며 이미지 링크를 가진 사람이 렌더를 가져갈 수 있습니다. 민감한 코드라면 공식 데이터 처리·보존 설명을 읽고 로컬 CLI나 Agent Skill을 고려하세요.

자주 묻는 질문

PR Lens가 Bug나 보안 문제를 찾나요?

아닙니다. 변경 구조와 흐름을 보여 주며 결함 탐지, Security Scan, 사람의 판단은 별도 단계입니다.

API Key가 필요한가요?

Hosted App에는 사용자 Key가 필요 없습니다. Action과 CLI는 자신의 Provider Key를 쓰고 Skill은 기존 Agent 모델을 사용합니다.

비공개 저장소에서도 쓸 수 있나요?

선택한 비공개 저장소에 App을 설치할 수 있지만 저장 및 링크 접근 방식을 평가해야 합니다. 로컬 방식은 더 많은 통제권을 제공합니다.

새 Push 뒤에는 어떻게 되나요?

App이 새 댓글을 만들지 않고 기존 Sticky Comment를 최신 PR Head의 그림으로 갱신합니다.

공식 자료

• PR Lens의 범위와 네 가지 실행 방식
• GitHub App 설치, 읽기 범위, 권한
• MIT 소스 코드, 설정 문서, Issue