5 ловушек «тихого отказа» в автоматизации: звук р в логах есть, а работа не сделана

Автор материала, практик, который строит личную автоматизацию на ИИ-агентах Claude Code и Codex, столкнулся с «тихим отказом»: скрипт по расписанию выдавал бодрый лог с цифрами, счётчиками и временем выполнения, но главную задачу не делал. Причина оказалась системной. Доложить об успехе для кода дешевле, чем проверить, был ли успех. На этой разнице и живёт тихий отказ: проверка отвечает одинаково, когда всё исправно и когда сломано. Разобранных форм набралось пять, и к каждой прилагается контрольный вопрос, который годится не только для лога крона, но и для статуса подрядчика в трекере.

Что понадобится

• Терминал с доступом к cron (или любому планировщику задач)
• Текстовый редактор для правки скриптов (nano, VS Code, любой привычный)
• ИИ-агент, если вы генерируете скрипты через Claude Code, Codex или аналоги (YandexGPT, GigaChat для русскоязычных задач)
• 15 минут на ревизию каждого автоматического скрипта
• Лог-файл, куда пишет ваш крон, и доступ к нему на чтение

Пять ловушек и пять контрольных вопросов

1. Успех по умолчанию: что окажется в отчёте, если работа не сделана?

Бытовая аналогия: ребёнок на вопрос «уроки сделал?» отвечает «да» раньше, чем вопрос дозвучал. Ответ бодрый и одинаковый при любом состоянии уроков.

В утреннем скрипте автора схема была стандартной: сделать главное, собрать статистику, отчитаться. Главный шаг падал из-за протухшего токена (токен тут означает цифровой пропуск, по которому программа ходит во внешний сервис). Потом команда claude не находилась в PATH крона, потому что у крона свой, урезанный список каталогов, где он ищет программы. А статистика при этом собиралась и печатала настоящие цифры.

Настоящие цифры здесь самое обидное. Лог сломанного прогона выглядел живее исправного. Чем подробнее отчёт, тем убедительнее ложный успех.

Причина: переменная $? в оболочке хранит код возврата (число, которым программа сообщает, как всё прошло; ноль читается как «всё хорошо») последней выполненной команды. К моменту итогового отчёта последней была статистика, она отработала, и её ноль достался всему заданию. Главный шаг упал выше, и об этом никто не спросил.

Как починить:

главная_команда
RC=$?
if [ $RC -ne 0 ]; then
  echo "Главный шаг не выполнен: код $RC" >> "$LOG"
fi
# статистика, отчёт
exit $RC

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

Та же форма встречается в автоматизации звука р в словах, которые отправляет почтовый скрипт. Отправка письма возвращает строку вроде Message ID: ..., которая подтверждает, что сервер письмо принял. Но что именно он принял, из неё не следует. В одном случае получателю ушло письмо недельной давности: скрипт взял тело из файла с переиспользуемым именем, а там лежал прошлый текст. Отметка «перечитал» без результата сравнения по содержимому это тот же «код 0», только в прозе.

2. Проверка упрощённым входом: на каких данных это проверяли?

Аналогия: примерка обуви сидя. Сидя ботинки сидят. Жмут они на прогулке, а прогулка в проверку не входила.

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

Второй случай нагляднее. Скрипт перед отправкой сверял адресата: входит ли имя чата в заголовок открытого окна. Отрапортовал успех со строкой чат ''. Нужный чат открыт не был. Пустая строка входит в любую строку:

print("" in "Любое другое окно")  # True

Пустое искомое надо считать отдельным отказом ещё до проверки на вхождение.

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

3. Проверка не того слоя: что на самом деле измеряет этот признак?

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

MCP (Model Context Protocol, способ дать ИИ-агенту внешние инструменты: сервер предлагает набор функций вроде «прочитать почту» или «создать черновик письма»). Агент не нашёл у себя функцию создания черновиков Gmail и объявил, что такой возможности нет. Накануне он сам ею пользовался. В истории сессии висели уведомления о переподключении сервера: связь моргнула, инструменты потерялись. При этом сам сервер был запущен, и стандартная проверка «сервер работает?» возвращала «да».

Автоматизация звука р здесь в том, что рапорт о работоспособности сервера отвечал на вопрос «процесс запущен?», а не на вопрос «инструменты доступны агенту?». Это разные слои, и проверка одного ничего не говорит о другом.

Что делать с этим прямо сейчас, по ролям

Автору Дзена и копирайтеру. Если вы автоматизируете публикации, рассылки или сбор данных через скрипты и ИИ-агентов, после каждого ключевого шага сохраняйте код возврата в переменную и пишите в лог не «выполнено», а что именно получилось. Перечитывайте содержимое отправленного, а не только факт отправки.

Маркетологу. Автоматические отчёты о рассылках и постинге страдают тем же: «отправлено 1000 писем» не равно «1000 писем дошли с актуальным содержимым». Добавляйте в отчёт хотя бы хэш (контрольную сумму) тела письма и сверяйте с эталоном.

Предпринимателю в РФ и СНГ. Claude Code и Codex пока доступны в РФ с ограничениями. Из доступных аналогов для генерации скриптов подходят YandexGPT и GigaChat, но описанные ловушки от модели не зависят: код возврата перезаписывается в bash одинаково, какой бы ИИ-агент (программа, которая действует автономно, выполняя задачи без пошагового контроля человека) скрипт ни написал. Все пять контрольных вопросов применимы к любому стеку.

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