巻物を探す
29件の巻物
Node.js ESM の CLI が無言で exit 13 — 循環 import × top-level await デッドロックの診断と修正
テストは通るのにCLI直接起動だけ止まる原因（TLAで待つエントリへ動的import先が循環import）の確認手順・コード無変更の回避策・恒久修正・スモークテスト
Google Meet 自動参加&動画配信Bot 開発指示書
指定した時刻に Google Meet へ自動参加し、動画を再生しながら画面共有する Bot を、Claude Code に一発で作らせる開発指示 MD。朝会の定例動画配信・ウェビナーの自動放送に。
AI の返答に出てくる URL に「どのアカウントで開くか」を必ず書かせる Stop hook の作り方
管理画面・課金ページの URL をアカウント名なしで人に渡すと別アカウントで開いて 404 になる。返答の送信直前に止める Stop hook（判定ロジック・免除条件・逃がし弁・テスト・配線）を依存なしの Node.js で作る手順。
自動で価格・在庫を動かすAIに『毎日実機を見て・結果で判断して・止まったら気づく』をさせる運用の作り方
客側画面の実機読み戻し、同じ画面の近隣価格との比較、決定台帳の再判断日、PC外の心拍監視、出力妥当性検査、過去事故の自動プローブ化までを1日5回の点検ジョブで回す型
Beds24 経由の Airbnb 追加人数料金は priceRule では変わらない — 本当の設定場所とログイン済み窓からの読み書き
Airbnb の追加人数料金/基本人数は Beds24 の priceRule でも API でもなく管理画面の Airbnb 専用欄(syncroniserairbnbroom)が制御する。&roomid= 無視の罠、コンテンツの確認での読み戻し、CDP 常駐窓で dry-run 既定・部屋照合つきに書くツールの仕様
別アカウントの Claude Code 同士を人の転記なしで直接やりとりさせる（共有メールボックス方式）
組み込みSendMessage/Remote Controlは同一アカウント限定。既存のトークン付きWeb App＋シートをメールボックスにして任意PC間を双方向・2分配達、promptは承諾制で読み取り専用headless実行
スプレッドシートとGAS Web Appを画面操作ゼロで作成・公開し、外部アプリからHTTPで1行upsertする
clasp のトークンだけで、スプレッドシート作成→バインドされた Apps Script 作成→コード投入→Web App 公開まで REST で完結させる手順。DBを契約せず0円で「フォーム入力→通知→表に蓄積→月次集計」を実現する。人手は実行権限の承認1回だけ。未承認とポリシー禁止の切り分け、シート作成直後の未フラッシュで初回だけ壊れる罠、CSVエクスポートがread-backに使えない罠、再デプロイでURLとシークレットを変えない状態ファイル設計、後片付けまで含む検証スクリプトの型を実測ベースで収録。
同期が「更新しました」と嘘をつく — 配布が届かない2つの欠陥を潰す
設定・ルールの配布処理が成功報告を出すのに実際は届いていない。pullの上流取り違えと、自分が配った旧版を人の編集として保護し続ける2欠陥を、実コミットの差分・テスト・読み戻し検証手順まで含めて潰す。
Claude Code の会話ログを自動退避しても VSCode のタブを壊さない（state.vscdb で開いているセッションを検出）
セッション一覧の自動整理で jsonl を動かすと VSCode 拡張のタブが「Couldn't load this conversation's saved history」になる。拡張が state.vscdb に平文で持つセッション ID をバイト検索して、参照中のログは理由を問わず動かさないガードの実装・テスト・復旧手順。
Beds24 API v2 で予約を漏れなく取る — 黙って欠ける3つの罠（到着日フィルタ・100件ページング・応答切れ）
Beds24 API v2 の /bookings と /properties は HTTP 200 のまま予約・部屋が欠ける。arrivalFrom は到着日フィルタ、/bookings は100件ページング、/properties は応答切れ。回避コード付き
MCP stdio サーバが Windows で「接続済み」のまま死んでいるのを見抜く
MCPサーバ一覧が緑でもツール呼び出しだけ spawn ENOENT で死ぬ故障の3層構造と、initialize/tools-list/tools-call を層ごとに実測して証明する手順。npx形式が作る初回だけの接続タイムアウト、設定スキーマ移行による静かな認証無効化、自動修復コードが鍵を空文字で潰す罠も含む。
ログイン必須の社内Web発注システムをCLI化して一言で発注する（確定ゲート付き）
APIの無いログイン必須サイトを curl で副作用ゼロに実測し、check/apply/order(--yes ゲート)/history の4コマンドCLIにする。未確認画面は初回実行でフォーム要素をダンプして学ぶ設計、安いモデルへ委譲する際の再委譲防止も。
LLMの出力を実際に動かして採点するevalハーネスの作り方
安いモデルへ落として良いかを測る社内evalで、正規表現採点が正しい答えを落とす問題を解決する。生成コードをnode:vmで実行し振る舞いで採点する方法、課題自体の欠陥(設問が二義的/採点が実装スタイルを過剰指定)の切り分け方、そして多くの実装が踏むvmサンドボックス脱出経路の塞ぎ方まで。
夜間の無人AIエージェントバッチが「静かに全滅」するのを止める（観測タスクの立て方）
夜間バッチでAIエージェントを無人実行すると、失敗そのものが誰にも届かない。観測・切り分け・自己修復・報告を別タスクとして立てる手順と、実測で踏んだ4つの静かな全滅経路（spawnの同期throw／先頭ブロックしか読まないパーサ／コンソールのエンコーディング／スリープで未発火）の塞ぎ方。
Square の決済データを月次集計して Next.js のトップに売上ダッシュボードを出す
Square Payments API をページングして JST で月次集計（COMPLETED・返金控除）、30分キャッシュ＋stale フォールバックの API、スマホ向け進捗カードと月別表。生成AIが実際に出したバグ2件のレビュー観点と本番検証手順つき
テストが全部緑でも検出器は死んでいる — 変異テストでテストの検出力を機械的に検定する
hook/gate などの検出器を無害化した変異体に同じテストを流し、通ってしまうテスト(=検出力なし)を摘発する。実測で34本中2本が該当。node --test の子プロセスが NODE_TEST_CONTEXT 継承で失敗を exit 0 にする罠と、sha256 台帳で未検定を止める hook まで。
運用ルールをAIに守らせる「宣言強制ゲート」hook
依頼受領時(UserPromptSubmit)に割り込み、応答冒頭で1行の判定宣言を出させることで、委譲・夜間バッチ等の運用ルールを実効化する hook の型。実装コード・登録方法・発火/非発火の検証コマンド・実際に踏んだ落とし穴つき。
スプレッドシートのシート追加ボタンが copyTo null で落ちる原因をデータだけで特定する
GASボタンの Cannot read properties of null (reading 'copyTo') は、シート名一覧と実シート名のズレ。Sheets API で実名・一覧列・プルダウンのデータ検証を突き合わせて壊れた参照を全件出し、退避先から復元して read-back 検証するまでの手順。末尾スペース事故とバインド型スクリプトに到達できない制約も含む。
CIから自ホストへpushする連携が「届かない日」を、artifactからのpullで埋める
自宅/社内PCやトンネル公開先へCIからPOSTする連携が到達できず落ちる問題を、配達先からartifactを取りに行くpull経路で埋める手順。生成と配達の切り分け、判定表の設計、CIの定時遅延による二重生成の回避、read-back、監視指標の付け替え、計測ツール自身の偽陽性の潰し方まで。
共有秘密をローテーションしても端末を締め出さない鍵配布サーバ設計
全PCへAPIキーを自動配布する小さなサーバで、共有秘密の張り替え時に全端末が永久401になる事故を防ぐ設計と復旧手順。primary/legacy/enrollの3層認証、クライアント側の上書き更新分岐、ローテーションの正しい順序と実測方法
Airbnb ホスト画面の閲覧数・成約率を、ログイン済みの常駐ブラウザから自動で読む（クリックなし・JSON 化）
ホスト実績ページ（閲覧数・成約率）を CDP の常駐ログイン窓から読み、掲載別の JSON にする手順。本文の4行構造・下位10件しか出ない表の詳細ページ補完・browser.close 禁止などの安全規則・実ページ本文を fixture にする検証まで
頼んだ作業を実データで完了検知して自動で止まる、日次リマインドBotの型
権限共有や初期設定の依頼を出したあと、完了したかを本人の返信ではなくAPIの実データで判定し、未完了なら1日1回だけチャットDMで催促、完了を検知したら自動停止して依頼者に報告する無人ジョブの実装型。試行上限・二重送信防止・誤報防止まで込み。
複数PCへ配る設定ファイルを端末固有値を壊さず中央更新する
中央でキーやwebhookを張り替えた瞬間に全端末が静かに死ぬ事故を、キー単位マージ配布・保護キー・ローテーション順序・沈黙検出で構造的に防ぐ手順
無人ジョブの沈黙する失敗と効果検証の自動判定
定時ジョブが1行もログを残さずスキップされる事故の検知と、恒久対策の効果検証をジョブ自身に判定させる型。Windows Interactive タスクが無人再起動で捨てられる罠、検証を壊す警告文の是正、全分岐の時間偽装テストまで。
定時ジョブが黙って止まったのを検知して自動修復する見張り番の型
無人ジョブの死活を3層（起動・終了コード・今日の成果物）で判定し、固定した作業コピーでの再実行で自動修復する型。判定不能と非冪等を触らない切り分け、1日1回・3日で打ち切る暴走防止、相互監視、実装を安価モデルへ委譲したときに実行して初めて出る欠陥まで。
追加したテストが本当にその不具合を捕まえるかを対照群で確かめる
テストが緑でも、直す前のコードに当てても緑なことがある。直した箇所を1つずつ無効化して赤くなるか確かめる手順。置換が当たらず素通りする罠（CRLF）と、期待文字列が実装を通らない経路で出力に混入する罠（例外メッセージのコマンドライン全文）の2つを潰す雛形つき。
OTAの予約が急に止まった原因を公開クチコミの日付分布で切り分ける
宿泊施設のOTAで受注が急減した時、重複掲載・競合・値上げのどれが引き金かを、公開クチコミの日付分布だけで潰す手順。Booking.comの実測済みDOMセレクタ、ページ送りが止まらない罠、代理指標の検算方法、exit codeでの機械判定つき。
機能を封鎖したら相乗りの検証も死ぬ — 未検証のゼロを画面から追い出す
危険な機能を後から封鎖すると、同じフラグにぶら下がっていた検証処理が道連れで死に、ツールは未検証のゼロを『確認した結果ゼロ』の顔で出し続ける。実例では1週間、12件ぶんの嘘の警報を出していた。フラグ参照の仕分け方、未確認を空集合で表現しない持ち方、原因バケツの合計を不変条件にする数え方、0/1/2 の終了コード設計、修正前後を本番データで並べる検証手順、委譲実装の受け入れ基準まで。
Windows で無人 LLM CLI に長いプロンプトを渡すと spawn ENAMETOOLONG で即死する — stdin 渡しへの根治と単発故障を1件で検知するヘルス判定
Windows の argv 上限で子CLIへの長いプロンプトがspawn即死。stdin渡しへの修正とテスト、単発故障を1件で検知する監視の閾値修正