Код от агента, который вы не проверили, — это работа, которую вы отдали коллеге

Практика командной работы. Главное правило вежливости в эпоху кодинг-агентов.

· 2 мин чтения

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

Если вы открываете запрос на изменение с сотнями строк, которые написал агент, и сами не убедились, что они работают, — вы не сделали работу. Вы переложили её на того, кто будет проверять. Как пишет Уиллисон: они могли бы сами попросить агента. Какую ценность тогда добавили вы?

Почему это стало проблемой именно сейчас

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

Команда OpenClaw описала ту же проблему со своей стороны. Любой запрос на изменение теперь выглядит одинаково: код написан ИИ, описание написано ИИ, всё звучит уверенно. По самому запросу не понять, потратил ли автор часы на продумывание крайних случаев или написал агенту «почини» и отправил первый результат.

Как выглядит хороший запрос на изменение

По Уиллисону:

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

Докажите, что вы проверили

Уиллисон советует прикладывать доказательство проделанной работы:

  • заметки о том, как вы проверяли вручную;
  • комментарии к спорным решениям в коде;
  • скриншоты или видео, где новая функция работает.

Команда OpenClaw пошла дальше: к запросу на изменение можно приложить расшифровку разговора с агентом (без личного). Проверяющий видит, как автор думал, какие варианты отбросил, где спорил с агентом. Разговор часто ценнее самого кода.

То же вне программирования

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

  1. Прочитайте сами. Целиком.
  2. Проверьте цифры и имена по первоисточнику.
  3. Уберите то, что вы не можете объяснить, если спросят.
  4. Если документ большой — разбейте на части, которые можно проверить по отдельности.

Агент ускоряет вашу работу. Но ответственность за результат по-прежнему на том, кто его отправил.