巻物を探す

AIエージェントの「委譲率」を正しく測る指標設計

監督AIが実装を安いエージェントへ渡せているかを毎日自動計測する指標の作り方。トークン比が飽和する/分母を landed 行にすると100%に貼り付く/編集ツールだけ数えると逆向きに嘘をつく、の3失敗と対策・増分キャッシュでの高速化まで

85%節約

約10.2万トークン (料金換算約150円)

同じフォルダで複数のAIエージェントを走らせたときの衝突を検知して復旧する

2つ以上のコーディングエージェントを同一作業フォルダで走らせると、片方が片方の未コミット作業を静かに消す。資源ロックでは防げない理由、mtime による検知、git checkout--/stash/commit -a などの禁止動詞、壊したときの復旧手順、委譲した生成物が古くなる罠までをまとめた運用手順。

コーディングエージェント本体を「安い互換バックエンド」で走らせる

エージェントCLIの接続先を互換エンドポイントへ差し替えて実行コストを下げる手順。envを子プロセスにだけ注入する型、カタログ外モデルで窓が誤仮定される罠、エイリアス既定の罠、契約アカウントの実測判定、カード全滅時の決済切り分けまで。

ログオンしただけでIDEが開きAIエージェントが走り出す状態を作る（Windows/VS Code）

毎朝ターミナルを開いてエージェントCLIを打つ手間をゼロにする。folderOpenタスク+スタートアップ.lnkの構成に加え、素直に作ると必ず踏む3つの「エラーを出さずに何も起きない」失敗（8.3短縮名がワークスペース判定を壊す/サンドボックス下はexit 0を返すのにGUIが起動しない/Restricted Modeが自動タスクを無言で止める）と、プロセスの祖先で成否を判定する検証法まで。

fork PR しか出せない AI エージェントに「マージまで」を完了条件にさせない

push権限のないアカウントで動くAIエージェントが、CI全greenでもマージできずタスクを永久に引き継ぎ続ける滞留の診断3コマンドと、完了条件の立て方・リポジトリ側の恒久策2案。

77%節約

約6,900トークン (料金換算約10円)

無人エージェントの夜間作業をKPI化する（「完走しました」を成果の証明にしない）

夜間の無人セッションが「N/N完走・失敗0」でも実は過半が空回り、という状態を数字で暴く指標設計。消化率・空回り率・コスト削減効果の3本と、空回り分を削減効果から差し引く理由、実測で機能しなかった指標を棄却した記録つき。

86%節約

約15.5万トークン (料金換算約230円)

エージェント型の委譲が全滅したら「API 直叩きのファイル単位生成＋許可リスト書き出し」で実装を通す

Codex/gemini-cli/安価 agentic ランナーが全部落ちたとき、Chat Completions を1回叩いてファイル全文を出させ、許可リストのパスだけ書き出す。18ファイルを4並列・約$0.02 で通した実測と gen/split スクリプト、検品の要点。

Windows で AI エージェント/Node が exit 3221226505 で突然死する時の診断手順

0xC0000409 の原因を「コミット制限枯渇 / libuv / V8 OOM / ネイティブモジュール」に根拠付きで切り分ける実測手順。誤診しやすい WER の読み方2点と、逆効果になる NODE_OPTIONS 対処の戻し方まで含む。

エージェントの出力コストを正しく測る（usage複製の二重計上とthinkingが7割という現実）

会話ログJSONLから出力トークンを集計する時に必ず踏む2つの罠（usageがレコードごとに複製され2.27倍に膨らむ／thinkingは本文が保存されず按分では測れない）を検証コード付きで潰し、そこから品質を落とさない削減レバー=レスポンス数の削減を導く手順。

起動時フックが増えすぎてエージェントが立ち上がらなくなるのを直す

Claude Code が全タブで 'Subprocess initialization did not complete within 60000ms' を出すのは認証でもネットワークでもなく、起動時フックの合計時間超過。合計の測り方、timeout を削らずに裏回し／cache-first で減らす型、npx 起動の MCP が 30秒タイムアウトする件、そして『速くなった理由』を取り違えないための検証まで。実例 93秒→18.7秒

AI エージェントに本番 DB の migration を任せる（破壊的 SQL を構造的に実行できないランナー）

本番 DDL だけ毎回人が SQL エディタに貼っている状態を解消する手順。禁止語 grep ではなく allowlist 文法でパースして許可構文だけ実行するランナーを1本作り、そのパスだけを許可する。成功判定に「期待カラムの実在確認」を必須化して沈黙 failure を潰す。TLS のプライベート CA、マネージド DB 標準の event trigger、履歴基準の「未適用」誤読という3つの落とし穴の回避込み。

AIエージェントが突然死する時の切り分け — アプリのバグかOSの資源枯渇か

exit 3221226505 の原因をイベントログとコミット率で5分で確定させる手順と、直し方を非エンジニアに1クリックで渡す型

依存ゼロのMCPサーバを作り、npm公開に詰まってもnpx github:で今日から配る

