Слогер Создать блог
Разработка

Как ревьюить код ИИ-агента, когда читать каждый дифф уже бессмысленно

Агент перестаёт быть просто переводчиком: он заполняет пробелы в задаче и принимает решения. Разбираем, что проверять вместо построчного чтения диффа.

Если агент пишет код в вашем репозитории, однажды вы ловите себя на странном занятии. Открываете pull request и вместо построчного чтения ищете, где там могла быть принята неочевидная идея. Потом ловите себя ещё раз: тесты зелёные, имена нормальные, код чистый. Читать дальше как будто нечего.

У меня так вышло на небольшом встроенном проекте на C. Агент писал код, местами с паттернами, которых я раньше не использовал. Сначала я вёл себя как на продакшене: маленькие pull request, каждый прочитан построчно. Потом заметил, что код хороший, и перешёл на тесты. Потом — на вопросы. Почему выбрана такая архитектура и такой порядок, что будет, если соединение оборвётся на середине. Если одно и то же сообщение придёт дважды. Я проверял ответы. Они сходились. Каждый раз.

Вот тут и начинается неприятная часть. Я не помню, когда последний раз смотрел, что выдаёт компилятор. На этом проекте я незаметно начал так же относиться к агенту. Хорошо это или нет — вопрос не про качество модели. Он про то, что именно вы проверяете и кто делает эту работу, если не вы.

Дифф проигрывает по скорости

За лето число изменений в моих репозиториях выросло больше чем вдвое. Медианное изменение при этом держалось около 35 добавленных строк. Маленькие шаги помогали читать каждый отдельный diff. Они не помогали читать общий поток.

Арифметика простая. Агент делает чистое изменение за несколько минут. У меня нормальное чтение занимает минут десять. Соотношение уходит в одну сторону. Можно ускоряться, можно читать выборочно, можно делать вид, что «просмотрел достаточно». Дифф от этого не становится местом, где вы ловите главные ошибки.

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

Агент — не компилятор

Соблазн назвать агента следующим компилятором был и у меня. Аналогия почти держится. Почти.

Обычное возражение — детерминизм. Компилятор на один и тот же исходник выдаёт один и тот же результат. Агент на один и тот же промпт может выдать две разные программы. Это правда. И это менее важно, чем кажется.

Компилятор ничего не решает. Исходный код — полная спецификация программы: каждое поведение в нём описано, компилятор только переводит. Промпт, план, двухчасовая сессия с агентом — не полная спецификация. Большая часть того, что попадает в код, никогда не проговаривалась. Агент заполняет пробелы. Каждый заполненный пробел — решение.

Пример: в задаче с дедупликацией никто не просил, чтобы запись из федерального регистра и запись из роуминговой сети несли одно и то же имя оператора. Агенту нужна была пара записей. Он её написал. Написать пару — значит решить, как выглядит настоящая пара. Он решил неверно и при этом разумно. Детерминированный агент принял бы то же решение на каждом запуске. Воспроизводимо ошибаться — не улучшение.

Компилятор переводит. Агент переводит и решает, и не говорит, где какое.

Почему компилятору доверяют, а агенту пока нет

Доверие к компиляторам не появилось само. Его строили десятилетиями. Когда IBM в 1957 году выпускала первый компилятор Fortran, команда ожидала, что программисты отвергнут его, если сгенерированный код не будет работать почти так же быстро, как рукописный ассемблер. На это ушло много сил.

Компиляторы до сих пор не идеальны. Исследователи из Университета Юты три года скармливали случайные C-программы мейнстримным компиляторам, включая GCC и LLVM, и нашли больше 325 неизвестных багов. Каждый протестированный компилятор можно было заставить упасть. Каждый тихо выдавал неверный код на валидном входе. В лекции 1984 года Кен Томпсон показал, что компилятор может спрятать бэкдор, которого нет ни в одном исходнике, и закончил жёстко: «Вы не можете доверять коду, который не создали полностью сами».

И всё равно мы доверяем. Потому что кто-то другой проверяет: спецификации языка, большие наборы тестов, фаззеры вроде того, что был в Юте, миллионы программ, которые сломаются громко, если компилятор ошибётся. Я не читаю ассемблер, потому что эту работу где-то делает кто-то другой. Не я. С агентами мне как раз не хватало этого «кого-то другого».

