巻物を探す
64件の巻物
Beds24 API で「全室が既定レート固定」と誤診しない読み方(連動価格フラグの罠と読み取りツール)
Beds24 の料金カレンダー API は includeLinkedPrices=true を付けないと連動先の部屋が既定レート一定で返り、値付け欠陥と誤診する。見分け方・実表示での裏取り・常にフラグ付きで読む読み取り専用ツール(純関数テスト付き)の作り方。
API に無い OTA 設定の出どころを、チャネルマネージャの管理画面から特定する
APIを変えてもOTAが動かない時、priceRuleで止めず全数走査で『API無し』を確定し、管理画面のチャネル固有コンテンツ欄(部屋別・入力欄value・リダイレクト警戒)を読んで出どころを特定する手順
到着日で絞る予約APIが滞在中ゲストを落とす — 空室・閉室の誤判定を防ぐ遡り取得
PMSの予約一覧APIを期間の開始日から引くと期間前に着いた滞在中ゲストが消え、在室中の部屋を開け忘れと誤判定してダブルブッキングに進む。最長滞在ぶん遡って取り泊単位で照合する実装と、人に聞く前の確認手順。
公式APIの無い録音サービスから別SaaSへ音声を自動取り込みする指示書
録音クラウドの音声を文字起こしSaaSへ無人で流す構成。署名付きURLがHEADで403になる/URL長制限/jobIdが返っても取り込まれない、という無言の失敗の潰し方と、変換もストレージも要らない中継プロキシの型。
「APIが無いからAIでは消せなかった手作業」をブラウザ操作型エージェントへ流す運用の作り方
コーディングAIが触れないブラウザ手作業を、常駐ブラウザ型エージェントに移す。台帳・指示文テンプレ・Driveの作業ログ戻り経路・安いLLMによる指示文レビュー・接続テスト・実演学習の6手順。人の操作は指示文を貼る1回だけ
既存の業務スプレッドシートに「成果物シート」を自動追加する(Driveコネクタでは不可・Sheets API直叩き)
調査結果や候補リストを新規ファイルではなく案件の正本スプレッドシートの新タブとして足す手順。DriveコネクタにaddSheetが無い点、タブ名rangeのクォート、gid付きURL、read-back verify、Windows の file:/// import まで。
Gmail 自動仕分け&返信ドラフト生成MD
受信メールを AI が分類 (要返信/情報/営業/スパム) してラベル付けし、要返信メールには返信ドラフトまで自動生成する仕組みを作らせる指示書。DWD (ドメイン全体委任) 設定手順込み。
Beds24 経由の Airbnb 追加人数料金は priceRule では変わらない — 本当の設定場所とログイン済み窓からの読み書き
Airbnb の追加人数料金/基本人数は Beds24 の priceRule でも API でもなく管理画面の Airbnb 専用欄(syncroniserairbnbroom)が制御する。&roomid= 無視の罠、コンテンツの確認での読み戻し、CDP 常駐窓で dry-run 既定・部屋照合つきに書くツールの仕様
LINEオープンチャットの投稿を自分のPCに取り込む(トーク履歴エクスポート方式)
LINEのオープンチャットは API も通知転送も塞がっている。唯一通る「トーク履歴エクスポート」を PWA の Web Share Target で受けて全文を蓄積する手順。塞がっている経路の実測結果、実ファイルの正確なフォーマット、全件再取込に耐える冪等設計、失敗検体の保存まで含む。
スプレッドシートの「○印」で回している業務の滞留を検知してDiscordで督促する
請求書発行・入金確認・書類回収など、現場がシートに○を打って管理している業務の遅れを自動検知し、担当者へDM・責任者チャンネルへ一覧を流す仕組み。集約シートが実は同期していない罠、既存夜間同期に相乗りしてAPIコールを増やさない方法、印パーサの4値設計、段階を直列にすると主目的が隠れる落とし穴、初日フラッド対策、退職者への誤送信防止まで、本番投入で踏んだ罠を全部収録。
LLM経由のデータ取り込みを決定論化する — キャッシュが静かに嘘をつくのを止める
AIにAPI結果をJSONへ転記させる構成は、欠落と幻を同時に作り件数の自己申告では検出できない。サービスアカウント+ドメイン全体の委任で依存ゼロの決定論スクリプトに置き換える手順と、読み取り側で「データ無し」と「該当無し」を区別するガードまで。
ログイン必須の社内Web発注システムをCLI化して一言で発注する(確定ゲート付き)
APIの無いログイン必須サイトを curl で副作用ゼロに実測し、check/apply/order(--yes ゲート)/history の4コマンドCLIにする。未確認画面は初回実行でフォーム要素をダンプして学ぶ設計、安いモデルへ委譲する際の再委譲防止も。
「予約が無いのに売れない在庫」を3原因に切り分ける(チャネルマネージャ運用)
空いているのに売れない室日を「実予約 / 明示的な売り止め / プラットフォーム由来」に分ける手順。予約APIのページング落ちによる偽陽性、予約済み室日を対照に取る決め手、modifiedキーでの書き込み検証、公開ページ目視まで。
GitHub Actions のジョブ実行時間を実測ベースで削る手順書
cron ジョブの Actions 課金を実測から削る手順。timing/jobs API でのステップ別計測、短時間高頻度の統合と長時間ジョブのバルク化の使い分け、ON CONFLICT の重複キーでチャンクが全落ちする罠、トークンバケットの初期バースト、order 無しページングの取りこぼし、処理欠落をカウンタで機械照合する検証まで。
社内フィードバックを毎日AIの作業キューへ自動取り込みする(安全ゲート付き)
フォームに溜まる不具合・要望を認証付きAPIで毎日取得し、AIエージェントの作業キューへ冪等に積む。無人実行が本番コードを勝手に書き換えないための安全ゲートと、その回帰テストの掛け方まで。
Apps Script ゲートウェイ経由の無人ジョブが稀に Unauthorized で落ちる — 本文落ちの判定と有界リトライ
GAS Web App を API ゲートウェイにした Node の夜間ジョブが、トークンも正しいのに稀に Unauthorized / 非JSON で落ちる。受信ログの (no action) で「POST 本文が落ちた一時障害」と 30 秒で判定し、一時障害の署名だけを 2s→4s→8s で有界リトライする分類関数・テスト・本番入口での検証手順まで。
複数PCへ設定ファイルを自動配布する仕組みの設計と落とし穴
APIキーや通知先を全PCへ配り続ける仕組みの作り方。既存ファイルがあると更新が永久に届かない罠、秘密ローテーションで全台ロックアウトする事故、設定コピーによるPC識別の混同を、実装コードと検証手順つきで潰す。
共有秘密をローテーションしても端末を締め出さない鍵配布サーバ設計
全PCへAPIキーを自動配布する小さなサーバで、共有秘密の張り替え時に全端末が永久401になる事故を防ぐ設計と復旧手順。primary/legacy/enrollの3層認証、クライアント側の上書き更新分岐、ローテーションの正しい順序と実測方法
頼んだ作業を実データで完了検知して自動で止まる、日次リマインドBotの型
権限共有や初期設定の依頼を出したあと、完了したかを本人の返信ではなくAPIの実データで判定し、未完了なら1日1回だけチャットDMで催促、完了を検知したら自動停止して依頼者に報告する無人ジョブの実装型。試行上限・二重送信防止・誤報防止まで込み。
数MBのドキュメント群から必要な記述だけ取り出す — 分割委譲+逐語照合の型
社内Wiki書き出しやマニュアルの束(数MB)を監督モデルの文脈に載せずに読む手順。1ファイル1サブエージェントで並列抽出し、別エージェントで原文へ差し戻して逐語照合する。読み取りAPIの静かな末尾切れ・全文検索の取りこぼし・「旧版」表記の落とし・出典の帰属ミスという4つの罠と、それを検出するプロンプトの型つき。
受信メール添付を案件フォルダへ自動取込するパイプライン
メールを読むアプリとドライブに書くアプリが別、という現実的な構成で顧客メールの添付を案件フォルダへ無人保存する設計。権限追加を避ける理由、実行時間制限下の予算3本立て、二重の重複防止、base64url/行数上限/変換判定などの実装罠、案件と顧客のマッチング、名寄せは候補提示+人の承認にする型まで。
Google スプレッドシートの数式・外部参照を xlsx エクスポート+openpyxl で AI に監査させる(開放範囲の切り詰め表示の罠つき)
数万数式・多数の IMPORTRANGE を持つスプレッドシートを読み取り専用で丸ごと解析する手順。DUMMYFUNCTION の復元、開放範囲が xlsx で切り詰め表示される罠をキャッシュ値の再計算で見抜く方法、QUERY の列対応、バインド GAS を直す前に clasp pull する理由まで。
自動で価格・在庫を動かすAIに『毎日実機を見て・結果で判断して・止まったら気づく』をさせる運用の作り方
客側画面の実機読み戻し、同じ画面の近隣価格との比較、決定台帳の再判断日、PC外の心拍監視、出力妥当性検査、過去事故の自動プローブ化までを1日5回の点検ジョブで回す型
散らばったタスクを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チャンクの部分保存で再開、フィンガープリントで課金を止める、自分の生成物を読み直さない、まで実測ベースで記述。
チャットとメールを横断して「やること」を優先順位付きでスプレッドシートに集約する
Discord等のチャットと共有メールボックスから改善点・タスク・締切・決定待ちを毎日抽出し、1枚のスプレッドシートに優先順位順で積む。チャットだけ見ると「完了済みを未着手と誤報告」と「本当の締切を見落とす」が同時に起きるため両方を1つの台帳に入れる。Bot権限がそのままカバー率になる罠(実測2.5%)、件名の古い期日に騙される罠、収集だけ作って消化を作らず台帳が滞留する失敗まで含む
宿泊ゲストのメッセージ1年分から誤解・キャンセル要因と改善点を週次で自動抽出する
PMS(Beds24等)のメッセージをキャンセル込みで差分取得し、Gemini の map-reduce で誤解を招く掲載文・訴求点・改善点を週次レポート化する手順と落とし穴
複数データ源→CIで日次AIサマリー生成→自作PWAへ配信する仕組み
毎朝データ源を横断してLLMに要約・優先順位付けさせ、結果を自作PWAダッシュボードに自動表示。重い取得とLLM呼び出しはシークレットを持つCI側、PWAは結果JSONをingest受信するだけ。CI空変数・本番ビルドstale・dry-run検証の罠つき。
Beds24 で最低泊数のせいで売れない1泊を、隣接ゲストへの延長案内オートアクションで埋める
飛び地1泊を [TURNOVERDAYSB]=1 のオートアクションで延長側だけに自動案内。管理画面をPlaywrightで設定する罠(ID0不可・隠れタブ・マニュアル保存→読み戻し→オート)付き
Discordで社内アンケート送信→回答回収→報告
メンバーマスタから user_id を引き、Discord のチームチャンネルにメンション付きで質問を投稿、リアクション/返信で回答を回収、SessionStart フックで追跡を再開し、揃ったらオーナーに集計報告する秘書スキル。YesNo/選択肢/自由記述の3形式に対応。
自社の沿革を登記簿+公式リリース+Webから総合して年表スプレッドシートにする
Web記事だけで沿革を作ると設立地も年号も間違える。登記簿を骨格にし、公式リリースを肉にし、Web検索は裏取りだけに使う手順。確度列つきの表設計、CSVのカラム崩れ検査、更新でURLが変わる罠まで。
在庫も価格も正しいのに1件も売れないときの切り分け手順
空室があり値下げもしたのに予約が入らない状態を、値下げに走る前に機械的に診断する手順。販売そのものを止めている設定の洗い出し、セット販売用リスティングを見て『チャネル障害』と誤診する罠、設定変更を success ではなく読み戻しで検証する作法。
カレンダー空き抽出+オンライン/オフライン日程調整秘書
業務カレンダーから空き時間を抽出し、【調整可/不可】マーカー分類・訪問の移動バッファ・拠点/出張の地域判定・オンライン/オフライン別の候補出しまで行う日程調整の型。予定登録の既定値とプレフィックス規約も同梱。
自社サービスのプレスリリース原稿を、数値の裏取り込みで配信直前まで仕上げる
AIにプレスリリースを書かせると、導入社数や削減率や設立年を平然と作文して外部配信まで通ってしまう。事実を3系統から集め、定義が1つに定まらない数字は理由ごと原稿から外し、AIが決めてよい範囲と人間が埋める範囲を分けて納品する手順。
Beds24→Airbnb で1室だけ「全日予約不可+定価」になる原因と直し方(基本人数と料金ルールの人数不一致)
Beds24 では空室・価格正常なのに Airbnb で1室だけ予約不可になる症状を、ホスト画面カレンダーの『定価のまま』指紋で切り分け、Airbnb 特定コンテンツの基本人数が料金ルールの人数を超えている原因を確定し、戻して『アップデート』で再送するまでの手順。エラー文言は存在しないので探さない。
無人のAI委譲が「毎日成功」の裏で全滅する3つの穴と塞ぎ方
受け取りファイルの置き場所・上限エラーの保留化・作業種別の振り分けで、Codex 等への無人委譲が静かに全滅するのを防ぐ。完了の定義は実環境1件の成功ログだけ
新しいAIモデルを自動で見つけて採用提案まで届ける(model-scout→eval→提案セッション)
OpenRouter公開カタログの差分で新モデル・値下げを検知し、当日evalで品質を測り、合格した候補を『次に開くセッションの先頭に出る実装提案』として届ける仕組みの設計と落とし穴(reset --hardで消える保存先・衝突PRでCIが出ない・Windowsのfile URL)
値下げが元を取れたかを RevPAR で判定する(宿泊・OTA運用)
稼働率だけ見ると値下げの評価を必ず外す。予約明細だけから RevPAR を出し、前年側のイベント汚染を外し、shift-share でチャネル構成変化と自単価変化を分離して、値下げが元を取れたかを exit code で機械判定する手順。
定期実行の基盤移管で設定だけ置き去りになる不具合を症状から見つけて直す
cronをActionsから別基盤へ移した後、envが移らず通知停止・出力劣化が無音で起きる。診断手順・コード既定値化・secretの一時ワークフロー移送・検証まで
会食・接待の店をMaps URL付きで提案する秘書
場所・人数・予算・ジャンル・参加者特性をヒアリングし、過去履歴シートと Web 検索から会食/接待の店を3-5件提案する秘書スキル。店名特定済みの Google Maps URL 生成・裏取り・履歴追記・次回NG回避・アレルギー配慮まで規定。
ペース連動の値付けで『達成不能な目標稼働』が遠い日付を恒久的に最大値下げにする罠と、リードタイム閾値で値下げだけ止める実装
目標稼働×在庫が1室未満になる帯では不足率が常に100%になり最大値下げが固定される。閾値以上は係数の下限を1.00にし値上げ側は触らない。旧オラクル+ガード付きオラクルのテスト型と、デプロイ前に『前』の実値を残す手順
夜間の無人AIエージェントバッチが「静かに全滅」するのを止める(観測タスクの立て方)
夜間バッチでAIエージェントを無人実行すると、失敗そのものが誰にも届かない。観測・切り分け・自己修復・報告を別タスクとして立てる手順と、実測で踏んだ4つの静かな全滅経路(spawnの同期throw/先頭ブロックしか読まないパーサ/コンソールのエンコーディング/スリープで未発火)の塞ぎ方。
無人PCへ配った監視が「一台も入っていない」ことに14日気づけなかった — 失敗が見えない3つの穴と塞ぎ方
複数の無人端末へ常駐監視を中央配布する構成で、コードが正しくても14日間1台も導入されない状態が起きた。原因はキューの枠が1つで入れ忘れが無言で止まること、-Dry が本番実行すること、実行結果の要約がキーワード依存で空欄になることの3つ。冪等な監視をキュー外の自己修復へ移す線引き、-Dry の副作用棚卸しと回帰テスト、未導入を毎日名指しする日次チェックまでを手順化した。
無人ジョブの「安いAIへの委譲」がWindowsで毎晩空振りする事故を潰す(spawnが.batを起動できない)
夜間の無人ジョブで「実装は安いモデル、失敗時だけ高いモデル」の二段構えを入れても、Windowsでは PATH上のCLIが.batラッパのため spawn が ENOENT で即死し、安い側が一度も起動しない。0.0x秒/出力0という失敗の署名で犯人を確定させ、実行ファイルの絶対パスを解決する純関数(shell:trueを使わない・.batを候補にしない・版はディレクトリ名で比較)を入れる型。あわせて「起動できない機体」と「起動したのに空」を台帳で分けて直せない宿題の自動起票を止め、force上書きで配られる共有ツールへの修正を冪等な再適用+依存ジョブ前の予約実行で守る。
Discord の「グループDM」へ Bot から自動投稿はできない — 配信先の設計をやり直す手順
グループDMのIDを渡されて403で止まる件を一次情報で『仕様上不可能』と確定させ、専用プライベートチャンネルか個別DMへ配信先を作り直すまでの手順。ユーザートークン経路を使わない理由も含む。
社内フィードバックが「記録は残るが誰も気づかない」で死ぬのを塞ぐ
不具合・要望フォームの通知を多段フォールバック化し、未対応を毎日プッシュする型。DMがwebhookで送れない理由と、トークンをクラウドへ複製しない置き場所、未対応の定義ミス(メモ空だけに絞ると取りこぼす)まで含む。
自分がログインできない管理画面を、現場の人のスクショだけで診断する
SaaS/OTA の管理画面に自分で入れない時、非エンジニアにスクショを撮ってもらうだけで原因を特定する手順。依頼文の型(探す内容で書く・否定の結論を持ち込む・読み戻しは失敗側に置く・打ち切りを入れる)と、集めた数字の読み方(期間合計で判定しない・ファネルは段ごとに時系列で並べ先に落ちた段を探す)。
チャネルマネージャ価格自動化:送信成功を信じず全部屋の実売値を読み戻す
宿泊施設の価格自動更新で「送信成功ログが緑なのに一部の部屋の売値が何ヶ月も変わっていない」事故を防ぐ検証の作り方。連動価格・実効価格パラメータ・列対応の3つの罠つき。
文字化けで宛先が決まらない1件がキューを永久に詰まらせるのを直す
自動処理キューで宛先解決に失敗したアイテムは「失敗」ではなく「スキップ」になり、exit 0 のまま毎晩リトライされ続ける。詰まりの検出、化けた文字列から元テキストを同定する指紋照合、壊れにくい第2キーへの許可リスト型フォールバック、そして「対象外にする」出口までを実例で通す。
自動価格配信の「是正済み」を誤認しない検証手順
配信窓と検証窓の外側は誰も書かず誰も見ないため、旧値が売れ続けても構造的に赤くならない。窓幅の算出・窓外の読み戻し・複合商品の正解の作り方・既定値の根治までを手順化した。
OTA連携で「1室だけ予約が来ない」を3層に分けて切り分ける手順
サイトコントローラー経由の予約ゼロを、①自分側のマッピング ②OTA側の掲載状態 ③実際に送っている在庫・価格 の3層に分けて実値で確定させる読み取り専用の手順。マッピング欠落と決めつける誤診、集計窓による錯覚、先頭数行での早合点、取れなかった実表示の扱い、金額を添えた優先度づけまで。
複数PCへ配る設定ファイルを端末固有値を壊さず中央更新する
中央でキーやwebhookを張り替えた瞬間に全端末が静かに死ぬ事故を、キー単位マージ配布・保護キー・ローテーション順序・沈黙検出で構造的に防ぐ手順
無人ジョブの沈黙する失敗と効果検証の自動判定
定時ジョブが1行もログを残さずスキップされる事故の検知と、恒久対策の効果検証をジョブ自身に判定させる型。Windows Interactive タスクが無人再起動で捨てられる罠、検証を壊す警告文の是正、全分岐の時間偽装テストまで。
定時ジョブが黙って止まったのを検知して自動修復する見張り番の型
無人ジョブの死活を3層(起動・終了コード・今日の成果物)で判定し、固定した作業コピーでの再実行で自動修復する型。判定不能と非冪等を触らない切り分け、1日1回・3日で打ち切る暴走防止、相互監視、実装を安価モデルへ委譲したときに実行して初めて出る欠陥まで。
AIエージェントが作った Windows 自動化が「静かに死んでいる」のを見抜いて直す
Botやコーディング AI に作らせたタスクスケジューラの常駐処理が、初回だけ成功して以後毎回失敗する壊れ方の判定・原因特定・恒久対策。最頻出原因は BOM なし UTF-8 による構文エラーで、PowerShell 5.1 経由でだけ再現する。実行せず構文検証する方法と、受け入れ条件の付け方まで。
監視の想定値を復元せず日次スナップショットの実値で照合する(偽警報の根絶)
動的に動く値(価格・在庫・配信設定)の監視で、想定値に今日の値や計算復元を使うと出る偽警報を根絶する。追記型JSONLの日次スナップショット+発生時刻以前の最新を選ぶ純関数+実値が無ければ判定不能(exit 2)で止まる設計と検証チェックリスト。
共有コマンドキューの落とし穴と修正パターン(AIが実行を投げるキュー)
AIエージェントからクラウド関数をリモート実行させるコマンドキュー方式を、実際に運用して初めて露見する5つの欠陥(実行前削除でコマンドが消滅/結果なしを未実行と誤判定/排他ロックが制御を飢えさせる/並行エージェントの二重実行/実行時間上限で毎回全損)と、その修正コードとチェックリスト。
PMS のセット販売用「仮想部屋」の予約が『閉室・原因不明』に見える罠と直し方(Beds24 の room dependencies)
セット部屋(仮想部屋)の予約で構成室が numAvail=0 になり集計が『閉室・原因不明』と誤計上する仕組みと、3 回の GET での診断、予約を構成室へ展開する共通純関数モジュールで全ツールを直す手順
シート対応済みチェック+期限超過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一致(フッター重なり)の罠も収録。