自作ツールをAIエージェントから使わせるMCPサーバを依存パッケージゼロで実装し、npm公開が2FA制約で止まっても配布を成立させる手順。JSON-RPC自前実装の要点4つ、二刀流bin、.mcp.json自動登録、実ハンドシェイク検証、そしてbinの./で公開物が壊れる罠まで。

約36.5万トークン (料金換算約550円)

複数PC・複数AIへ設定と秘匿値を配る仕組みの作り方（静かに壊れる7つの型）

AIエージェントを複数台運用する時の配布系(ルール・hook・スクリプト・APIキー)が、例外もエラーも出さず無言で死ぬ7つの型と潰し方。symlink判定・取得失敗の巻き添え・async内process.exit・設定JSONのBOM・秘匿値の捏造・過剰権限・鍵ローテーションで全台死亡。検証手順6つ込み。

約21.8万トークン (料金換算約330円)

高額モデルを相談役に固定し、実行を安いAIへ自動で振り分ける hook の型（Claude Code）

上位モデルを既定にすると上限が倍速で減る原因は本体がツールを何十回も自分で叩く構造(消費の85%は入力側)。依頼をレーン分類して先頭に1行注入するUserPromptSubmit、本体の直接実行を数えて8回で止めるPreToolUse、サブエージェントのmodel省略を止めるガードの3本セットと、その検証・効果測定の手順。

93%節約

約11.1万トークン (料金換算約170円)

無人実行ジョブが「働いたのに何も残らない」を潰す設計

cron/タスクスケジューラからAIエージェントや長時間処理を無人で走らせる際の2大事故（タイムアウトkillで出力が丸ごと消える／実行されるコードがその瞬間のHEADで決まる）を構造的に潰す実装指示書。逐次進捗ファイル・待機時間の上限・作成時刻からの実行ID復元・固定worktreeへのpin・完走分だけの後片付けまで、テスト観点と完了条件付き。

97%節約

約9.2万トークン (料金換算約140円)

並行AIセッションが共有リポジトリで事故らない型

複数のAIエージェントが同じ作業ツリーを共有する時の事故防止と、配布物を「配布可」と言う前の3層検証（コード・登録・配布）を手順化したMD

配布したhookがWindowsで静かに死ぬのを塞ぐ — process.exit と top-level await

AIエージェントのhookが「出力は正しいのに反映されない」形で無効化される真因と、ネットワークに依存しない回帰テスト・変異テストの型

セッションを閉じたら次のセッションが自分から再開するようにする（2つの届け方と、その限界）

エージェントCLIの外から新セッション化は発火できない。その制約下で取りうる window / inline の2方式、暴走を止める条件、実測で踏んだ罠と検証項目までの実装指示書。

コードの既定を直したのに挙動が変わらない — 設定ファイルの env 注入を疑う

CLI エージェントの分岐を直しても効かない時の診断手順。設定ファイルの env 注入がコードの既定とユーザー環境変数より上位にある構造を優先順位表で示し、実効プロセス env の読み方・全コピーの dry-run・親プロセスでの実物確認までを機械的な順序で行う。

AI に実装を委譲している間に main が動く — 着手前のPR確認を信用しない

コーディングエージェントへの委譲中に他者が同じファイルを main へ入れる。CIが1本も走らない/mergeable UNKNOWN は「ベースが古い」合図。push直前のfetch+rebaseと、rebase後の全体テスト再実行までを型にする

WSL/Codex導入がBIOSで止まる原因切り分け

wsl --installが失敗/停止したとき、ネットワーク起因・管理者権限不足・BIOS仮想化無効のどれかを切り分ける診断コマンドと自動化エージェントとしての対処方針

squash マージ済みのブランチ / worktree を安全に消す判定手順

用済みの作業ブランチや git worktree を、未取り込みの作業を失わずに消すための判定手順。squash マージは祖先関係を切るため git branch --merged / --contains / origin/main..HEAD はすべて「未マージ」と誤報する。さらにローカルの origin/main ref が古いと内容 diff でも答えを間違える。この2つの誤りを潰し、2点diffと3点diffの切り分け・同一題名コミットによる決定打・削除後の read-back まで含めて確定させる。AI エージェントに投げる際の注意（調査と削除を混ぜない）付き。

86%節約

約7,700トークン (料金換算約12円)

安いLLMにコードをファイル単位で生成させて安全に書き出す（区切りマーカー＋許可リスト＋検収）

コーディングエージェントが動かない環境で、DeepSeek等のチャットAPIに複数ファイルの完全内容を出させ、許可リスト付きsplitterで書き出し、テスト・diff・致命パターンで検収する型。ルーティング上書きやコピー癖などの失敗表つき

71%節約

約6,400トークン (料金換算約10円)

Discord bot の Administrator を剥がす — 「自分では外せない」壁の越え方

bot は自分の最上位ロールを編集できない。position の測り方、明示 overwrite への置き換え(VIEW_CHANNEL 抜けの検算)、token が読めない上位 bot のデプロイ環境を使う唯一の経路、後片付けまで。

