Модуль 2 · Качество · урок 5 из 13
Ревью при росте потока MR
После внедрения агента команда первым делом жалуется обычно на очередь на ревью, а уже потом на качество кода. MR стало больше, они крупнее, а внимательно читать чужой дифф по-прежнему тяжело. Если ничего не менять, ревью либо превратится в формальность, либо станет пробкой. Ниже о том, как перестроить процесс, чтобы избежать обоих исходов.
Почему ревью становится узким местом
Агент удешевляет создание изменения, но разбираться в нём быстрее не помогает. Команда OpenAI, строившая продукт полностью руками агентов, описывает, как узким местом стал человеческий QA. В ответ она сделала интерфейс, логи и метрики доступными самому агенту (Harness engineering). Авторы спецификации Symphony указывают ещё на один предел: большинству людей комфортно вести 3–5 параллельных сессий с агентами, дальше продуктивность падает.
Вывод для тимлида простой. Пропускная способность команды теперь упирается в скорость проверки, скорость написания её больше не ограничивает. Оптимизировать нужно проверку.
Правило первое: автор отвечает за MR
Кто запустил агента, тот и автор MR со всеми обязанностями. Прежде чем звать ревьюера, он:
- сам прочитал весь дифф и может объяснить каждое изменение;
- запустил тесты и проверил поведение на стенде, в браузере или на устройстве;
- прогнал локальное ревью командой
/reviewи разобрал находки; - убрал лишнее: случайные правки форматирования, отладочный код, файлы не по задаче.
Отдавая коллеге непроверенный код агента, автор перекладывает на него свою работу. Как ревьюить такой код самому, разобрано в уроке «Как ревьюить код, написанный агентом».
Правило второе: маленькие MR
Агенту всё равно, сколько файлов менять, ревьюеру не всё равно. Договоритесь о верхней границе размера MR и проверяйте её в CI (пример есть в уроке «Ворота качества»). Крупную задачу агент может разбить сам:
Разбей эту задачу на последовательность независимых MR,
каждый из которых можно проверить и смёржить отдельно.
Для каждого укажи: что меняется, как проверить, от какого зависит.Бывает, что без большого MR не обойтись, например при массовом переименовании. Тогда отделите механическую часть от смысловой. Механический MR проверяют скриптом и выборочно, смысловой читают внимательно.
Шаблон описания MR
Ревьюер должен за минуту понять, что изменилось и чему можно верить. GitLab подхватывает шаблоны из .gitlab/merge_request_templates/:
## Что и зачем
Карточка: <ссылка>. Одно-два предложения о сути изменения.
## Как проверено
- [ ] Тесты: какие добавлены, какие запускались
- [ ] Ручная проверка: где и какой сценарий
- [ ] Что НЕ проверено и почему
## Участие агента
- [ ] Код написан с агентом, автор прочитал весь дифф
- Что агент делал сам, что правилось вручную
## На что смотреть ревьюеру
Места, где автор не уверен, и решения, которые стоит обсудить.Самый ценный раздел здесь «Что НЕ проверено». Он честно показывает риск и подсказывает ревьюеру, куда смотреть.
Уровни ревью по риску
Одинаково тщательное ревью для всех MR команда больше не может себе позволить. Разделите изменения по риску и договоритесь о правилах для каждого уровня.
| Уровень | Примеры | Ревью |
|---|---|---|
| Низкий | Тексты, стили, тесты, документация, правки по шаблону | Ревью-агент + один человек, можно выборочно |
| Обычный | Фичи и баги в бизнес-логике | Ревью-агент + один человек полностью |
| Высокий | Оплата, авторизация, персональные данные, миграции БД, инфраструктура | Ревью-агент + два человека, один из них владелец области |
Уровень определяют по путям файлов. В GitLab для этого есть файл CODEOWNERS и правила одобрения, которые требуют подтверждения владельца при изменении определённых каталогов. Обязательное одобрение владельцев кода доступно не во всех редакциях GitLab, так что проверьте свою. Правила ревью для агента по тем же путям лежат во вложенных AGENTS.md (см. «Командные стандарты»).
Разделение обязанностей
Агент хорошо делает первый проход: ищет ошибки, пропущенные проверки, несоответствие соглашениям. Ревью-агент в Codex нацелен на серьёзные проблемы, в документации говорится о приоритетах P0 и P1 (GitHub). Человек отвечает за то, что агент оценить не может: соответствует ли изменение задаче и замыслу продукта, не усложняет ли оно архитектуру, поймёт ли его будущая команда.
Два правила стоит закрепить явно:
- Агент не одобряет MR и не мержит его. Одобрение остаётся за человеком, защита веток тоже.
- Код, написанный агентом, проверяет не тот же агент в той же сессии. Отдельный ревьюер, будь то другой человек или хотя бы отдельный запуск ревью, видит то, что автор пропустил. В исследовании OpenAI ревью-агент находил, что исправить, даже в коде, полностью написанном Codex (OpenAI Alignment).
Подробно о настройке ревью-агента рассказано в уроке «Codex как ревьюер в GitLab и GitHub».
Ритм команды
- Время до первого ревью закрепите как договорённость, например в пределах рабочего дня, и измеряйте его в GitLab.
- Заведите ревью-слоты: ревьюеры не прерываются на каждый MR, они проверяют пачкой два-три раза в день.
- Ограничьте незавершённую работу. Если у автора три MR ждут ревью, четвёртую задачу он не запускает и помогает с ревью. Иначе очередь растёт бесконечно.
- Ротируйте ревьюеров, чтобы не все MR уходили одному сеньору. Через ревью распределяется знание о коде, и для джуниоров это особенно важно.
Что делать с советами «убрать гейты»
В статье OpenAI о harness engineering команда сознательно держит минимум блокирующих проверок и почти всё ревью доверяет агентам. Авторы сами оговариваются: в среде с низкой пропускной способностью такой подход был бы безответственным, а поведение их агентов сильно зависит от инструментов конкретного репозитория. Агентству с клиентскими продуктами копировать эту модель не стоит, но как ориентир она полезна. Проверки при этом не убирают, их переносят в автоматику, чтобы человек тратил внимание на то, что машина проверить не может. Подробнее в уроке «Когда агентов много: мерж и ревью».
Попробуйте сами
10–15 мин на рабочем месте- Добавьте шаблон описания MR в
.gitlab/merge_request_templates/Default.mdсвоего проекта и попросите команду пользоваться им неделю. - Посмотрите последние 20 MR: сколько из них превышают договорённый размер? Какие можно было разбить?
- Составьте для своего проекта таблицу уровней риска по каталогам и сверьте её с CODEOWNERS.
Коротко
- Пропускная способность команды теперь упирается в проверку кода, а не в его написание.
- Автор, запустивший агента, сам проверяет дифф и поведение до ревью.
- Маленькие MR и шаблон описания с разделом «что не проверено» экономят время ревьюеров.
- Тщательность ревью зависит от риска изменения, уровни задаются по путям файлов.
- Агент не одобряет и не мержит, а код агента проверяет независимый ревьюер.