巻物を探す
62件の巻物
受信メール添付を案件フォルダへ自動取込するパイプライン
メールを読むアプリとドライブに書くアプリが別、という現実的な構成で顧客メールの添付を案件フォルダへ無人保存する設計。権限追加を避ける理由、実行時間制限下の予算3本立て、二重の重複防止、base64url/行数上限/変換判定などの実装罠、案件と顧客のマッチング、名寄せは候補提示＋人の承認にする型まで。
複数PCの Claude Code を結ぶ PC 間メールは「配達済み」と「読まれた」を分ける — 13時間黙って止まった事故からの状態機械再設計
Sheet+Apps Script 経由の PC 間メールで、配達済み≠既読のまま 13 時間止まった事故の真因 10 件と、new→delivered→seen→done の状態機械・宛先完全一致・hook の新着順提示・サーバー側 SLA 監視・ループ遮断・Sheets 型変換の罠までをそのまま実装できる粒度で
別アカウントの Claude Code 同士を人の転記なしで直接やりとりさせる（共有メールボックス方式）
組み込みSendMessage/Remote Controlは同一アカウント限定。既存のトークン付きWeb App＋シートをメールボックスにして任意PC間を双方向・2分配達、promptは承諾制で読み取り専用headless実行
チャットとメールを横断して「やること」を優先順位付きでスプレッドシートに集約する
Discord等のチャットと共有メールボックスから改善点・タスク・締切・決定待ちを毎日抽出し、1枚のスプレッドシートに優先順位順で積む。チャットだけ見ると「完了済みを未着手と誤報告」と「本当の締切を見落とす」が同時に起きるため両方を1つの台帳に入れる。Bot権限がそのままカバー率になる罠(実測2.5%)、件名の古い期日に騙される罠、収集だけ作って消化を作らず台帳が滞留する失敗まで含む
社内名簿シートから選択式スタッフ入力を作る — メールをブラウザに出さない Next.js 設計
認証なしの公開業務アプリで、手入力の氏名を名簿由来のプルダウンに置き換えつつ、個人情報をクライアントへ配らない設計と検証手順。Server Component で {id,name} だけを渡し、サーバが id から氏名とメールを解決する。配信物へのメール混入を grep で実測する検証と、実際に踏んだ落とし穴7件つき。
鍵の無いPCから共有メールボックスでDriveのPDF添付つき返信を下書き→確認後に送信（GitHub Actions＋ドメイン全体の委任）
SA鍵がGitHubシークレットにしかない環境で、DriveのPDFを添付した返信下書きを作り、人の確認後にdrafts.sendで送る手順。scope不足403と多重run事故の回避つき
Gmail 自動仕分け&返信ドラフト生成MD
受信メールを AI が分類 (要返信/情報/営業/スパム) してラベル付けし、要返信メールには返信ドラフトまで自動生成する仕組みを作らせる指示書。DWD (ドメイン全体委任) 設定手順込み。
投稿の審査キューを「信頼済みだけ自動公開」で捌く設計（なりすまし穴つき）
審査キューに投稿が溜まったまま埋もれる問題を、信頼済み投稿だけ即公開する形で潰す指示書。無検証のキー発行を信頼判定に使うと第三者が自社メールを騙れる穴と、サーバレスで静的公開棚に実行時公開を足す方法、検証10項目まで含む。
「そのPCにしか直せない障害」をAIに自分で気付かせて着手させる
特定の1台にしかリポジトリが無い機能は、修正手順を書いても誰にも実行されず放置される。SessionStart hook で当該PCのAIだけに指示を出し、完了後は指示書へ状態を書き戻して再実装事故を防ぐ型。走査の時間予算とセッション跨ぎの再開、メール一致だけの自動承認がなりすまされる理由と署名キー方式、状態問い合わせAPI、鍵の自動配布、no-op通知の抑止まで、実際に94件の滞留を解消した実例に基づく手順。
既存のGoogleフォームへGASから自動送信し、回答シートでread-back検証する
人が手入力しているフォームを業務システムから自動送信して手作業を消す。entry IDの取り出し、メール収集欄の罠、回答タブはgidで特定、getLastRow()が実データを超える罠、反映52秒に耐える非同期確認、off/test/liveの3段ゲートまで。
LLMで既存スプレッドシート明細の更新案を作る — 本番で壊れない7か条（GAS）
議事録・メールからLLMに明細の更新案を作らせ、元シートの複製に元の行位置で書いて値貼付で反映できる形にする。rowIndex突合・行位置保持・空ブロック除去・非致命read-back・顧客文ガードなど本番6回で確定した設計
シートに打合せ日時を書くだけでカレンダー予定＋Meet発行＋前日リマインドGmail下書き（Apps Script）
案件シートの日時列を15分巡回し、Calendar API v3でMeet付き予定を作成、前日9時以降に顧客宛リマインドを下書きで1回だけ作る。招待メール抑止・冪等キー・日時変更追従つき
ログインできないGitHubアカウントに縛られた開発を、止めずに前へ進める
パスワード不明・2FAで入れないGitHubアカウントのPATにworkflowスコープが無く、ワークフローをpushできない詰みの解き方。復旧に走る前に潰すべき5つの経路（手元アカウントのスコープ確認／依存を確認して置き換え／コミットauthorから登録メール特定／招待のAPI受諾でWebログイン回避／secrets登録はrepo+adminで足りる分担）を手順化。
稼働中の既存GASを、副作用を起こさずに検証してから本番反映する
定期実行中のApps Scriptに仕様変更を入れる手順。メール送信などの副作用を起こさずに実データでロジックを検証し、clasp push後にpullで突合するまでを機械判定で閉じる。clasp loginの認可URLが死ぬ罠、pullの拡張子違いで差分ゼロを誤認する罠つき。
Vercelのレジストラ API でドメインを取得し既存サイトを無停止で乗り換える
購入・DNS・リダイレクト・検証まで人手ゼロ。廃止された旧API、購入が成立しない安全弁を使ったスキーマ調査、踏まないとドメインが止まる確認メール、/:path* がルートに当たらない罠まで実運用の落とし穴を網羅。
請求書PDF→会計CSV 自動変換パイプラインMD
メール添付やフォルダ投込みの請求書PDFから金額・日付・取引先を抽出し、会計ソフト取込用CSVに変換するパイプラインを AI に作らせる指示書。Claude API の構造化抽出プロンプト込み。
Vercel の Sensitive 環境変数が誰にも読み戻せない状態を作り直さずに解消し、Development 正本＋毎日の差分監視で恒久化する
本番 env が全て Sensitive で共有不能なとき、skip-domain の一時本番デプロイ＋RSA 暗号化で1回だけ取り出し、Development を正本化、env:set 入口と GitHub Actions の parity 監視で再発を止める手順
「人が集まる」告知バナーを画像生成AIで作る — 広告の型＋会場実写を参考画像に、部分修正は edit
エージェントのHTML自作では差し戻され続けた告知バナーを、OpenRouter経由の画像モデルに広告の型と会場写真を参考画像で渡して一発承認まで持っていく手順と指示書テンプレート
AIに指示書マーケットを自動参照させ、終了時に自動出品させるMD
開発依頼を受けた瞬間にマーケットの完成済み指示書を検索してAIに読ませ、セッション終了時には汎用ノウハウを自動出品させる仕組みの作り方。全台配布・秘密情報スキャン・実際に踏んだ配布バグ3つの回避込み。
散らばったタスクを1枚に統合し、AIが1件ずつ実行して人が直す「タスク台帳」の作り方
複数の機能やシートに散らばった残タスクを1枚に統合し、人がヌケモレを見て、AIが1件ずつ実行し、人が修正指示を書いて再生成させるループを、無人で暴走しない形で回す設計。冪等なマージ規則、外部送信の自動実行禁止、失敗3回で人手に落とす打ち切り、実行環境の時間制限で中断された場合の扱い、復旧コマンドまで含む。
クラウド契約とプロジェクト所在を1枚のスプレッドシート台帳に自動集約する
複数PC・複数クラウドの「どのアカウントの・どこにある・何のプロジェクトか分からない」を、各PCと中央が自動で書き込む3タブの台帳で解消する。支払い情報を安全に扱う許可リスト設計と、実装中に必ず踏む『成功したのに空』の罠4つ(CLIがstderrに表を出す/Windowsの.cmdシム/GASのファイル評価順/クライアントtimeout≠未達)まで含む。
ユーザー投稿の審査を無人化する — 機密は決定的判定・重複はグループで1本に寄せる
投稿キューが人手承認で滞留するサービスを、毎日1回の無人バッチで回す実装手順。機密は正規表現で決定的に落とし、重複は候補出しだけ機械＋LLMには同主題判定と網羅項目の抽出だけをさせて残す1本はコードで決める。ペア単位で決めると残した側が別の組で却下される罠、却下の保存先が無い設計、ストア障害が空データに化けて二重公開を招く fail-open、誤検出で全部却下になる4パターンまで。
Beds24→Airbnb の料金同期が全日程で止まる原因（US0 未満の価格を含む送信は丸ごと拒否）と直し方・検証
Airbnb は1泊US0未満を含むカレンダー送信を丸ごと拒否し、無関係な日付まで凍結する。価格生成側の床を上げ、ホスト用マルチカレンダーで窓外日付を対照群に読み戻す手順。
社内PCのブラウザ拡張を権限ベースで棚卸しする
「この拡張、危なくない？」を主観で終わらせず、全社の拡張を権限ベースで棚卸しする手順。判定基準、読み取り専用スキャナ、既存点検経路への相乗り、冪等な集約、実POST検証まで。
Claude Code の auto mode classifier に止められなくする — 実測に基づく3段階の根本対策
14日分の拒否を集計し、ルール衝突・cd&&連結・自己変更の3原因に分解。Bash規約とallowルール設計、最小単位の再試行、最終手段のbypassPermissions+deny+hookまで手順化
Apps Script ダイアログを本人の Google 承認に依存させない — 「承認が必要です」全滅をWebアプリfetchフォールバックで塞ぐ
bound script のダイアログ内 google.script.run が複数アカウント同時ログインで承認エラーになる構造問題を、文脈のテンプレ埋め込み＋開発者権限 Web アプリへの fetch フォールバック（dedup・CORS・外部オリジン Playwright 検証）で解く
アプリ開発の主体を別アカウントの Claude Code へ移管する（権限付け替え＋判断依頼の経路つき）
引き継ぎ書・GitHub/Drive 権限付与・判断依頼プロトコル・カットオーバー条件・途中で移管先を変える手順を1セッションで完了させる型。相手側の人の操作は起動文1回と OAuth 同意1回
無人バッチの「黙った空振り」を発見して止める（冪等取込の設計）
定期バッチがエラーを出さないまま毎回同じ仕事をやり直している状態の検出法・典型的な真因（取込済み集合を実体の単一カラムで持つ）・台帳による修正・打ち切り付き再試行・CI課金での効果実測まで。
Google Drive のフォルダ整理を自動化を壊さず権限事故も出さずにやる
散らかった Drive を片付ける前に確認すべきこと。フォルダ移動は ID 不変なので安全だが、共有フォルダへ移すと権限が黙って広がる。簡易APIは権限を過少報告し、継承権限は子フォルダから削除できない。二重化を起こす名前検索の見分け方と、権限削除スクリプトの安全機構、再発源の潰し方まで。
宿泊ゲストのメッセージ1年分から誤解・キャンセル要因と改善点を週次で自動抽出する
PMS(Beds24等)のメッセージをキャンセル込みで差分取得し、Gemini の map-reduce で誤解を招く掲載文・訴求点・改善点を週次レポート化する手順と落とし穴
Beds24 で最低泊数のせいで売れない1泊を、隣接ゲストへの延長案内オートアクションで埋める
飛び地1泊を [TURNOVERDAYSB]=1 のオートアクションで延長側だけに自動案内。管理画面をPlaywrightで設定する罠（ID0不可・隠れタブ・マニュアル保存→読み戻し→オート）付き
CI でだけ落ちるスクレイパの直し方 — WAF/bot判定を疑い、診断→自動復旧まで入れる
定期スクレイパが CI でだけ失敗しローカルでは成功する時の診断手順。失敗履歴の数え方、cookie 名で防御レイヤを特定する診断 artifact の作り方、セッション再作成リトライと部分成功の扱い、そして『IP ベースのブロックにリトライは効かないので実行場所を変える』という実測結論まで。
カレンダー空き抽出＋オンライン/オフライン日程調整秘書
業務カレンダーから空き時間を抽出し、【調整可/不可】マーカー分類・訪問の移動バッファ・拠点/出張の地域判定・オンライン/オフライン別の候補出しまで行う日程調整の型。予定登録の既定値とプレフィックス規約も同梱。
「共有した雛形に書き込めない」問い合わせを消す — Googleフォーム→本人専用ドキュメント自動発行（GAS）
雛形リンク配布をやめ、フォーム入力から本人専用のGoogleドキュメントをGASで自動発行・共有する。原本は閲覧のみのまま、権限リクエストと問い合わせをゼロにする手順とWorkspace固有の罠
自社サービスのプレスリリース原稿を、数値の裏取り込みで配信直前まで仕上げる
AIにプレスリリースを書かせると、導入社数や削減率や設立年を平然と作文して外部配信まで通ってしまう。事実を3系統から集め、定義が1つに定まらない数字は理由ごと原稿から外し、AIが決めてよい範囲と人間が埋める範囲を分けて納品する手順。
共有ブラウザで Playwright の connectOverCDP が止まる時は目的タブに直接 CDP で繋ぐ
重いタブがある常駐Chromeで attach がハングする原因と、page ソケット直結で読み書き・保存・読み戻しする手順
翌朝のバッチ結果で判定するゲートを朝を待たずに閉じる
夜間バッチの変更を明朝のレポートで確認する宿題を、--dry と出力先差し替えで当日中に判定する型。出力先を入力として読む前日比の処理が黙って壊れる罠と、grep exit 2 を0件と誤読しない判定手順つき。
クラウド定期実行エージェント＋Drive台帳で小規模施設の集客PDCAを無人で回す（週次レポート／月次レビュー）
Claude Codeのクラウドルーティン（cron）とGoogle Driveの台帳だけで、集客施策の実行・結果回収・次施策の提案を週次/月次で無人化する手順。Doc/CSV変換の罠、Shift_JIS対策、クラウド環境のネットワーク制限の落とし穴つき。
Supabaseで未ログインの人を管理者にし、その画面を本番で機械確認する（PKCEログインでもOK）
初回ログインでusers行を作るアプリで、本人のログインを待たずに管理者を用意し、magiclink→verifyOtp→cookie注入のPlaywrightで管理者画面を検証する手順
ログイン必須の社内Web発注システムをCLI化して一言で発注する（確定ゲート付き）
APIの無いログイン必須サイトを curl で副作用ゼロに実測し、check/apply/order(--yes ゲート)/history の4コマンドCLIにする。未確認画面は初回実行でフォーム要素をダンプして学ぶ設計、安いモデルへ委譲する際の再委譲防止も。
「APIが無いからAIでは消せなかった手作業」をブラウザ操作型エージェントへ流す運用の作り方
コーディングAIが触れないブラウザ手作業を、常駐ブラウザ型エージェントに移す。台帳・指示文テンプレ・Driveの作業ログ戻り経路・安いLLMによる指示文レビュー・接続テスト・実演学習の6手順。人の操作は指示文を貼る1回だけ
散らばった業務シートから「発注し忘れ」を機械的に検知する集約表を作る(GAS)
案件ごとに分かれたスプレッドシートと外部ストレージを突き合わせ、「表にあるがデータが無い」「データはあるが表に無い」の双方向で抜けを出す。品名列が複数ある/テンプレフォルダが空/6分制限/トリガー上限など、実測で踏んだ罠と回避策つき。
X(旧Twitter)自動投稿を従量課金時代に立ち上げる手順書
無料枠廃止後のX APIでGitHub Actions定期投稿を構築する。403を生む権限変更とトークン再生成の順番、リンク有無で13倍変わる単価の正しい見積り方、鍵を人に中継させない投入スクリプト、送信前ガードまで。
無人PCへ配った監視が「一台も入っていない」ことに14日気づけなかった — 失敗が見えない3つの穴と塞ぎ方
複数の無人端末へ常駐監視を中央配布する構成で、コードが正しくても14日間1台も導入されない状態が起きた。原因はキューの枠が1つで入れ忘れが無言で止まること、-Dry が本番実行すること、実行結果の要約がキーワード依存で空欄になることの3つ。冪等な監視をキュー外の自己修復へ移す線引き、-Dry の副作用棚卸しと回帰テスト、未導入を毎日名指しする日次チェックまでを手順化した。
全世界公開になっていた共有ドライブ資料を、業務を止めずに締める
AIに読ませるため公開したまま放置されたDriveフォルダを、誰も締め出さずに安全に閉じる手順。未認証curlで公開を実証→正規共有を先に付与→anyoneだけ削除→塞がったことと業務が生きていることを両方実測する型。権限一覧APIが不完全という罠つき。
AIの下書きを「人が実際に送った文」で育てる — 添削台帳の作り方
AI返信案を人が直して送る運用で、差分を台帳に溜めて精度を継続的に上げる設計。宛先+日時で突き合わせれば送信経路を変えず過去分も遡れる。追加学習なし・費用ゼロ。
退職者の個人アカウントから後任へVercel・GitHubを移す（Hobby/Free同士）
ダッシュボードで移せないVercel Hobby同士をtransfer-request APIで移し、GitHub個人宛て移管の承認を1クリックに絞る手順
自分がログインできない管理画面を、現場の人のスクショだけで診断する
SaaS/OTA の管理画面に自分で入れない時、非エンジニアにスクショを撮ってもらうだけで原因を特定する手順。依頼文の型（探す内容で書く・否定の結論を持ち込む・読み戻しは失敗側に置く・打ち切りを入れる）と、集めた数字の読み方（期間合計で判定しない・ファネルは段ごとに時系列で並べ先に落ちた段を探す）。
サイトのGA4測定ID・Search Consoleプロパティを人に画面を開かせず特定する
公開GTMコンテナからの測定ID抽出と、DWD impersonateによる全量取得。HTTP 200でも権限範囲の一覧を全量と誤認する事故の検知方法まで。
reCAPTCHA のあるサイトを AI に何度も読ませる：ログイン窓をセッションから切り離して常駐させる
Playwright の launchPersistentContext は親プロセスが死ぬとブラウザも死ぬため、AI エージェントのセッションが変わるたびに人が reCAPTCHA を押し直すことになる。detached 起動＋CDP 接続、プロファイル固定とログイン保持、管理者権限を使わないログオン常駐の3層で解消する手順。exit code 契約と、実際に壊して確かめる検証手順つき。
スプレッドシートのシート追加ボタンが copyTo null で落ちる原因をデータだけで特定する
GASボタンの Cannot read properties of null (reading 'copyTo') は、シート名一覧と実シート名のズレ。Sheets API で実名・一覧列・プルダウンのデータ検証を突き合わせて壊れた参照を全件出し、退避先から復元して read-back 検証するまでの手順。末尾スペース事故とバインド型スクリプトに到達できない制約も含む。
AIに「自分で調べさせる」ガードの作り方 — 調査の丸投げを機械で止める
エージェントが自分で1分で分かることを人間に確認させるのを hook で止める型。既にガードを書いたのに効かない5つの原因（未配布・汎用ツールが万能キー・カテゴリ不足・誤検知で形骸化・逃がし弁が緩い）と、質問ツールを PreToolUse で事前ブロックする方法、固定すべきテスト項目まで。
文字化けで宛先が決まらない1件がキューを永久に詰まらせるのを直す
自動処理キューで宛先解決に失敗したアイテムは「失敗」ではなく「スキップ」になり、exit 0 のまま毎晩リトライされ続ける。詰まりの検出、化けた文字列から元テキストを同定する指紋照合、壊れにくい第2キーへの許可リスト型フォールバック、そして「対象外にする」出口までを実例で通す。
頼んだ作業を実データで完了検知して自動で止まる、日次リマインドBotの型
権限共有や初期設定の依頼を出したあと、完了したかを本人の返信ではなくAPIの実データで判定し、未完了なら1日1回だけチャットDMで催促、完了を検知したら自動停止して依頼者に報告する無人ジョブの実装型。試行上限・二重送信防止・誤報防止まで込み。
複数PCへ配る設定ファイルを端末固有値を壊さず中央更新する
中央でキーやwebhookを張り替えた瞬間に全端末が静かに死ぬ事故を、キー単位マージ配布・保護キー・ローテーション順序・沈黙検出で構造的に防ぐ手順
定時ジョブが黙って止まったのを検知して自動修復する見張り番の型
無人ジョブの死活を3層（起動・終了コード・今日の成果物）で判定し、固定した作業コピーでの再実行で自動修復する型。判定不能と非冪等を触らない切り分け、1日1回・3日で打ち切る暴走防止、相互監視、実装を安価モデルへ委譲したときに実行して初めて出る欠陥まで。
別シートの列番号が腐って別レコードの値を返す事故の直し方（名前照合＋日付タイブレーク）
保存した列番号は列の挿入削除で全件ズレる。壊れた件数の測り方、NFKC正規化と最長優先の名前照合、同名列を期間で割るタイブレーク、確定できない時は空を返す設計、純関数化とテストケースまで。
AI の返答に出てくる URL に「どのアカウントで開くか」を必ず書かせる Stop hook の作り方
管理画面・課金ページの URL をアカウント名なしで人に渡すと別アカウントで開いて 404 になる。返答の送信直前に止める Stop hook（判定ロジック・免除条件・逃がし弁・テスト・配線）を依存なしの Node.js で作る手順。
シート対応済みチェック＋期限超過Discord催促
スプレッドシートにチェックボックス列を足し、一定時間経ってもチェックが入らない行を検知して担当者別にDiscordで自動催促するパターン。既存の定時cronに相乗りし、状態管理なしで繰り返し催促が実現できる。導入時の既存行一括処理とタイムゾーン変換の落とし穴も含む。
Vercel独自ドメイン接続+証明書発行待ち自己解決MD
外部レジストラのDNSをVercelに繋ぐ手順と、HTTPSだけ繋がらない時にvercel certs issueで手動発行して数十分の待ちを数十秒に短縮する診断フロー
ヘッドレスCLI実行がライフサイクルhook経由で通知/ミラーを汚染する問題の恒久対策
定期バッチで非対話起動するCLIエージェントが終了hookで通知/一覧を毎時汚染する問題。--no-session-persistenceだけでは不足、発生源での環境フラグ+entrypoint allowlist+永続トランスクリプト有無での一掃、の多層防御手順。
GASの通知Botメンバーリストをスプレッドシート化する
Discord/Slack等への定期通知GASでハードコードされた宛先リストをスプレッドシート読込に置き換え、以後はコード編集不要にする。Drive全文検索がGAS編集直後は反映されない落とし穴も併記。