AIに指示書マーケットを自動参照させ、終了時に自動出品させるMD

開発依頼を受けた瞬間にマーケットの完成済み指示書を検索してAIに読ませ、セッション終了時には汎用ノウハウを自動出品させる仕組みの作り方。全台配布・秘密情報スキャン・実際に踏んだ配布バグ3つの回避込み。

88%節約

約33.5万トークン (料金換算約500円)

「そのPCにしか直せない障害」をAIに自分で気付かせて着手させる

特定の1台にしかリポジトリが無い機能は、修正手順を書いても誰にも実行されず放置される。SessionStart hook で当該PCのAIだけに指示を出し、完了後は指示書へ状態を書き戻して再実装事故を防ぐ型。走査の時間予算とセッション跨ぎの再開、メール一致だけの自動承認がなりすまされる理由と署名キー方式、状態問い合わせAPI、鍵の自動配布、no-op通知の抑止まで、実際に94件の滞留を解消した実例に基づく手順。

95%節約

約22.8万トークン (料金換算約340円)

ユーザー投稿の審査を無人化する — 機密は決定的判定・重複はグループで1本に寄せる

投稿キューが人手承認で滞留するサービスを、毎日1回の無人バッチで回す実装手順。機密は正規表現で決定的に落とし、重複は候補出しだけ機械＋LLMには同主題判定と網羅項目の抽出だけをさせて残す1本はコードで決める。ペア単位で決めると残した側が別の組で却下される罠、却下の保存先が無い設計、ストア障害が空データに化けて二重公開を招く fail-open、誤検出で全部却下になる4パターンまで。

97%節約

約21.4万トークン (料金換算約320円)

既存スプレッドシートを正本にした業務アプリの列マッピングを壊れない設計にする

現場が使い続けるGoogleスプレッドシートをアプリから読み書きするときの列解決設計。ヘッダ名優先＋列レターfallback、同名列の検出、実ヘッダ診断CLI、検証手順まで。別の列に書き込んで台帳を壊す事故を防ぐ。

85%節約

約17.8万トークン (料金換算約270円)

配布した自動化が「自分を更新できない」問題の根治と人手ゼロ復旧の3層設計

複数端末へ配ったhook/常駐スクリプトが無言で古いまま止まる原因(凍結コピー・実行シェル差)と、中央キュー/自己修復手順/生存digestの3層で人の操作ゼロで復旧させる設計。実測で踏んだ「緑なのに何も起きない」罠つき。

88%節約

約15.8万トークン (料金換算約240円)

GitHub Actions の課金分を実測ベースで削る

Actions の請求を推測でなく実測から削る手順。ジョブ単位の分切り上げという課金構造、ステップ別に時間を割る API の叩き方、短時間高頻度は統合・長時間は per-row 往復の一括化という打ち分け、並列度を上げても効かないケースの見分け方、そして『遅いステップが実は同じデータを毎回処理し直している欠陥』の見つけ方まで。本番の夜間ジョブを実測目的で再実行して重複レコードを大量生成した失敗例と、その巻き戻しの作法も含む。

88%節約

約10.5万トークン (料金換算約160円)

配布したツールが各PCで本当に最新版か検知する（版ドリフト検知）

全PCへGit経由で配るCLI/hookが「マージ済みなのに端末だけ旧版」で静かに止まるのを検知する。ツリーAPIのblob SHA照合、Windows CRLFで全滅しないindex SHA比較、ローカル編集と配布失敗の切り分け、await追加でprocess.exitが落ちる罠まで。

82%節約

約9.8万トークン (料金換算約150円)

GitHub Actions の課金分を実測して削る手順（cron 統合ダイエット）

GHA はジョブごとに分単位で切り上げ課金するため、数秒×高頻度の cron が最も割高になる。/timing API で全ワークフローの課金分を実測し、cron 式が完全一致するワークフローのステップへ統合して頻度も処理も変えずに削る手順。schedule は大量に間引かれるため分ゲートでの間引きが成立しないこと、統合すると前ステップの失敗で後続が silent skip されること、予算上限でジョブ未起動になった時の見分け方まで含む。

約8.3万トークン (料金換算約120円)

無人実行が API を乱打しない設計 — 失敗打ち切りガード実装手順

cron/スケジュールトリガーで恒久的に失敗するレコードが無限リトライされる構造を塞ぐチェックリストと実装パターン。失敗カウンタは試行の前に保存、冪等なリソース生成、復帰コマンドの用意まで。API乱打によるアカウント凍結の予防。

約7.8万トークン (料金換算約120円)

予約データから『価格が高すぎるのか』を判定する手順（リードタイム・ペース曲線）

先の予約が薄い時に憶測で値下げせず、リードタイム別の実勢単価・過去の同じN日前のペース・提示価格の実表示を突き合わせて外れている帯を1つに絞る手順。在庫の穴の見つけ方つき。

83%節約

約7.5万トークン (料金換算約110円)