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

Как ревьюить код, который написал ИИ-ассистент: ритуал на один пул-реквест

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

Сначала всё выглядит прилично. Ассистент выдаёт патч в стиле проекта, старые тесты проходят, пул-реквест открывают в тот же день. Двое пролистывают дифф, который сами не проектировали. Через неделю коллега садится дописывать эту ветку и не может ответить на простые вопросы: зачем она вообще, что случится на пустом входе, какое ограничение модели выпало по дороге.

Фича на месте. Владение рассуждением, из которого она выросла, — нет.

Тренер по ИИ Ромен Байёль из Монпелье, обучивший больше 2500 руководителей и сотрудников работе с генеративным ИИ, назвал этот паттерн в 2025 году словом ipromptisme: ситуация, когда промпт и бойкий черновик подменяют собой работу мысли, проверки и решения. Ниже — инженерная версия той же идеи: метод ревью, который стоит прогнать до того, как ассистент появится у всей команды.

Черновик — это не защита дизайна

Ассистент хорошо имитирует стиль проекта. Само по себе полезно. Проблема начинается в момент, когда черновик становится дизайном.

В здоровом ревью кто-то вслух отвечает на четыре вопроса:

  • Какую задачу мы решаем — одной фразой?
  • От чего мы отказались и почему?
  • Что может сломаться именно в этой кодовой базе?
  • Как мы поймём после мержа, что ошиблись?

Когда первый набросок приходит от модели, эти вопросы всплывают поздно или не всплывают совсем. Промпт уже «решил» тикет. Человеку остаётся уборка: переименовать переменную, принять линтер, добавить комментарий. Уборка — не ревью. Уборка — это типографика.

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

Лечится не запретом ассистента, а переносом рассуждения вперёд, к моменту мержа, и тренировкой этой привычки до широкого раската.

Что именно ломается, когда модель пишет первой

Разговор о дизайне не случается. Модель предлагает подход, альтернативы никто не записывает. Через полгода подход становится «так у нас принято», без следов того, почему. Это не долг по документации, это отсутствующее решение.

Планка «достаточно хорошо» сползает к «компилируется и старые тесты зелёные». Эти тесты писали под прежнюю форму кода. Новую ветку, которую только что придумала модель, они, как правило, не проверяют. Зелёный пайплайн необходим, но он не заменяет ревьюера, способного объяснить изменение.

И третье, самое заметное. Автор не может защитить неожиданную строку. Вопрос простой: покажи десять самых странных строк в диффе и скажи, почему они там. Если для ответа нужно заново прогнать промпт — изменением пока не владеют.

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

Ритуал, который укладывается в один пул-реквест

Метод намеренно маленький. Его надо применять на следующем пул-реквесте, а не после полугодовой программы по внедрению ИИ.

  1. Сформулируйте замысел своими словами — до того, как вставите промпт. Короткий абзац рукой человека в тикете или в шапке пул-реквеста: задача, выбранный подход, от чего отказываемся. Если абзац не пишется без подглядывания в вывод модели, генерировать код рано.
  2. Генерируйте только после этого абзаца. Относитесь к выводу как к черновику от быстрого джуна, который ни разу не был на дежурстве по этой системе. Полезно, иногда впечатляюще, доверять пока нельзя.
  3. Разметьте неожиданное. До запроса на ревью отметьте строки, которых знающий коллега не ждал бы. К каждой — одно предложение: почему она здесь и что вы проверили. Не получается объяснить — перепишите строки сами или вернитесь к абзацу о замысле.
  4. Ревьюер играет оппонента, а не корректора. Его задача — оспорить абзац о замысле, найти отсутствующий тест на новом пути и попросить автора защитить странные строки, не открывая ассистента. Если для объяснения нужна модель, изменение не готово.
  5. Добавьте одну проверку, которой не было до черновика. Юнит-тест, свойство, ассерт в логах, ручной шаг в тикете — что угодно, что проверяет именно новое поведение, а не перезапускает уже зелёный набор. Не придумывается — значит, непонятно, что черновик изменил.

В первый день это медленнее, чем «промпт, применить, мерж». Через три недели — быстрее, чем разбирать изменение, которое никто не может объяснить.

Два режима рядом

Промпт → применить → мержЗамысел → черновик → аннотации → ревью
Кто формулирует задачумодель внутри промптачеловек до генерации
Что проверяет ревьюеримена, стиль, линтерзамысел, новые ветки, отброшенные ограничения
Что остаётся в историидифф без объясненийабзац о замысле, аннотации, новый тест
Цена в первый деньнизкаязаметно выше
Цена через месяцкод, который страшно трогатькод, который можно продолжить

Порядок внедрения: сначала привычка, потом лицензии

Самая частая и самая неправильная последовательность: сначала закупили лицензии, потом ланч-энд-лерн с удачным примером, а к понедельнику все обязаны стать быстрее. Так тренируют скорость. Суждение не тренируется.

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

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

Новая платформа для этого не нужна. Нужен один ответственный, одна неделя и записанное правило.

Пул-реквест, автор которого не может защитить неожиданные строки, не мержится — даже если пайплайн зелёный.

Если ассистент уже везде, заморозьте привычку «промпт и сразу мерж» на неделю в одной команде, прогоните ритуал и сделайте его нормой.

Где ритуал избыточен

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

И полезно помнить, чего ритуал не делает. Он не требует писать каждую строку руками: ассистент хорош на бойлерплейте, на разведке незнакомого API, на первом наброске формы. Более точный промпт действительно улучшает черновик. Он не заменяет человека, который может сказать, почему изменение приемлемо.

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

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

← На главную

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

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

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

же ка 11.11.2026 05:05 ▲ 0
ИИ действительно может ускорить подготовку кода, но гладкий дифф ещё не означает, что автор понимает и контролирует изменение.
Сергей Марков 11.11.2026 21:31 ▲ 0
Мы наступили на эти грабли в прошлом квартале: модель выдала идеальный дифф, тесты зелёные, а через месяц никто не мог объяснить, почему в сервисе появился новый стейт-машина. Взяли ваш ритуал в работу с одним изменением: теперь до промпта автор пишет абзац о замысле прямо в тикете, а ревьюер обязан найти три неожиданные строки и спросить о них без открытия Copilot. Первый пул-реквест шёл мучительно долго, зато следующий на том же модуле — в два раза быстрее обычного, потому что контекст не пришлось восстанавливать с нуля. Добавили к пятому шагу (новая проверка) обязательное правило: если черновик касается платежей или миграций схемы, в PR автоматически падает чек-лист из пяти пунктов. Без галочек — блокировка мержа. Это отлично отсекает "бойкий черновик" там, где цена ошибки слишком высока. ipromptisme лечится только тренированным трениям на ревью.
Личный опыт

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

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

Слогер 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