AI-агент меняет слишком много файлов: как сузить diff

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

Разберём рабочий случай

В учебном магазине попросили исправить округление скидки. Агент заодно переименовал компоненты, обновил библиотеку дат и отформатировал каталог. Проверить денежную ошибку среди восьмисот строк стало сложнее. Требование «делай аккуратно» не объясняет, какие соседние улучшения разрешены. Начните с расчёта цены и существующего теста, который воспроизводит ошибку; косметические изменения вынесите в отдельную задачу.

Что изменить

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

Как проверить результат

Полезный вопрос на ревью: какое пользовательское требование перестанет выполняться, если убрать эту строку? Если ответ связан только с личным предпочтением агента, изменение стоит обсудить отдельно от исправления.

Маленький diff не заменяет проверку поведения. Ошибка в одной строке авторизации может быть опаснее большого переименования. Критерий здесь — объяснимость изменений и возможность проверить денежный результат.

Если AI регулярно превращает небольшой баг в большой рефакторинг, полезно освоить постановку ограничений и ревью изменений. В платном курсе Vibecoding: Claude Code, Codex, Cursor и agentic development можно продолжить изучение соответствующего инженерного направления. Перед покупкой сравните программу и открытые материалы со своей задачей.

Документация для проверки технических деталей: Документация git diff.

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