Знакомьтесь: mr-review — проверка merge request с помощью ИИ¶

Ревью кода — одна из самых полезных практик в разработке, но её качество сильно колеблется. Ревьюеры устают, переключаются между задачами прямо во время проверки и что-то упускают. mr-review — локальный инструмент командной строки, который с помощью LLM разбирает изменения в merge request так, как это сделал бы внимательный инженер.

В чём проблема¶

Обычное ревью MR состоит из нескольких этапов, которые люди часто объединяют или пропускают:

Понять замысел — какую задачу решает изменение?
Проверить diff — соответствует ли реализация замыслу? Есть ли ошибки?
Оставить замечания к строкам — конкретные предложения, которые можно применить.
Подвести итог — общий вывод и проблемы, блокирующие слияние.

Большинство инструментов ревью с ИИ помещают всё это в один промпт и получают стену общих замечаний. mr-review разделяет проверку на этапы.

Как это работает¶

mr-review подключается к вашей системе управления репозиториями (GitLab, GitHub, Gitea, Forgejo или Bitbucket) и получает diff. Затем выполняет четыре этапа:

Подготовка → Делегирование → Доработка → Публикация

Brief — модель читает заголовок MR, описание и список файлов, чтобы сначала понять цель изменения.

Dispatch — модель обрабатывает diff по частям и готовит черновые замечания к строкам каждого файла. Такое разбиение сохраняет фокус каждого промпта и не даёт большому diff переполнить контекст.

Polish — черновые комментарии проходят редактуру: дубликаты удаляются, тон выравнивается, бесполезные наблюдения отбрасываются.

Post — вы интерактивно просматриваете итоговый список и выбираете комментарии для публикации. Без вашего подтверждения в MR ничего не отправляется.

ИДЕЯ В СХЕМЕГде решение остаётся за ревьюером

---
config:
  theme: default
  look: classic
  flowchart:
    useMaxWidth: false
    wrappingWidth: 150
    padding: 12
    nodeSpacing: 24
    rankSpacing: 32
---
flowchart TD
    accTitle: Где решение остаётся за ревьюером
    accDescr: Модель собирает и уточняет замечания. Человек задаёт условия ревью и утверждает то, что будет опубликовано в merge request.
 B["Подготовить задание"] --> D["Запустить ревьюеров"] --> P["Доработать замечания"] --> A{"Утверждено?"}
 A -->|"Да"| R["Опубликовать"]
 A -->|"Исправить"| P

Модель собирает и уточняет замечания. Человек задаёт условия ревью и утверждает то, что будет опубликовано в merge request.

Готовые режимы проверки¶

Разным ревью нужен разный фокус. В mr-review есть четыре предустановленных режима:

Режим	Что проверяет
`thorough`	Корректность, логику, удобство сопровождения
`security`	Проверку входных данных, аутентификацию и авторизацию, секреты, инъекции
`style`	Имена, структуру, согласованность с окружающим кодом
`performance`	Часто выполняемые участки, лишние выделения памяти, запросы N+1

Выбор модели¶

mr-review работает с Claude, OpenAI и любым совместимым с OpenAI API. Если всё должно оставаться внутри вашей инфраструктуры, направьте его на локальный экземпляр Ollama.

С чего начать¶

docker run --rm -it \
  -e GITLAB_TOKEN=your_token \
  ghcr.io/bedrock-python/mr-review \
  review --preset thorough --mr-url https://gitlab.com/org/repo/-/merge_requests/42

Полная документация: bedrock-python.github.io/mr-review.