Bash-Exitcode, Skriptausgabe und Diffs in einer Chat-Karte

Was der Agent kann

• Dateienread_file, write_file, edit_file, grep, glob und list_dir funktionieren im Arbeitsordner des Chats, und edit_file zeigt einen Diff jeder Änderung an. Ein Zähler zeigt an, wie viele Dateien erstellt, bearbeitet und gelesen wurden.
• Shellführt einen Befehl in der gewählten Umgebung aus, z. B. Windows, WSL oder einen Server, den Sie über SSH besitzen, und meldet den echten Exitcode. Gefährliche Befehle werden blockiert.
• Webweb_search sucht Informationen und http_get lädt eine Dokumentationsseite herunter, damit Sie lesen können, was ein Befehl tut, bevor Sie ihn verwenden.
• Screenshots und Bilderocr liest Text aus einem gespeicherten Screenshot, z. B. eine Fehlermeldung, und gen_image speichert Bilddateien.
• Orchestrierungtask startet Sub-Agents parallel, run_on_model sendet einen harten Schritt an ein größeres Modell, und Skills sind wiederverwendbare Spielpläne.
• GenehmigungsmodiAuto-run führt sofort aus, Ask first pausiert vor Aktionen, die etwas ändern, und Plan only schreibt einen Plan und führt nichts aus.
• Cronführt ein Prompt nach Zeitplan aus, z. B. einen täglichen Testlauf Ihres eigenen Skripts auf einer Maschine, die Ihnen gehört.
• Modelleein Cloud-KI-Anbieter über einen API-Endpunkt, ein Modell auf Ihrem PC oder das integrierte Modell, das ohne Ihren eigenen Endpunkt bereit ist.

Vier Aufgaben mit Exitcodes und Argumenten

Exitcode prüfen, wenn ein Argument fehlt

Sie bitten den Agenten herauszufinden, was passiert, wenn check.sh kein Argument erhält. read_file öffnet das Skript, und Shell führt bash check.sh ohne weitere Argumente aus. Die Karte zeigt die echte Ausgabe und den Exitcode, der 2 ist, wenn das Skript seine Verwendungsmeldung auf standard error ausgibt und mit exit 2 endet. Der Bash-Exitcode des letzten Befehls steht in $?, und der Aufrufer sieht nur diese Zahl, daher ist ein Skript, das mit einem klaren Code endet, einfacher zu testen als eines, das immer 1 zurückgibt. Shell führt das Skript dann erneut mit zwei Werten aus, und die Karte sollte 0 anzeigen. Wenn Sie von den Codes überrascht sind, lesen Sie die Karte, lassen Sie dann edit_file unter Ask first eine Korrektur vorschlagen und prüfen Sie den Diff.

Optionen mit getopts parsen

Sie geben „getopts erklären“ ein, und der Agent antwortet in einfachen Worten: getopts ist ein Bash-Builtin für kurze Optionen wie -v oder -f Datei, während getopt ein separates Kommando ist, das auch lange Optionen wie --file verarbeitet und sich zwischen Systemen unterschiedlich verhält. Dann öffnet read_file Ihr Skript, edit_file fügt eine getopts-Schleife hinzu, und Sie sehen den Diff. Shell führt das Skript mit -v, mit -f und mit einer falschen Option aus, und jede Karte hat ihren eigenen Exitcode. Eine falsche Option sollte mit 2 enden, dem üblichen Code für falsche Verwendung. Für eine Handvoll Optionen reicht eine while-Schleife mit case und shift, also fragen Sie nach dieser Version, wenn Sie sie bevorzugen. Akzeptieren Sie den Diff erst, nachdem Sie ihn gelesen haben.

Werte mit Leerzeichen in einem Stück behalten

Das Übergeben von Argumenten mit Leerzeichen an ein Skript schlägt fehl, wenn die Werte nicht in Anführungszeichen gesetzt sind, da die Shell sie in separate Wörter aufteilt. Der Agent liest die Datei mit read_file, findet die nicht in Anführungszeichen gesetzten $1 und $@, und edit_file schlägt doppelte Anführungszeichen um sie vor. Shell führt das Skript dann mit einem Wert wie „two words“ aus, und die Ausgabe zeigt, ob es als eine Zeile oder als zwei Zeilen ankommt. Einer der Tricks zur Verwaltung von Befehlszeilenargumenten ist shift, das den ersten Wert entfernt, damit eine Schleife durch den Rest gehen kann, und der Agent kann ihn im selben Diff hinzufügen. Unter Ask first wartet die Bearbeitung auf Sie. Überprüfen Sie den Diff, führen Sie den Test erneut aus und vergleichen Sie die beiden Ausgaben selbst.

Bei Fehlern mit set -eu stoppen

Jeder, der nach „bash exit script“ sucht, sucht normalerweise nach dem exit-Befehl: exit N beendet das Skript mit Status N, während return N nur eine Funktion verlässt. Der Agent kann set -eu und set -o pipefail oben hinzufügen, damit das Skript bei Fehlern und bei nicht gesetzten Variablen stoppt, und dann führt er die Datei mit bash -n für eine Syntaxprüfung und mit bash -x aus, um jeden Befehl zu drucken. Wenn return nicht den Status des letzten Befehls angibt, lief normalerweise ein anderer Befehl dazwischen, da $? nur den Exitcode des neuesten Befehls enthält. Die Shell-Karte zeigt den Trace. Lesen Sie ihn von oben, vergleichen Sie ihn mit dem Skript und entscheiden Sie, ob die Bearbeitung bleibt.