DF-ИИ-043 · ИИ в работе команды
Код нагенерили, а до релиза дошло меньше: что проверить
- Как отличить принятое изменение от отклонённого по решениям ревью
- Как фиксировать причины отсева, чтобы они не терялись
- Какие автоматические проверки в репозитории ставить до слияния
- Чек-лист решения по каждому изменению перед релизом
ИИ-помощник за день предлагает десяток правок, а в продакшен уходит две-три. Вопрос не в том, почему так мало, а в том, понимаете ли вы, почему остальные не прошли. Если ответ «не подошли» — вы не управляете отсевом, а надеетесь на память ревьюеров.
Ниже — порядок, который делает отсев видимым: где сгенерированный код отсеивается, как записать причину в самом ревью, какие проверки в репозитории отделяют принятое от отклонённого и что сверить перед слиянием. Это редакционный чек-лист Deskforge, а не отчёт об испытании продукта и не клиентский кейс: шаги нужно адаптировать к вашему стеку и вашим правилам.
Смежные темы — какие изменения от ИИ требуют ревью и автотестов и вайб-кодинг без потери контроля, а варианты работ с ИИ собраны на странице автоматизации процессов.
Где сгенерированный код отсеивается до релиза
Первая точка отсева — ревью pull request. По документации GitHub ревью позволяет комментировать изменения, предлагать улучшения и одобрять их или запрашивать доработку до слияния кода. То есть у проверяющего есть не только «да/нет», но и место, где причина отказа остаётся видимой.
Вторая точка — само решение ревью. При отправке ревью проверяющий выбирает одно из решений: Comment, Approve или Request changes. Это уже не свободный текст, а признак, по которому можно считать, сколько изменений принято, а сколько отправлено на доработку.
Третья точка — что происходит с замечаниями. Решение Request changes отмечает замечания, которые автору следует устранить до слияния. Если замечание закрыли правкой, изменение проходит дальше; если нет — оно остаётся за релизом. Разница между «приняли» и «отклонили» видна именно здесь, а не в общем впечатлении от кода.
Практический вывод: отсев происходит не в момент, когда ИИ выдал код, а в момент, когда человек принял решение по ревью. Всё, что до этого, — черновик.
Как зафиксировать причины отсева в решениях ревью
Причина «не подошло» бесполезна: по ней нельзя ни посчитать отсев, ни понять, что менять в промптах и правилах. Решение ревью даёт каркас, но причину всё равно нужно назвать словами — в комментарии к ревью.
Рабочий приём — короткая формула причины в комментарии: что именно не так и что должно быть иначе. Например: изменение затрагивает обработку входных данных без проверки на пустое значение; нужно добавить проверку и тест на этот случай. Такая запись превращает отказ в задачу, а не в мнение.
Синтетический пример, чтобы показать формат, а не результат: помощник предложил правку в функции расчёта скидки. Ревьюер оставил Request changes с комментарием, что не покрыт случай нулевого количества, и попросил добавить тест. Автор дополнил изменение и тестом, и проверкой — повторное ревью дало Approve. Это иллюстрация формата записи, а не чей-то реальный кейс и не измеренный эффект.
Чтобы причины не терялись, полезно договориться о нескольких повторяющихся категориях отказа: неполная логика, нет теста, затронуты чужие файлы, неясно, зачем изменение. Тогда по журналу ревью видно, чего чаще не хватает сгенерированному коду, и это уже повод править правила, а не ругать модель.
Автоматические проверки в репозитории перед слиянием
Ревью — человеческий фильтр, но часть отсева можно снять с людей. GitHub Actions позволяет автоматизировать, настраивать и выполнять рабочие процессы разработки прямо в репозитории. Это значит, что проверка запускается на изменение сама, а не по просьбе ревьюера.
Внутри рабочего процесса действия (actions) — это отдельные задачи, которые можно объединять в задания и настраивать под свой процесс. Сборка, линтер, тесты — каждая такая задача становится отдельным шагом, и его результат виден в репозитории рядом с изменением.
Зачем это для сгенерированного кода: помощник уверенно выдаёт правку, которая не собирается или ломает соседний модуль. Автоматическая проверка ловит это до человека, и ревьюер тратит время на смысл, а не на очевидные поломки. Отсев по техническим причинам отделяется от отсева по смыслу — и в журнале видно, где именно остановилось изменение.
Важная оговорка: успешный запуск проверки не доказывает, что код правильный. Он доказывает только, что проверка прошла. Что именно она проверяет и чего не покрывает — вопрос к настройке, а не к галочке «зелено».
Тесты как отдельный фильтр: требования и запуск
Тесты — самый частый автоматический фильтр, и здесь легко получить ложное спокойствие. Начнём с того, что тестовый инструмент имеет свои требования: Vitest требует Vite версии не ниже 6.4.0 и Node версии не ниже 22.12.0. Если окружение не совпадает, проверка может не запуститься вовсе — и это не «тесты прошли».
Второе — какие файлы вообще считаются тестами. По умолчанию файлы тестов Vitest должны содержать в имени .test. или .spec. Файл, названный иначе, в прогон не попадёт, и изменение пройдёт мимо проверки, хотя тест рядом лежит.
Третье — режим запуска. Чтобы запустить тесты Vitest один раз без отслеживания изменений файлов, используется команда vitest run. В режиме отслеживания процесс ждёт правок и не завершается сам — для проверки в репозитории нужен однократный прогон, иначе шаг повиснет и результат будет неясен.
Эти три пункта стоит сверить до того, как доверять зелёной галочке: подходящая версия окружения, правильные имена файлов, однократный запуск. Иначе фильтр есть, а отсева через него нет.
Чек-лист решения по каждому изменению
Соберём проверки в один проход по каждому изменению — от сгенерированной правки до решения о релизе. Это редакционная помощь читателю, а не отчёт об испытании продукта и не клиентский кейс.
- Изменение прошло ревью с решением Approve? В истории pull request есть отправленное ревью с таким решением.
- Есть ли открытые замечания Request changes? Все ревью с Request changes закрыты до слияния.
- Требуется ли одобрение для целевой ветки? В настройках защищённой ветки включено обязательное одобрение — администраторы репозитория могут требовать одобрения до слияния, что помогает защищать важные ветки и снижать число случайных слияний.
- Запускались ли автотесты на изменении? В рабочем процессе репозитория есть успешный запуск тестов.
- Тесты запускались однократно, а не в режиме отслеживания? Использована команда vitest run.
Если хотя бы один пункт не выполнен, изменение не готово к релизу — и причина отказа уже записана в ревью или в результате проверки. Так отсев перестаёт быть памятью ревьюера и становится журналом, по которому видно, что именно доходит до продакшена и почему остальное нет.