Ревью кода с ИИ означает, что вторая модель читает код, написанный агентом, и сообщает о проблемах. Ловушка работы с агентами — скорость: агент за один ход меняет десятки файлов, а читать всё построчно значит отдать время, которое агент сэкономил. Шаг ревью закрывает этот разрыв: результат агента проходит второй взгляд, прежде чем на него посмотрите вы.
В этой статье: как организовать ревью результата агента, как взвешивать находки и как держать цикл ревью под контролем.
Зачем отдельно проверять результат агента?
Агент, который написал код, слеп к собственным допущениям. Когда он помечает правку «готово», он часто упускает:
- Отсутствие отката или очистки на путях ошибок
- Граничные случаи: пустой ввод, параллельные запросы, таймауты
- Безопасность: токены, пригодные для повторного использования, непроверенный ввод
- Неиспользуемые импорты, мёртвый код, непоследовательные имена
Вторая модель, которая читает тот же код со свежим контекстом и смотрит только на diff, замечает это легче.
На что смотрит хорошее ревью кода с ИИ
Находки полезны, только если по ним можно действовать. В хорошей находке есть:
| Часть | Пример |
|---|---|
| Серьёзность | Высокая, средняя, низкая |
| Место | src/auth/session.ts:88 |
| Проблема | «Новый токен выдаётся до отзыва старого». |
| Почему это важно | «Повторное использование токена не обнаруживается». |
Серьёзность задаёт приоритет. Место ведёт прямо к нужной строке. Расплывчатые комментарии вроде «улучшить код» бесполезны.
Когда проводить ревью
Три подхода:
- Автоматически после каждого хода. Ревью стартует, как только агент завершил ход, так что проблемы ловятся, пока у агента ещё есть контекст.
- Перед слиянием. Проверка всего diff до того, как ветка попадёт в основную.
- По запросу. Ревью коммита или рабочего дерева, в котором вы не уверены.
С агентами первый способ экономит больше всего времени, потому что проблемы всплывают до того, как перейдут в следующий ход.
Автоматическое ревью кода в AgentVera
Ревью кода в AgentVera включается в настройках проекта и появляется на вкладке Reviews правой панели:
- Включите автоматическое ревью в настройках проекта и выберите модель Claude.
- Выберите, что проверять: коммиты хода или все изменения.
- Выберите, возвращать ли находки агенту.
- Когда агент заканчивает ход, запускается ревью; находки перечислены с серьёзностью и ссылками file:line.
Рабочее дерево, staged-изменения или отдельный коммит можно проверить и вручную.
Ограничьте цикл обратной связи
Автоматически возвращать находки агенту заманчиво, но бесконечный цикл рискован: агент исправляет одну проблему и создаёт другую, ревью её находит, и так по кругу. Поэтому AgentVera ограничивает обратную связь не более чем двумя раундами подряд. Дальше решение за вами.
Как взвешивать находки
Принимать каждую находку не обязательно. Практический порядок:
- Высокая: риски безопасности и потери данных. Чините до слияния.
- Средняя: пути ошибок, отсутствующие тесты. Обычно дёшево исправить в том же ходе.
- Низкая: стиль, неиспользуемые импорты. Наводите порядок пакетом или автоматическими инструментами.
Смело отклоняйте ложные срабатывания. Проверяющая модель тоже может ошибаться; контекст лучше всех знаете вы.
Сочетайте ревью с другими страховками
Одного ревью недостаточно. Оно сильнее вместе с:
- Тестами: ревью ловит логические ошибки, тесты ловят ошибки поведения.
- Ходами: если ревью показало, что ход пошёл не туда, отмените его через ходы (turns).
- Уведомлениями: получайте сообщение в Telegram, когда появляется важная находка.
- Flows: добавьте агента ревью или тестирования после агента-исполнителя.
Пример отчёта о ревью
За один ход агент добавил поток refresh-токенов и сделал три коммита. Когда ход закончился, ревью выдало:
| Серьёзность | Находка | Место |
|---|---|---|
| Высокая | Повторное использование refresh-токена не обнаруживается; новый токен выдаётся до отзыва старого. | src/auth/session.ts:88 |
| Средняя | Транзакция базы данных не откатывается на пути ошибки. | src/auth/store.ts:41 |
| Низкая | Неиспользуемый импорт. | src/auth/index.ts:3 |
Что с этим делать?
- Отправьте высокую находку агенту. Это проблема безопасности, а у агента ещё есть контекст, так что исправление обойдётся дёшево.
- Добавьте среднюю находку в тот же ход. Поведение на пути ошибки нужно покрыть тестом; попросите агента его написать.
- Отложите низкую находку в пакет. Ею займётся линтер или следующая уборка.
Когда агент всё исправит, ревью запустится снова. Если после второго раунда находки остаются открытыми, автоматический цикл останавливается, и решение за вами.
Выбор модели и охвата ревью
У ревью тоже есть цена. Проверять каждый ход самой сильной моделью может быть дорого. Практический подход:
- Для обычных ходов выберите более быструю и дешёвую модель Claude.
- Перед слиянием подумайте о ручном ревью всего diff более сильной моделью.
- Ограничение охвата коммитами хода сохраняет небольшой проверяемый diff; ревью всех изменений заодно ловит незакоммиченную работу.
Возвращайте выводы ревью в роль агента
Если вы снова и снова видите в находках одни и те же паттерны, перенесите их в роль агента. Если ревью постоянно отмечает отсутствие тестов на путях ошибок, добавьте строку вроде этой:
For every new function, write at least one error-path test next to the happy-path test.Тогда одна и та же проблема перестанет появляться в каждом ходе: агент предотвращает её заранее. Со временем отчёты становятся короче, а важные находки лучше заметны.
Полезно читать ревью вместе с историей. Поиск по разговорам в AgentVera выполняет полнотекстовый поиск по всем разговорам Claude и Codex, так что можно найти сессию, где проблему обсуждали раньше, и продолжить её в новом агенте.
Чек-лист
- Включено ли автоматическое ревью в настройках проекта?
- Подходит ли охват ревью (коммиты хода или все изменения) вашей работе?
- Закрыты ли находки высокой серьёзности до слияния?
- Ограничен ли цикл обратной связи?
- Запускались ли тесты независимо от ревью?
Подводим итоги
Ревью кода с ИИ позволяет пользоваться скоростью агентов, не жертвуя качеством. Вторая модель, читающая код после каждого хода, ловит проблемы, пока у агента ещё есть контекст, а находки с серьёзностью и местом подсказывают, куда смотреть в первую очередь.
В AgentVera ревью включается для каждого проекта, а находки отправляются агенту одним кликом. Используйте его вместе с шагами слияния из статьи git worktree для параллельных агентов или начните с бесплатного тарифа.