チャットカードでBashの終了コード、スクリプト出力、ファイル差分を表示

エージェントの機能

• ファイルread_file、write_file、edit_file、grep、glob、list_dirはチャットの作業フォルダで機能し、edit_fileはすべての変更の差分を表示します。作成、編集、読み込みされたファイルの数をカウンターで確認できます。
• Shell選択した環境（Windows、WSL、SSH接続のサーバーなど）でコマンドを実行し、実際の終了コードを報告します。危険なコマンドはブロックされます。
• Webweb_searchで情報を検索し、http_getで1つのドキュメントページを取得します。これにより、コマンドの使用前にその内容を確認できます。
• スクリーンショットと画像ocrは保存されたスクリーンショット（エラーメッセージなど）からテキストを読み取り、gen_imageは画像ファイルを保存します。
• オーケストレーションtaskはサブエージェントを並列で起動し、run_on_modelは大きなモデルに対して特定のステップを送信し、skillsは再利用可能なプレイブックです。
• 承認モードAuto-runは即座に実行し、Ask firstは変更を加える前に一時停止し、Plan onlyは計画のみを記述し、実行は行いません。
• Cronスケジュールに従ってプロンプトを実行します。例えば、所有するマシンでスクリプトの毎日テスト実行などを行います。
• モデルAPIエンドポイントを介したクラウドAIプロバイダー、PC上のモデル、またはエンドポイント不要の組み込みモデルから選択できます。

終了コードと引数を用いた4つのタスク

引数が不足したときの終了コードを確認

エージェントに、check.shに引数がない場合に何が起こるか調べてもらいます。read_fileでスクリプトを開き、Shellでbash check.shと引数なしで実行します。カードには実際の出力と終了コードが表示され、スクリプトが標準エラーに使用法を表示してexit 2で終了する場合は2となります。最後のコマンドのBash終了コードは$?に格納され、呼び出し元はその数値のみを確認できます。明確なコードで終了するスクリプトは、常に1を返すスクリプトよりもテストが容易です。その後Shellはスクリプトを2つの値で再実行し、カードには0が表示されるはずです。コードに驚いた場合は、カードを読み、Ask firstの下でedit_fileが提案する修正を確認し、差分を確認してください。

getoptsでオプションを解析

「getoptについて説明して」と入力すると、エージェントは平易な言葉で回答します。getoptsは-vや-f fileなどの短縮オプション用のBash組み込みコマンドであり、getoptは--fileなどの長縮オプションも処理し、システム間で動作が異なる別個のコマンドです。次にread_fileでスクリプトを開き、edit_fileでgetoptsループを追加し、差分を確認します。Shellは-v、-f、および間違ったオプション付きでスクリプトを実行し、各カードに固有の終了コードが含まれます。間違ったオプションは通常、不正な使用を示す2で終了すべきです。数少ないオプションの場合、caseとshiftを使用したwhileループで十分なので、そのバージョンをリクエストすることもできます。差分を読み終えてから承認してください。

スペースを含む値を1つに保つ

スペースを含む引数をスクリプトに渡す際、値が引用符で囲まれていないと、シェルがそれらを個別の単語に分割するため失敗します。エージェントはread_fileでファイルを読み、引用符なしの$1や$@を見つけ、edit_fileでそれらを二重引用符で囲むことを提案します。その後Shellは「two words」のような値付きでスクリプトを実行し、出力が1行として届くか2行として届くかを確認します。コマンドライン引数を管理するトリックの一つにshiftがあり、これは最初の値を削除してループが残り全体を処理できるようにします。エージェントは同じ差分でこれを追加できます。Ask firstモードでは編集はあなたの承認を待ちます。差分を確認し、テストを再実行し、2つの出力を自分で比較してください。

set -euでエラー発生時に停止

「bash exit script」を検索する人は通常、exit組み込みコマンドを探しています。exit NはスクリプトをステータスNで終了させ、return Nは関数からのみ離脱します。エージェントはスクリプトの先頭にset -euとset -o pipefailを追加し、エラーや未定義変数でスクリプトを停止させます。その後、bash -nで構文チェックを行い、bash -xで各コマンドを出力します。returnが最後のコマンドのステータスを返さない場合、通常はその間に別のコマンドが実行されたためです。$?には最新のコマンドの終了コードのみが保持されます。Shellカードにはトレースが表示されます。先頭から読み、スクリプトと比較し、編集を適用するかどうかを判断してください。