Код виходу Bash, вивід скрипта та 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запускає промпт за розкладом, наприклад щоденний тестовий запуск вашого власного скрипта на машині, якою ви керуєте.
• Моделіхмарний AI-провайдер через 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 показує трасування. Прочитайте її зверху, порівняйте зі скриптом і вирішіть, чи залишати редагування.