巻物を探す
35件の巻物
公式APIの無い録音サービスから別SaaSへ音声を自動取り込みする指示書
録音クラウドの音声を文字起こしSaaSへ無人で流す構成。署名付きURLがHEADで403になる/URL長制限/jobIdが返っても取り込まれない、という無言の失敗の潰し方と、変換もストレージも要らない中継プロキシの型。
Gmail 自動仕分け&返信ドラフト生成MD
受信メールを AI が分類 (要返信/情報/営業/スパム) してラベル付けし、要返信メールには返信ドラフトまで自動生成する仕組みを作らせる指示書。DWD (ドメイン全体委任) 設定手順込み。
LINEオープンチャットの投稿を自分のPCに取り込む（トーク履歴エクスポート方式）
LINEのオープンチャットは API も通知転送も塞がっている。唯一通る「トーク履歴エクスポート」を PWA の Web Share Target で受けて全文を蓄積する手順。塞がっている経路の実測結果、実ファイルの正確なフォーマット、全件再取込に耐える冪等設計、失敗検体の保存まで含む。
スプレッドシートの「○印」で回している業務の滞留を検知してDiscordで督促する
請求書発行・入金確認・書類回収など、現場がシートに○を打って管理している業務の遅れを自動検知し、担当者へDM・責任者チャンネルへ一覧を流す仕組み。集約シートが実は同期していない罠、既存夜間同期に相乗りしてAPIコールを増やさない方法、印パーサの4値設計、段階を直列にすると主目的が隠れる落とし穴、初日フラッド対策、退職者への誤送信防止まで、本番投入で踏んだ罠を全部収録。
LLM経由のデータ取り込みを決定論化する — キャッシュが静かに嘘をつくのを止める
AIにAPI結果をJSONへ転記させる構成は、欠落と幻を同時に作り件数の自己申告では検出できない。サービスアカウント+ドメイン全体の委任で依存ゼロの決定論スクリプトに置き換える手順と、読み取り側で「データ無し」と「該当無し」を区別するガードまで。
「予約が無いのに売れない在庫」を3原因に切り分ける（チャネルマネージャ運用）
空いているのに売れない室日を「実予約 / 明示的な売り止め / プラットフォーム由来」に分ける手順。予約APIのページング落ちによる偽陽性、予約済み室日を対照に取る決め手、modifiedキーでの書き込み検証、公開ページ目視まで。
GitHub Actions のジョブ実行時間を実測ベースで削る手順書
cron ジョブの Actions 課金を実測から削る手順。timing/jobs API でのステップ別計測、短時間高頻度の統合と長時間ジョブのバルク化の使い分け、ON CONFLICT の重複キーでチャンクが全落ちする罠、トークンバケットの初期バースト、order 無しページングの取りこぼし、処理欠落をカウンタで機械照合する検証まで。
社内フィードバックを毎日AIの作業キューへ自動取り込みする（安全ゲート付き）
フォームに溜まる不具合・要望を認証付きAPIで毎日取得し、AIエージェントの作業キューへ冪等に積む。無人実行が本番コードを勝手に書き換えないための安全ゲートと、その回帰テストの掛け方まで。
複数PCへ設定ファイルを自動配布する仕組みの設計と落とし穴
APIキーや通知先を全PCへ配り続ける仕組みの作り方。既存ファイルがあると更新が永久に届かない罠、秘密ローテーションで全台ロックアウトする事故、設定コピーによるPC識別の混同を、実装コードと検証手順つきで潰す。
共有秘密をローテーションしても端末を締め出さない鍵配布サーバ設計
全PCへAPIキーを自動配布する小さなサーバで、共有秘密の張り替え時に全端末が永久401になる事故を防ぐ設計と復旧手順。primary/legacy/enrollの3層認証、クライアント側の上書き更新分岐、ローテーションの正しい順序と実測方法
数MBのドキュメント群から必要な記述だけ取り出す — 分割委譲＋逐語照合の型
社内Wiki書き出しやマニュアルの束（数MB）を監督モデルの文脈に載せずに読む手順。1ファイル1サブエージェントで並列抽出し、別エージェントで原文へ差し戻して逐語照合する。読み取りAPIの静かな末尾切れ・全文検索の取りこぼし・「旧版」表記の落とし・出典の帰属ミスという4つの罠と、それを検出するプロンプトの型つき。
受信メール添付を案件フォルダへ自動取込するパイプライン
メールを読むアプリとドライブに書くアプリが別、という現実的な構成で顧客メールの添付を案件フォルダへ無人保存する設計。権限追加を避ける理由、実行時間制限下の予算3本立て、二重の重複防止、base64url/行数上限/変換判定などの実装罠、案件と顧客のマッチング、名寄せは候補提示＋人の承認にする型まで。
散らばったタスクを1枚に統合し、AIが1件ずつ実行して人が直す「タスク台帳」の作り方
複数の機能やシートに散らばった残タスクを1枚に統合し、人がヌケモレを見て、AIが1件ずつ実行し、人が修正指示を書いて再生成させるループを、無人で暴走しない形で回す設計。冪等なマージ規則、外部送信の自動実行禁止、失敗3回で人手に落とす打ち切り、実行環境の時間制限で中断された場合の扱い、復旧コマンドまで含む。
クラウド契約とプロジェクト所在を1枚のスプレッドシート台帳に自動集約する
複数PC・複数クラウドの「どのアカウントの・どこにある・何のプロジェクトか分からない」を、各PCと中央が自動で書き込む3タブの台帳で解消する。支払い情報を安全に扱う許可リスト設計と、実装中に必ず踏む『成功したのに空』の罠4つ(CLIがstderrに表を出す/Windowsの.cmdシム/GASのファイル評価順/クライアントtimeout≠未達)まで含む。
Discord 日報Bot — 売上・KPI を毎朝自動通知
Supabase / スプレッドシートから前日実績を集計して、毎朝 Discord に埋め込み形式で通知する Bot を AI に作らせる指示書。二重通知防止・メンション設計・見落とし対策込み。
社内PCのブラウザ拡張を権限ベースで棚卸しする
「この拡張、危なくない？」を主観で終わらせず、全社の拡張を権限ベースで棚卸しする手順。判定基準、読み取り専用スキャナ、既存点検経路への相乗り、冪等な集約、実POST検証まで。
無人でGoogle Meetに定時自動参加し音声付き配信
Playwright + Chrome 起動フラグ --auto-select-tab-capture-source-by-title で共有ピッカーを出さずタブ(音声込み)を自動選択し、定時に Google Meet へ無人参加して動画配信する仕組み。コンパニオンモード自動フォールバック・OOM対策(preload=metadata)・在室ウォッチドッグ・タスク登録の文字化け回避まで実運用ノウハウ込み。
Driveフォルダの資料を丸ごとLLMに読ませる（夜間ダイジェスト+再開可能バッチ）
案件フォルダのPDF/スライド/Office/写真を全部AIに読ませる設計。Office形式は直接読めないのでDrive変換を挟む、直添付+夜間ダイジェストの二層、1実行1チャンクの部分保存で再開、フィンガープリントで課金を止める、自分の生成物を読み直さない、まで実測ベースで記述。
複数データ源→CIで日次AIサマリー生成→自作PWAへ配信する仕組み
毎朝データ源を横断してLLMに要約・優先順位付けさせ、結果を自作PWAダッシュボードに自動表示。重い取得とLLM呼び出しはシークレットを持つCI側、PWAは結果JSONをingest受信するだけ。CI空変数・本番ビルドstale・dry-run検証の罠つき。
Discordで社内アンケート送信→回答回収→報告
メンバーマスタから user_id を引き、Discord のチームチャンネルにメンション付きで質問を投稿、リアクション/返信で回答を回収、SessionStart フックで追跡を再開し、揃ったらオーナーに集計報告する秘書スキル。YesNo/選択肢/自由記述の3形式に対応。
在庫も価格も正しいのに1件も売れないときの切り分け手順
空室があり値下げもしたのに予約が入らない状態を、値下げに走る前に機械的に診断する手順。販売そのものを止めている設定の洗い出し、セット販売用リスティングを見て『チャネル障害』と誤診する罠、設定変更を success ではなく読み戻しで検証する作法。
カレンダー空き抽出＋オンライン/オフライン日程調整秘書
業務カレンダーから空き時間を抽出し、【調整可/不可】マーカー分類・訪問の移動バッファ・拠点/出張の地域判定・オンライン/オフライン別の候補出しまで行う日程調整の型。予定登録の既定値とプレフィックス規約も同梱。
値下げが元を取れたかを RevPAR で判定する（宿泊・OTA運用）
稼働率だけ見ると値下げの評価を必ず外す。予約明細だけから RevPAR を出し、前年側のイベント汚染を外し、shift-share でチャネル構成変化と自単価変化を分離して、値下げが元を取れたかを exit code で機械判定する手順。
会食・接待の店をMaps URL付きで提案する秘書
場所・人数・予算・ジャンル・参加者特性をヒアリングし、過去履歴シートと Web 検索から会食/接待の店を3-5件提案する秘書スキル。店名特定済みの Google Maps URL 生成・裏取り・履歴追記・次回NG回避・アレルギー配慮まで規定。
夜間の無人AIエージェントバッチが「静かに全滅」するのを止める（観測タスクの立て方）
夜間バッチでAIエージェントを無人実行すると、失敗そのものが誰にも届かない。観測・切り分け・自己修復・報告を別タスクとして立てる手順と、実測で踏んだ4つの静かな全滅経路（spawnの同期throw／先頭ブロックしか読まないパーサ／コンソールのエンコーディング／スリープで未発火）の塞ぎ方。
チャネルマネージャ価格自動化：送信成功を信じず全部屋の実売値を読み戻す
宿泊施設の価格自動更新で「送信成功ログが緑なのに一部の部屋の売値が何ヶ月も変わっていない」事故を防ぐ検証の作り方。連動価格・実効価格パラメータ・列対応の3つの罠つき。
文字化けで宛先が決まらない1件がキューを永久に詰まらせるのを直す
自動処理キューで宛先解決に失敗したアイテムは「失敗」ではなく「スキップ」になり、exit 0 のまま毎晩リトライされ続ける。詰まりの検出、化けた文字列から元テキストを同定する指紋照合、壊れにくい第2キーへの許可リスト型フォールバック、そして「対象外にする」出口までを実例で通す。
自動価格配信の「是正済み」を誤認しない検証手順
配信窓と検証窓の外側は誰も書かず誰も見ないため、旧値が売れ続けても構造的に赤くならない。窓幅の算出・窓外の読み戻し・複合商品の正解の作り方・既定値の根治までを手順化した。
OTA連携で「1室だけ予約が来ない」を3層に分けて切り分ける手順
サイトコントローラー経由の予約ゼロを、①自分側のマッピング ②OTA側の掲載状態 ③実際に送っている在庫・価格 の3層に分けて実値で確定させる読み取り専用の手順。マッピング欠落と決めつける誤診、集計窓による錯覚、先頭数行での早合点、取れなかった実表示の扱い、金額を添えた優先度づけまで。
複数PCへ配る設定ファイルを端末固有値を壊さず中央更新する
中央でキーやwebhookを張り替えた瞬間に全端末が静かに死ぬ事故を、キー単位マージ配布・保護キー・ローテーション順序・沈黙検出で構造的に防ぐ手順
無人ジョブの沈黙する失敗と効果検証の自動判定
定時ジョブが1行もログを残さずスキップされる事故の検知と、恒久対策の効果検証をジョブ自身に判定させる型。Windows Interactive タスクが無人再起動で捨てられる罠、検証を壊す警告文の是正、全分岐の時間偽装テストまで。
定時ジョブが黙って止まったのを検知して自動修復する見張り番の型
無人ジョブの死活を3層（起動・終了コード・今日の成果物）で判定し、固定した作業コピーでの再実行で自動修復する型。判定不能と非冪等を触らない切り分け、1日1回・3日で打ち切る暴走防止、相互監視、実装を安価モデルへ委譲したときに実行して初めて出る欠陥まで。
共有コマンドキューの落とし穴と修正パターン（AIが実行を投げるキュー）
AIエージェントからクラウド関数をリモート実行させるコマンドキュー方式を、実際に運用して初めて露見する5つの欠陥（実行前削除でコマンドが消滅／結果なしを未実行と誤判定／排他ロックが制御を飢えさせる／並行エージェントの二重実行／実行時間上限で毎回全損）と、その修正コードとチェックリスト。
シート対応済みチェック＋期限超過Discord催促
スプレッドシートにチェックボックス列を足し、一定時間経ってもチェックが入らない行を検知して担当者別にDiscordで自動催促するパターン。既存の定時cronに相乗りし、状態管理なしで繰り返し催促が実現できる。導入時の既存行一括処理とタイムゾーン変換の落とし穴も含む。
営業スライド資料をHTML→16:9 PDFで量産＋写真整備パイプライン
HTMLでスライド設計→Playwrightで16:9 PDF化→実写真とAI画像を混在。ImageMagick無しでDrive/Google Photos取得・HEIC変換・EXIF回転焼き込み縮小・ロゴcanvasモザイク・gpt-image-1生成・Drive URL不変更新まで。固定px設計時の@page一致(フッター重なり)の罠も収録。