Что сравниваемКомпиляторИИ-агент
ВходПолный исходный кодПромпт, план, сессия; часть решений не проговорена
Что делаетПереводитПереводит и заполняет пробелы допущениями
ПовторяемостьОдин исходник — один результатОдин промпт — разные программы; детерминизм не убирает неверные допущения
Кто проверяетСпецификации, тесты, фаззеры, чужие программыВторой ревьюер, тесты и ваши вопросы; допущения часто остаются невидимыми

Что делать вместо построчного чтения

Если вы перестаёте читать дифф, должны случиться две вещи. Перевод должен проверять кто-то другой. А решения должны стать видимыми, потому что именно они остаются предметом вашего ревью.

Просите список допущений. В конце сессии попросите агента перечислить всё, что он предположил без вашего указания: о данных, о вызывающем коде, о том, что можно безопасно игнорировать. Список обычно короткий. В нём часто есть ровно один пункт, с которым вы бы не согласились. С этого списка и начинайте ревью.

Выбирайте изменения случайно. Одно из десяти, выбранное не по «риску», а наугад. Читайте по-старому: в IDE, рядом с сессией, построчно. Если описание и код расходятся, доверие падает, и какое-то время читайте всё. Так работает аудитор. Заодно руки не забывают ремесло.

Держите второго ревьюера. У меня каждый pull request дополнительно смотрит другая модель, GitHub Copilot. Она находит больше меня. С более новыми моделями, которые пишут код, находит всё меньше. Остаются странные краевые случаи: несколько маловероятных событий в неудачном порядке. Это не те ошибки, которые я ловил раньше — неверное условие цикла или счётчик, съехавший на единицу. Такие я больше не вижу. Похоже, другой модели уже можно отдать роль лучшего ревьюера. По крайней мере, в моём случае.

Оставляйте решение за собой. После находки остаётся вопрос: стоит ли это чинить? Часто нет. Настоящее исправление редкой гонки может добавить блокировку, состояние и путь повторной попытки. Сложность обойдётся дороже, чем сама гонка. Дешёвый вариант — обнаружить случай и упасть с понятной ошибкой. Это решение, и оно приходит из опыта жизни со сложностью, которая не окупилась.

Когда такой подход не подходит

  • В коде есть предметная логика, которой нет в сессии: правила рынка, договорённости между системами, странности данных. Агент не знает, что федеральный регистр и роуминг никогда не называют оператора одинаково. Пока вы это не записали, он будет угадывать.
  • Цена ошибки высока, а внешней проверки нет. Если неверное допущение тихо живёт в проде месяцами, выборочного чтения мало. Нужен полный разбор решений и данных.
  • Вы сами ещё не понимаете задачу. Агенту придётся заполнять слишком много пробелов. Сначала сформулируйте, что считается правильным результатом, потом отдавайте код.

Что остаётся

Дифф не исчезает. Он перестаёт быть главным уровнем проверки. Навык читать код и чувствовать, где что-то не так, уходит туда же, куда ушло чтение шестнадцатеричных дампов. Это не трагедия. Но уровень выше требует других знаний: что два источника никогда не совпадут в названии, что комментарий капсом — предупреждение, что придуманная кем-то фикстура ничего не доказывает про реальный мир.

Часть этого пришла из написания кода. Большая часть — из моментов, когда мир отказывался совпадать с кодом, который я написал. Научит ли сборка с агентом этой второй части, я пока не знаю. Наблюдаю.

Пока вывод простой. Перевод можно доверить проверке. Решения придётся оставить себе. И искать дорогие ошибки там, где они всегда были: в допущениях, которые никто не заметил, что принимает.

По материалам: career. Текст переработан редакцией Слогера.

← На главную

Рекламное место — Конец поста
Реклама · Слогер

Комментарии (1)

Войдите, чтобы комментировать.

Arham Hossain 14.11.2026 08:27 ▲ 0
Очень интересный разбор! Особенно понравилась мысль о том, что важно проверять не каждую строчку кода, а общую логику и результат работы ИИ-агента. Полезная и актуальная тема!
Личный опыт

