Коды выхода, вывод скриптов и diff файлов в карточке чата

Что умеет агент

• Файлыread_file, write_file, edit_file, grep, glob и list_dir работают в рабочей папке чата, а edit_file показывает diff каждого изменения. Счётчик показывает, сколько файлов было создано, отредактировано и прочитано.
• Shellзапускает команду в выбранной среде, такой как Windows, WSL или сервер, к которому вы подключены по SSH, и сообщает реальный код выхода. Опасные команды блокируются.
• Вебweb_search ищет информацию, а http_get загружает одну страницу документации, чтобы вы могли прочитать, что делает команда, прежде чем использовать её.
• Скриншоты и изображенияocr считывает текст с сохранённого скриншота, например сообщение об ошибке, а gen_image сохраняет файлы изображений.
• Оркестрацияtask запускает субагентов параллельно, run_on_model отправляет сложный шаг более крупной модели, а skills — это переиспользуемые сценарии.
• Режимы одобренияAuto-run действует сразу, Ask first приостанавливается перед действиями, изменяющими что-либо, а Plan only пишет план и ничего не запускает.
• Cronзапускает промпт по расписанию, например ежедневный тестовый запуск вашего собственного скрипта на машине, которой вы владеете.
• Моделиоблачный ИИ-провайдер через конечную точку API, модель на вашем ПК или встроенная модель, готовая к работе без вашей собственной конечной точки.

Четыре задачи с кодами выхода и аргументами

Проверка кода выхода при отсутствии аргумента

Вы просите агента выяснить, что происходит, когда check.sh получает аргумент. read_file открывает скрипт, а Shell запускает bash check.sh без аргументов после имени. Карточка показывает реальный вывод и код выхода, который равен 2, если скрипт выводит строку использования в стандартный поток ошибок и завершается с exit 2. Код выхода Bash последней команды находится в $?, и вызывающий скрипт видит только это число, поэтому скрипт, заканчивающийся явным кодом, легче тестировать, чем тот, который всегда возвращает 1. Затем Shell снова запускает скрипт с двумя значениями, и карточка должна показать 0. Если коды вас удивляют, прочитайте карточку, затем позвольте edit_file предложить исправление в режиме Ask first и просмотрите diff.

Парсинг опций с помощью getopts

Вы вводите «объясни мне getopt», и агент отвечает простыми словами: getopts — это встроенная команда Bash для коротких опций, таких как -v или -f file, тогда как getopt — это отдельная команда, которая также обрабатывает длинные опции, такие как --file, и ведёт себя по-разному в разных системах. Затем read_file открывает ваш скрипт, edit_file добавляет цикл getopts, и вы видите diff. Shell запускает скрипт с -v, с -f и с неверной опцией, и каждая карточка имеет свой код выхода. Неверная опция должна завершаться кодом 2, обычным кодом для неверного использования. Для нескольких опций достаточно цикла while с case и shift, поэтому попросите эту версию, если она вам больше нравится. Примите diff только после его прочтения.

Сохранение значений с пробелами в целостности

Передача аргументов со пробелами в скрипт не работает, если значения не заключены в кавычки, потому что оболочка разбивает их на отдельные слова. Агент читает файл с помощью read_file, находит не заключённые в кавычки $1 и $@, и edit_file предлагает заключить их в двойные кавычки. Затем Shell запускает скрипт со значением, например «two words», и вывод показывает, доходит ли он одной строкой или двумя. Один из приёмов управления аргументами командной строки — это shift, который удаляет первое значение, чтобы цикл мог пройти по остальным, и агент может добавить его в тот же diff. В режиме Ask first редактирование ждёт вас. Просмотрите diff, снова запустите тест и сравните два вывода самостоятельно.

Остановка при ошибках с помощью set -eu

Любой, кто ищет «bash exit script», обычно ищет встроенную команду exit: exit N завершает скрипт со статусом N, тогда как return N только покидает функцию. Агент может добавить set -eu и set -o pipefail в начало, чтобы скрипт останавливался при ошибках и неопределённых переменных, а затем он запускает файл с помощью bash -n для проверки синтаксиса и bash -x для вывода каждой команды. Если return не возвращает статус последней команды, обычно между ними выполнялась другая команда, потому что $? содержит только код выхода самой последней команды. Карточка Shell показывает трассировку. Прочитайте её сверху, сравните со скриптом и решите, оставить ли редактирование.