巻物を探す
53件の巻物
Drive を AIルール共通ハブにする配布・統合同期
AI(Claude Code 等)のルール/スキルを Drive の1フォルダで正本管理し、pull(全員へ配布)と merge(inbox投稿を正本へ統合)の2モードで同期する仕組み。download_file_content 必須・latest-by-title・manifest 版管理など Drive コネクタの罠と対策込み。
スプレッドシートの行削除をDBへ安全に同期する（行UUID方式）
シートから行が消えたらDBのレコードを無効化する同期を、実在レコードを誤削除せずに作る手順。内容マッチが失敗する理由、行UUIDと二段確認、8つの安全ガード、書き戻しがUUIDを複製・上書きして欠落判定をすり抜けた実測の失敗パターンと検出コードまで。
自動同期システムの「窓」と「警報」を監査する
外部APIへ値を定期送信するシステムで、送信窓と検証窓のズレが作る『構造的に絶対に赤くならない領域』を潰す手順。窓の実測、窓外の期待値の導き方、既定値の再生成、管理方式変更に伴う警報の誤発報まで。
スプレッドシートの「○印」で回している業務の滞留を検知してDiscordで督促する
請求書発行・入金確認・書類回収など、現場がシートに○を打って管理している業務の遅れを自動検知し、担当者へDM・責任者チャンネルへ一覧を流す仕組み。集約シートが実は同期していない罠、既存夜間同期に相乗りしてAPIコールを増やさない方法、印パーサの4値設計、段階を直列にすると主目的が隠れる落とし穴、初日フラッド対策、退職者への誤送信防止まで、本番投入で踏んだ罠を全部収録。
AIエージェントのセッション引き継ぎを自動化する（閉じる→票→開く の3点セット）
長い会話で品質とコストが悪化する問題を、引き継ぎ票1ファイル+スキル2本+フック2本で解決する手順。票の鮮度維持と開始時案内だけを自動化し、commit/メモリ書き込みは人の明示操作に残す設計。実際に踏んだ落とし穴6件(本文言及での誤抽出/並行セッションの票奪い合い/リセット≠削除/検証方法の誤り/BOMと非同期フックの沈黙/常駐プロセスのコード非反映)と、その検証手順つき。
夜間の無人AIエージェントバッチが「静かに全滅」するのを止める（観測タスクの立て方）
夜間バッチでAIエージェントを無人実行すると、失敗そのものが誰にも届かない。観測・切り分け・自己修復・報告を別タスクとして立てる手順と、実測で踏んだ4つの静かな全滅経路（spawnの同期throw／先頭ブロックしか読まないパーサ／コンソールのエンコーディング／スリープで未発火）の塞ぎ方。
ルール強制 hook が本番で壊れる3つの型と検証方法
AIに運用ルールを守らせる hook を作った後に必ず起きる壊れ方(部分一致の誤爆・読む範囲のバグ・同期で消える)と、契約テスト5ケース+配布確認の型
共有ルールリポの「作り直し事故」を止める — AI に直させる前の3コマンド
複数PCで共有する AI 用ルール/ツールのリポジトリで、ローカルコピーが古いために既にマージ済みの修正を AI が作り直す事故を防ぐ。gh pr list --state all / main の実物と diff / 自作せず同期、の3手順とルール文面。
定期タスクが開発ツリーを直接叩いて古いコードで動き続けるのを検出して直す
毎晩動いているはずのバッチが数十コミット前のコードで走り、結果は毎回exit 0。専用クローン+同期ラッパへ張り替え、失敗注入と時間帯ゲートの罠まで含めて検証する手順。
AIエージェントの skill/tool を複数PCへ配布する時の罠と回避策
skill・共通ツールを複数PCへ自動配布する運用で必ず踏む3つの罠（配布物はgit repoでない／同期スクリプト自体が古い／skillはセッション開始時ロード）と、依存を再帰取得するブートストラップ手順。
スプレッドシート集計業務をNext.js+Supabaseアプリへ段階移行する設計指示書
運用中のSheets業務を止めずにWebアプリ(DB正)へ段階移行。双方向同期のエコーループ根絶・移行6原則・コード先行/スキーマ後追いリリース・プレースホルダ列の水増し防止・worktree隔離まで実戦知見を型化。
外部連携の値を内部フィールドで検証して誤診しない手順
チャネル連携・在庫/価格同期で「送った値が外にどう出ているか」を内部APIのフィールドで確認すると誤診する。派生値/参考値の混同、チャネル単位の係数、レスポンスの無言切り捨てという3つの罠と、消費者向けエンドポイント→全件突合→ブラウザ実描画という潰し方。
投稿の審査キューを「信頼済みだけ自動公開」で捌く設計（なりすまし穴つき）
審査キューに投稿が溜まったまま埋もれる問題を、信頼済み投稿だけ即公開する形で潰す指示書。無検証のキー発行を信頼判定に使うと第三者が自社メールを騙れる穴と、サーバレスで静的公開棚に実行時公開を足す方法、検証10項目まで含む。
AIに指示書マーケットを自動参照させ、終了時に自動出品させるMD
開発依頼を受けた瞬間にマーケットの完成済み指示書を検索してAIに読ませ、セッション終了時には汎用ノウハウを自動出品させる仕組みの作り方。全台配布・秘密情報スキャン・実際に踏んだ配布バグ3つの回避込み。
散らばったタスクを1枚に統合し、AIが1件ずつ実行して人が直す「タスク台帳」の作り方
複数の機能やシートに散らばった残タスクを1枚に統合し、人がヌケモレを見て、AIが1件ずつ実行し、人が修正指示を書いて再生成させるループを、無人で暴走しない形で回す設計。冪等なマージ規則、外部送信の自動実行禁止、失敗3回で人手に落とす打ち切り、実行環境の時間制限で中断された場合の扱い、復旧コマンドまで含む。
AI運用ルールを機械的に守らせる hook 設計 — ルール文が守られない本当の理由
チームでAIエージェントを使うと運用ルールが必ず守られなくなる。真因は「読んでいない」ではなく hook がそのマシンで登録されていない/委譲先が沈黙して壊れていること。禁止=実行前拒否・誘導=依頼時の具体コマンド注入・担保=セッション開始時の自己修復の3層、明示例外の短命トークン、warn→blockの段階昇格、BOM/サンドボックス/timeout など失敗が沈黙する罠と、環境依存で落ちないテストの作り方までを実測ベースでまとめた導入手順。
複数PC・複数AIへ設定と秘匿値を配る仕組みの作り方（静かに壊れる7つの型）
AIエージェントを複数台運用する時の配布系(ルール・hook・スクリプト・APIキー)が、例外もエラーも出さず無言で死ぬ7つの型と潰し方。symlink判定・取得失敗の巻き添え・async内process.exit・設定JSONのBOM・秘匿値の捏造・過剰権限・鍵ローテーションで全台死亡。検証手順6つ込み。
スプレッドシートのボタンUIを複数人同時利用に耐えさせる(GASジョブキュー化)
▶チェックで処理が走るシートUIは複数人が同時に使うと予約が黙って消える。1押下=1キュー行+対象ごとにシート分離+claimワーカーで直す設計と、script lockの奪い合い・6分制限・並列検証の落とし穴
公式APIの無い録音サービスから別SaaSへ音声を自動取り込みする指示書
録音クラウドの音声を文字起こしSaaSへ無人で流す構成。署名付きURLがHEADで403になる/URL長制限/jobIdが返っても取り込まれない、という無言の失敗の潰し方と、変換もストレージも要らない中継プロキシの型。
既存スプレッドシートを正本にした業務アプリの列マッピングを壊れない設計にする
現場が使い続けるGoogleスプレッドシートをアプリから読み書きするときの列解決設計。ヘッダ名優先＋列レターfallback、同名列の検出、実ヘッダ診断CLI、検証手順まで。別の列に書き込んで台帳を壊す事故を防ぐ。
Windows定期タスクが同じ秒に起動すると片方が無音死する（隠しランナーの共有ログとcmd >> 排他）
result=1・ログ0行で死ぬ定期タスクの真因が、隠しランナーが全タスクのログを1ファイルに流し cmd の >> が排他で開くことだった件。再現手順・切り分け・ログ名分離と設置先の自己更新・同一秒起動テストまで
配布した自動化が「自分を更新できない」問題の根治と人手ゼロ復旧の3層設計
複数端末へ配ったhook/常駐スクリプトが無言で古いまま止まる原因(凍結コピー・実行シェル差)と、中央キュー/自己修復手順/生存digestの3層で人の操作ゼロで復旧させる設計。実測で踏んだ「緑なのに何も起きない」罠つき。
配布したツールが既存端末にだけ届かない障害の診断と再発防止
全PCへ配ったhook/スクリプトが、新規端末では動くのに既存端末にだけ永久に届かない。凍結コピー・拡張子を無視した重複判定・無言return の3重奏で、テストは全green・自己診断もNG 0のまま気づけない。実際に踏んで直した診断手順と、再発を止めるテスト設計(既存端末フィクスチャ/チェックリスト網羅性の機械照合/故障注入)。
GAS 新規立ち上げ標準手順(clasp+コマンドキュー)
clasp と自作コマンドキューで、run-function 封鎖の Workspace 環境でも AI から GAS を継続実行できる新規プロジェクト立ち上げ手順。人間の作業は setupOnce の1クリックのみ。ホワイトリスト実行・並走防止・機密値の置き場も規定。
スプレッドシート業務アプリに画面キャプチャ付き不具合報告フォームを付ける(GAS)
GASのOverGridImageにgetBlob()が無くシート貼付画像は読めない。HTMLダイアログでCtrl+Vを受ける正しい設計・記録列マイグレーション・read-back検証・画像を捨てない後片付けまでの実装指示書
LLMの委譲先を「成功率×コスト」で決める eval ハーネス
安いモデルへ処理を移す前に品質が落ちないことを数字で確認する計測ツールの作り方。測定を歪める4つの罠(APIエラー/出力切断/期待値が正解を弾く/テンプレが配布先に届かない)と対策を実測値つきで示す。
GitHub Actions の課金分を実測ベースで削る
Actions の請求を推測でなく実測から削る手順。ジョブ単位の分切り上げという課金構造、ステップ別に時間を割る API の叩き方、短時間高頻度は統合・長時間は per-row 往復の一括化という打ち分け、並列度を上げても効かないケースの見分け方、そして『遅いステップが実は同じデータを毎回処理し直している欠陥』の見つけ方まで。本番の夜間ジョブを実測目的で再実行して重複レコードを大量生成した失敗例と、その巻き戻しの作法も含む。
AIモデルの課金区分を実測で確定し、ルールを機械に強制させる
「このモデルは定額内か従量課金か」を推測で決めると外れる。支出レポートで確定させる手順と、確定結果を単一の設定源+3層のフックで強制する型。安いモデルが実は高い（キャッシュ書き込み）の見つけ方も含む。
安いLLMプロバイダのフォールバック連鎖を本当に着地させる
無料枠が枯れて黙って死ぬのを防ぐ多段フォールバックの設計。失敗コードの2分類・プロバイダのクールダウン・日次上限・全呼び出し側の一本化・テストが実環境を壊す罠まで。
配布したツールが各PCで本当に最新版か検知する（版ドリフト検知）
全PCへGit経由で配るCLI/hookが「マージ済みなのに端末だけ旧版」で静かに止まるのを検知する。ツリーAPIのblob SHA照合、Windows CRLFで全滅しないindex SHA比較、ローカル編集と配布失敗の切り分け、await追加でprocess.exitが落ちる罠まで。
AIコーディングエージェントの費用は出力でなく入力(文脈)が9割 — 測り方と追加費用ゼロの3対策
会話ログから入力/出力の費用比を実測するスクリプトと、高額モデル・肥大セッションを検知するフック(差分読み必須)、常駐ルールの索引化(20,274→5,800トークン)まで。実装で踏んだ落とし穴4件と変異テストの型つき。
高額モデルで走り続けているセッションを hook に自己検出させる（Claude Code）
セッション内で /model 選択した高額モデルは既定モデル設定でも PreToolUse でも止まらない。hook stdin の transcript_path で自セッションのモデルを読み、毎ターン警告を注入する型。全読み禁止・async exit・realpath 起動判定・BOM の落とし穴と、集計側に発生元セッションIDを載せる改修まで。
Claude Code の「毎リクエスト課金される文脈」を実測して削る
~/.claude/rules/ の .md は paths: が無いと全リクエストに無条件ロードされる。count_tokens API でファイル単位に実測し、常時ロードから安全に外し、配布済みの全端末を自動移行させるまでの手順。早期returnの後ろに後始末を書くと一部端末で永久に直らない、削除でなく移動にしないと全文が消える窓ができる、といった実装上の落とし穴と回帰テスト5ケース付き。実測で 29,295→6,020 tok/req。
本番スプレッドシートに「新しいレコードの列ブロック」を安全に増やす型(GAS)
横並び1レコード=N列のシートに、既存ブロックの複製で新しい列ブロックを自動追加する型。数式の相対参照追従・IMPORTRANGEの絶対URL差し替え・日付セルのread-back照合の罠・本番検証用の撤去コマンドまで。
LLMの出力を実際に動かして採点するevalハーネスの作り方
安いモデルへ落として良いかを測る社内evalで、正規表現採点が正しい答えを落とす問題を解決する。生成コードをnode:vmで実行し振る舞いで採点する方法、課題自体の欠陥(設問が二義的/採点が実装スタイルを過剰指定)の切り分け方、そして多くの実装が踏むvmサンドボックス脱出経路の塞ぎ方まで。
配布したhookがWindowsで静かに死ぬのを塞ぐ — process.exit と top-level await
AIエージェントのhookが「出力は正しいのに反映されない」形で無効化される真因と、ネットワークに依存しない回帰テスト・変異テストの型
作業ツリーが汚れた端末にだけ配布が届かない — フォールバックの自家中毒まで含めて塞ぐ
複数端末へgit pullでツールを配る運用で、開発端末にだけ配布が永久に届かない障害。フォールバックの発動条件・人の作業の保護・自分の出力を人の編集と誤認して凍結する二次不具合・自己修復の循環・定期タスクの参照先ずれまで、実際に踏んで直した手順とチェックリスト。
運用ルールをAIに守らせる「宣言強制ゲート」hook
依頼受領時(UserPromptSubmit)に割り込み、応答冒頭で1行の判定宣言を出させることで、委譲・夜間バッチ等の運用ルールを実効化する hook の型。実装コード・登録方法・発火/非発火の検証コマンド・実際に踏んだ落とし穴つき。
CIから自ホストへpushする連携が「届かない日」を、artifactからのpullで埋める
自宅/社内PCやトンネル公開先へCIからPOSTする連携が到達できず落ちる問題を、配達先からartifactを取りに行くpull経路で埋める手順。生成と配達の切り分け、判定表の設計、CIの定時遅延による二重生成の回避、read-back、監視指標の付け替え、計測ツール自身の偽陽性の潰し方まで。
Googleユーザーデータを認証なしローカルアプリに出す — GAS→公開HTTPS橋渡し
自作ダッシュにGoogleタスク/カレンダー等を、アプリにOAuthを持たせずGAS→公開HTTPS ingestへPOST→ローカルキャッシュ→Widgetで表示。Web App公開/clasp run/SA不要。funnel実ポート確認・秘密の置き場・basePath・本番再ビルド等の実測ハマりどころ付き
AIの記憶インデックスが読み込み上限で黙って切られる問題の検出と恒久対策
MEMORY.md 型の索引はサイズ上限で無言に切り捨てられる。バイトで測る→一行要約を本文へ移送→種別プレフィックスの二重持ちを外す→別実装で不変条件を検証、までの手順。最大の罠『デフォルトブランチに入れた≠各マシンで動く』の潰し方付き。
文字化けで宛先が決まらない1件がキューを永久に詰まらせるのを直す
自動処理キューで宛先解決に失敗したアイテムは「失敗」ではなく「スキップ」になり、exit 0 のまま毎晩リトライされ続ける。詰まりの検出、化けた文字列から元テキストを同定する指紋照合、壊れにくい第2キーへの許可リスト型フォールバック、そして「対象外にする」出口までを実例で通す。
複数PCのAIエージェントにルール変更を確実に届ける — 届いたつもりを潰す4つの実測
共有リポジトリ経由でAIのルールを配る構成で、pullだけ自動/pushが手動・間引きが黙って効く・CDNが古い版を返す・dry-runが保護ブランチを教えない、の4つの罠と潰し方。検証は配布経路そのもので行う。
AIの出力を止めるゲートhookが誤爆した時の直し方
テキストマッチで応答を止めるhookは必ず誤爆する。真因の特定(Markdown表が1ブロックになる/引用を実物と数える/満たしようのない要求)から、最小の例外の切り方、過小検知に変えないテスト、配布先まで見る完了判定まで。
自動価格配信の「是正済み」を誤認しない検証手順
配信窓と検証窓の外側は誰も書かず誰も見ないため、旧値が売れ続けても構造的に赤くならない。窓幅の算出・窓外の読み戻し・複合商品の正解の作り方・既定値の根治までを手順化した。
OTA連携で「1室だけ予約が来ない」を3層に分けて切り分ける手順
サイトコントローラー経由の予約ゼロを、①自分側のマッピング ②OTA側の掲載状態 ③実際に送っている在庫・価格 の3層に分けて実値で確定させる読み取り専用の手順。マッピング欠落と決めつける誤診、集計窓による錯覚、先頭数行での早合点、取れなかった実表示の扱い、金額を添えた優先度づけまで。
AI開発ノウハウをチーム共通ハブへ投稿する型
セッション中に得た AI コーディングのルール・失敗パターンを、Drive の追記専用 inbox フォルダに定型フォーマットで投稿し、管理者が正本へ統合する仕組み。各人のローカルにルールが散らばるのを防ぐ。機密値の書き方も規定。
複数PCへ配る設定ファイルを端末固有値を壊さず中央更新する
中央でキーやwebhookを張り替えた瞬間に全端末が静かに死ぬ事故を、キー単位マージ配布・保護キー・ローテーション順序・沈黙検出で構造的に防ぐ手順
内容で行を特定する書き戻しが、ある日から永久に一致しなくなる
スプレッドシートを正本にした業務アプリで「登録できるのに反映されない」が起きる典型。正規化のtrimとsliceの順序で保存値の往復が非冪等になり、全行走査で0件ヒットになる。本番ログからの追い方、ハッシュを変えずに直す方法、重複行事故を防ぐ固定値テストまで。
無人ジョブの沈黙する失敗と効果検証の自動判定
定時ジョブが1行もログを残さずスキップされる事故の検知と、恒久対策の効果検証をジョブ自身に判定させる型。Windows Interactive タスクが無人再起動で捨てられる罠、検証を壊す警告文の是正、全分岐の時間偽装テストまで。
定時ジョブが黙って止まったのを検知して自動修復する見張り番の型
無人ジョブの死活を3層（起動・終了コード・今日の成果物）で判定し、固定した作業コピーでの再実行で自動修復する型。判定不能と非冪等を触らない切り分け、1日1回・3日で打ち切る暴走防止、相互監視、実装を安価モデルへ委譲したときに実行して初めて出る欠陥まで。
Claude Code の hook が「登録済みなのに毎回死ぬ」のを潰す
Windows パスのバックスラッシュ破損で hook が MODULE_NOT_FOUND で死ぬ。JSON として valid・自己点検が名前の部分一致・失敗しても会話が続く、の3層をすり抜けるので放置される。全hookのパス実在を exit code で機械判定する検証スクリプトと、多層エスケープを踏まない修復スクリプト。
ヘッドレスCLI実行がライフサイクルhook経由で通知/ミラーを汚染する問題の恒久対策
定期バッチで非対話起動するCLIエージェントが終了hookで通知/一覧を毎時汚染する問題。--no-session-persistenceだけでは不足、発生源での環境フラグ+entrypoint allowlist+永続トランスクリプト有無での一掃、の多層防御手順。