Как довести до конца одно незаконченное дело: метод одной даты

Назвать брошенный проект конкретными словами, поставить реальную дату и договориться с кем-то, кто спросит один раз. Разбор простой механики, которая чаще срабатывает, чем очередной таск-менеджер.

Слогер 19.11.2026 ▲ 0
Карьера

Как автоматизировать отклики на вакансии: разбор автозаполнения заявок на Greenhouse, Lever и Ashby

Расширение для Chrome берёт на себя формы, которые вы заполняете десятый раз подряд, — но работает только на трёх системах найма и требует собственных ответов. Разбираем механику, цену и границы.

Слогер 18.11.2026 ▲ 0
Карьера

Как выбрать между двумя офферами на стажировку: разбор по шагам

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

Слогер 18.11.2026 ▲ 0
Fluxs lenta
Реклама · fluxs.ru
Стартапы

Fluxs включён в реестр российского ПО Минцифры России

🇷🇺 **Fluxs официально включён в реестр российского ПО!** Наша платформа для управления бизнесом вошла в Единый реестр российских программ Минцифры России. Это важный этап развития Fluxs и новые возможности для сотрудничества с российскими компаниями, банками и организациями, заинтересованными в импортозамещении.

Слогер 17.11.2026 ▲ 0
Разработка

Как получить от клиента согласование сайта на staging: чек-лист приёмки

Устное «выглядит хорошо» в мессенджере не защищает никого: через месяц не вспомнить, что именно смотрели и на какой версии. Вот как превратить просмотр staging в нормальную запись о приёмке.

Слогер 17.11.2026 ▲ 0
Карьера

WARN Act: как работает закон о сокращениях и что делать, если уведомление не пришло

Федеральный WARN Act обязывает крупных работодателей предупреждать о закрытии предприятия или массовом сокращении за 60 дней. Разбираем пороги, исключения и порядок действий — на примере отрасли вывоза и переработки отходов, где сокращения легко пропустить.

Слогер 17.11.2026 ▲ 0
Fluxs lenta
Реклама · fluxs.ru
Карьера

Как читать WARN-уведомления о сокращениях: разбор календаря увольнений на 2027 год

Пересчёт уведомлений с датами вступления в силу в 2027 году дал 4 950 человек вместо 2 882 — и это всё ещё нижняя граница. Разбираем, откуда берётся разница в 42% и как не обмануться такой статистикой.

Слогер 17.11.2026 ▲ 0
Разработка

Заменит ли ИИ программиста: что показывают исследования и как выбрать между ИИ и разработчиком

Вопрос «зачем платить разработчику, если ИИ пишет код» построен на неверном представлении о работе программиста. Разбираем два исследования, цену такого заблуждения и практический чек-лист.

Слогер 17.11.2026 ▲ 0
Стартапы

Почему сотрудники забывают задачи и как это исправить | FLUXS

📌 **Почему сотрудники забывают поручения, даже когда всё записано?** Задача поставлена. Сотрудник записал. Срок прошёл. Результата нет. Такая ситуация встречается часто, и часто проблема не в дисциплине, а в отсутствии прозрачной системы управления задачами. Кто исполнитель? Какой срок? На каком этапе работа? 🚀 **FLUXS помогает управлять поручениями и выстраивать бизнес-процессы под правила вашей компании.** А встроенный ИИ-ассистент помогает создавать и настраивать процессы выполнения задач. 👉 Попробуйте конструктор бизнес-модели: https://fluxs.ru/konstruktor-biznes-modeli #FLUXS #УправлениеЗадачами #АвтоматизацияБизнеса #БизнесПроцессы

Слогер 16.11.2026 ▲ 1
Fluxs lenta
Реклама · fluxs.ru
Карьера

Как делиться опытом, если вы не эксперт: ловушка «об этом уже написали» и рабочие форматы

Мешает делиться знаниями не их дефицит, а мысль, что они недостаточно весомые. Разбираем, что считать полезным вкладом, как писать конкретно и с чего начать без давления.

Слогер 16.11.2026 ▲ 0