PR Lens для визуального ревью pull request

PR Lens — открытый ИИ-инструмент для визуализации pull request. Он превращает изменения кода в анимированные схемы архитектуры и потоков данных и помещает их прямо в PR, чтобы ревьюер сначала увидел общую структуру, а затем целенаправленно изучил diff.

Что делает PR Lens простыми словами?

В большом pull request приходится одновременно помнить файлы, сервисы, вызовы и удалённые пути. PR Lens собирает их в наглядную карту. Архитектурный режим отмечает добавленные, изменённые и удалённые компоненты, а неизменённые элементы оставляет для контекста. Режим data flow по шагам показывает фактическую последовательность выполнения, если она есть. Инструмент помогает понять изменение, но не ищет ошибки или уязвимости автоматически.

Чем диаграммы полезны при code review

Компоненты группируются по полосам, которые обозначают слои или границы системы. Так виден возможный радиус влияния, а не только список затронутых файлов. Анимация помогает проследить endpoint, очередь, worker или интеграцию в порядке выполнения. На полноразмерном canvas доступны масштабирование, перемещение, светлая и тёмная темы и пошаговый walkthrough. SVG не содержит JavaScript и детерминированно строится из проверенного типизированного документа.

GitHub App, Action, CLI и agent skill

GitHub App требует меньше всего настройки: выберите репозитории, и приложение будет поддерживать один комментарий на PR, обновляя его после каждого push. GitHub Action запускается в вашей CI с собственным ключом и поддерживает Gemini, OpenAI и совместимые endpoint. CLI предоставляет локальные команды анализа, проверки, рендеринга, создания комментария и экспорта. Agent skill использует модель уже запущенного coding agent. Для одного репозитория лучше выбрать App или Action, чтобы не получать два комментария.

Практический порядок ревью

Установите App либо добавьте Action и откройте pull request, готовый к проверке. Сначала посмотрите архитектурную схему и найдите затронутые границы, новые и удалённые компоненты. Затем проследите поток данных; для большой правки откройте canvas. Карта подсказывает, какие файлы и пути читать особенно внимательно, но не заменяет проверку diff, CI и граничных случаев. Ошибочные названия, исключения и группировку исправляйте в .github/pr-lens.yml, а не в сгенерированном SVG.

Цена, приватность и ограничения

PR Lens бесплатен для open-source проектов, репозиторий распространяется по MIT. В Action или CLI вы оплачиваете только вызов выбранного модельного провайдера; официальная страница не публикует единую подтверждённую цену hosted App для приватных репозиториев. App клонирует head PR в одноразовую песочницу, анализирует код через Gemini, сохраняет графовые документы и SVG в объектном хранилище и удаляет песочницу после запуска. Приложение не задаёт автоматический срок удаления сохранённых объектов, а человек со ссылкой может получить изображение. Для чувствительного кода изучите официальное описание обработки и хранения данных и рассмотрите локальный режим.

Частые вопросы

PR Lens находит баги и уязвимости?

Нет. Он показывает структуру изменения; анализаторы, security-проверки и человеческое ревью нужны отдельно.

Нужен ли API-ключ?

Для hosted App ваш ключ не нужен. Action и CLI используют ваш ключ провайдера, а skill — модель действующего coding agent.

Работает ли инструмент с приватными репозиториями?

App может работать с выбранными приватными репозиториями, но команде следует оценить хранение и доступ по ссылке. Локальные режимы дают больше контроля.

Что происходит после нового push?

App переписывает существующий закреплённый комментарий диаграммами текущей версии PR.

Официальные ресурсы

• Обзор PR Lens и четырёх режимов
• Установка и разрешения GitHub App
• MIT-код, конфигурация и issues