sentry-pr-code-review

О sentry-pr-code-review

Рабочий процесс для проверки и исправления проблем, которые Seer от Sentry помечает как комментарии к обзору кода в запросах на слияние (pull requests) GitHub через свою функцию Предсказания ошибок. Это правильный инструмент, когда кто-то просит проверить или устранить комментарии Sentry или Seer в PR, разрешить эти замечания или найти недавние PR, которые всё ещё содержат нерешённые отзывы от Sentry. Навык является частью более широкого дерева рабочих процессов Sentry и не может быть вызван самостоятельно через модель.

Он зависит от установленной и аутентифицированной командной строки gh CLI, а также от установленного в репозитории приложения GitHub Seer от Sentry. Процесс состоит из четырёх фаз. Фаза 1 получает комментарии к обзору через gh api на эндпоинте комментариев PR, фильтруя по имени бота seer-by-sentry[bot], явно исключая sentry[bot] или sentry-io[bot], и, если номер PR не указан, сканирует недавние открытые PR, чтобы подсчитать комментарии Seer. Фаза 2 разбирает каждый комментарий в формате markdown на описание ошибки, строку с уровнем серьёзности и уверенностью, а также сворачиваемые разделы Подробный анализ, Предложенное исправление и Запрос для ИИ-агента. Фаза 3 проверяет каждую проблему, читая файл по указанной строке, подтверждая, что проблема всё ещё существует, оценивая, является ли она реальной или ложным срабатыванием, и внедряя исправление, учитывая крайние случаи и риск регрессии. Фаза 4 суммирует результаты в таблице разрешённых против пропущенных элементов.

В документации отмечается, что формат разобранного комментария отражает текущий вывод Seer, а не стабильный контракт API, поэтому фактическую структуру всегда следует проверять. Также рассматривается, когда запускаются обзоры Seer, включая перевод PR в статус Готов к обзору, новые коммиты в готовом PR и ручной комментарий к обзору от Sentry, тогда как черновики PR пропускаются. Руководство по устранению неполадок охватывает отсутствующие комментарии, несоответствие имени бота и частичные результаты gh api, а справочная таблица перечисляет распространённые категории проблем, такие как безопасность типов, обработка ошибок, валидация и конфигурация.

Часто задаваемые вопросы

Какие требования необходимы для использования этого навыка?

Должны быть установлены и аутентифицированы gh CLI, а в репозитории должно быть установлено приложение GitHub Seer от Sentry.

Какое имя бота идентифицирует комментарии для исправления?

Комментарии поступают от seer-by-sentry[bot]; навык подчёркивает, что это не sentry[bot] и не sentry-io[bot].

Что происходит, если я не укажу номер PR?

Отображаются недавние открытые PR, и подсчитываются комментарии Seer в каждом из них, сообщая, какие PR содержат нерешённые отзывы от Seer.

Как определяется, применять ли исправление на самом деле?

Для каждой проблемы читается файл по указанной строке, подтверждается, что проблема всё ещё существует в текущем коде, оценивается, является ли она реальной проблемой или ложным срабатыванием, после чего внедряется исправление с учётом крайних случаев и риска регрессии.

Когда Seer запускает обзор в запросе на слияние?

Seer запускается автоматически, когда PR установлен в статус Готов к обзору или при отправке коммита, пока он готов, а также по ручному комментарию к обзору от Sentry; черновики PR пропускаются.