巻物を探す
29件の巻物
無人でGoogle Meetに定時自動参加し音声付き配信
Playwright + Chrome 起動フラグ --auto-select-tab-capture-source-by-title で共有ピッカーを出さずタブ(音声込み)を自動選択し、定時に Google Meet へ無人参加して動画配信する仕組み。コンパニオンモード自動フォールバック・OOM対策(preload=metadata)・在室ウォッチドッグ・タスク登録の文字化け回避まで実運用ノウハウ込み。
Google Meet 自動参加&動画配信Bot 開発指示書
指定した時刻に Google Meet へ自動参加し、動画を再生しながら画面共有する Bot を、Claude Code に一発で作らせる開発指示 MD。朝会の定例動画配信・ウェビナーの自動放送に。
自動価格配信の「是正済み」を誤認しない検証手順
配信窓と検証窓の外側は誰も書かず誰も見ないため、旧値が売れ続けても構造的に赤くならない。窓幅の算出・窓外の読み戻し・複合商品の正解の作り方・既定値の根治までを手順化した。
サーバレスに認証付きの配信APIを作るときの2つの落とし穴（静的配信で認証が無意味／200なのに0件）
リポ直下に置いたペイロードが認証なしで配信され認証が無意味になる罠と、自作probeのPOSTと実クライアントのGETがズレて200なのに配置0件になる罠。api/_前置の実測表、素のURLを404で確認する検証ループ、実クライアントをimportして受け取り件数で判定する完了条件まで。
複数データ源→CIで日次AIサマリー生成→自作PWAへ配信する仕組み
毎朝データ源を横断してLLMに要約・優先順位付けさせ、結果を自作PWAダッシュボードに自動表示。重い取得とLLM呼び出しはシークレットを持つCI側、PWAは結果JSONをingest受信するだけ。CI空変数・本番ビルドstale・dry-run検証の罠つき。
社内名簿シートから選択式スタッフ入力を作る — メールをブラウザに出さない Next.js 設計
認証なしの公開業務アプリで、手入力の氏名を名簿由来のプルダウンに置き換えつつ、個人情報をクライアントへ配らない設計と検証手順。Server Component で {id,name} だけを渡し、サーバが id から氏名とメールを解決する。配信物へのメール混入を grep で実測する検証と、実際に踏んだ落とし穴7件つき。
GAS Web App の「直したのに反映されない」を構造的に潰す
clasp push だけでは /exec に反映されず、--deploymentId 更新は成功表示のまま古いコードを配信し続ける。push→新規デプロイ→認証URL差し替え→疎通確認を1本化する型（PowerShell 5.1 の落とし穴込み）
投稿の審査キューを「信頼済みだけ自動公開」で捌く設計（なりすまし穴つき）
審査キューに投稿が溜まったまま埋もれる問題を、信頼済み投稿だけ即公開する形で潰す指示書。無検証のキー発行を信頼判定に使うと第三者が自社メールを騙れる穴と、サーバレスで静的公開棚に実行時公開を足す方法、検証10項目まで含む。
無人バッチの「黙った空振り」を発見して止める（冪等取込の設計）
定期バッチがエラーを出さないまま毎回同じ仕事をやり直している状態の検出法・典型的な真因（取込済み集合を実体の単一カラムで持つ）・台帳による修正・打ち切り付き再試行・CI課金での効果実測まで。
自動同期システムの「窓」と「警報」を監査する
外部APIへ値を定期送信するシステムで、送信窓と検証窓のズレが作る『構造的に絶対に赤くならない領域』を潰す手順。窓の実測、窓外の期待値の導き方、既定値の再生成、管理方式変更に伴う警報の誤発報まで。
配布したツールが各PCで本当に最新版か検知する（版ドリフト検知）
全PCへGit経由で配るCLI/hookが「マージ済みなのに端末だけ旧版」で静かに止まるのを検知する。ツリーAPIのblob SHA照合、Windows CRLFで全滅しないindex SHA比較、ローカル編集と配布失敗の切り分け、await追加でprocess.exitが落ちる罠まで。
アプリ内「不具合・要望」窓口を全アプリへ標準搭載する
利用者がその場で不具合・要望を送れる窓口を、npm依存ゼロ・CSS非依存・DBなしでも動く形で1コマンド後付けする手順。公開サイト向けの濫用対策、2段検証、配布物として崩してはいけない点まで含む。
無人実行ジョブが「働いたのに何も残らない」を潰す設計
cron/タスクスケジューラからAIエージェントや長時間処理を無人で走らせる際の2大事故（タイムアウトkillで出力が丸ごと消える／実行されるコードがその瞬間のHEADで決まる）を構造的に潰す実装指示書。逐次進捗ファイル・待機時間の上限・作成時刻からの実行ID復元・固定worktreeへのpin・完走分だけの後片付けまで、テスト観点と完了条件付き。
ChatGPTに本当にLPデザインを作らせて、コードへ忠実に落とす指示書
「ChatGPTでデザインして」がAIエージェントで失敗する4つの真因と回避策。Responses APIでスクショ入力＋反復してモックアップを作り、複数画像は1枚のコンタクトシートから切り出してトンマナを統一、生成画像は表示枠の縦横比に合わせてcrop率を数値assert、モックアップ内の架空の数値は捨てる。Playwrightの検証コード付き。
並行AIセッションが共有リポジトリで事故らない型
複数のAIエージェントが同じ作業ツリーを共有する時の事故防止と、配布物を「配布可」と言う前の3層検証（コード・登録・配布）を手順化したMD
GASウェブアプリの画面をjsdomで検証する — 単体テストでは原理的に見つからない画面バグを捕まえる
GASの画面JSはブラウザ無しでは検証できず、単体テスト全pass・API正常・データ正常のまま主要導線が死ぬ。Index/Style/Scriptを連結してjsdomで実行し、実データを流して要素の有無とボタンの活性まで自動判定するハーネスの作り方。
デプロイ済みの本番が git より新しいプロジェクトを、壊さずに触る
git 連携が無く CLI から直接デプロイされている本番は、clone して deploy すると本番にだけある機能が消える。触る前に本番ソースを API で回収して git と突き合わせる判定と手順、秘密ファイルの混入対応、既存認証コードに触らない判断基準まで。
ずっと skipped だった CI ジョブを掘り起こして緑にする
CI が長期間赤いと needs: の後段ジョブは skipped のまま欠陥が隠れる。過去実行の確認方法、パッケージマネージャの二重指定・静的プリレンダーの DB 接続・Playwright の webServer 未起動という典型4段を、CI ローカル再現で往復を減らしながら順に潰す手順書。
複数LLMプロバイダのフォールバック連鎖に新しい実行者を安全に追加する
安いLLMから順に試すフォールバック連鎖へ、新プロバイダを実測(成功率/単価/到達性)にもとづく正しい位置に差し込み、並行編集で静かに消えないよう配列全体をpinする回帰テストと4段階の実走検証まで通す手順。
複数PCのAIエージェントにルール変更を確実に届ける — 届いたつもりを潰す4つの実測
共有リポジトリ経由でAIのルールを配る構成で、pullだけ自動/pushが手動・間引きが黙って効く・CDNが古い版を返す・dry-runが保護ブランチを教えない、の4つの罠と潰し方。検証は配布経路そのもので行う。
無人ジョブの沈黙する失敗と効果検証の自動判定
定時ジョブが1行もログを残さずスキップされる事故の検知と、恒久対策の効果検証をジョブ自身に判定させる型。Windows Interactive タスクが無人再起動で捨てられる罠、検証を壊す警告文の是正、全分岐の時間偽装テストまで。
GASの時間主導トリガーがデプロイ版に固定される罠 — 「成功したのに何も起きない」の切り分け
clasp push しても時間主導トリガーは旧バージョンのコードを実行し続ける。エラーも出ず戻り値もOKなため原因が特定できない。新関数プローブで実行中のコードを確定させ、clasp deploy -i でURLを変えずに直す手順。
外部連携の値を内部フィールドで検証して誤診しない手順
チャネル連携・在庫/価格同期で「送った値が外にどう出ているか」を内部APIのフィールドで確認すると誤診する。派生値/参考値の混同、チャネル単位の係数、レスポンスの無言切り捨てという3つの罠と、消費者向けエンドポイント→全件突合→ブラウザ実描画という潰し方。
定期実行が「手動なら動く」まま何週間も止まっているのを見抜いて直す
GitHub Actions の schedule だけが 403 で全滅しても手動実行は成功し続けるため気付けない。--event=schedule での生存判定、actions:read の付与、直した後に露出する次の層の潰し方、死活監視の仕組み化までを手順化する。
PWA デプロイ即反映 — Service Worker 自動 reload レシピ
PWA のスマホ側で新版が反映されない問題を、SW の VERSION+postMessage+updateViaCache=none+版タグ表示 の3点セットで「デプロイ即・全tab自動 reload」に変える完全レシピ。Next.js/Vite/Vanilla 共通
AEO/GEO 施策の型 — AI検索で自社を推薦・引用されやすくする
ChatGPT/Perplexity/AI Overviewで自社が引用される状態を作る実行手順。JSON-LD/llms.txt/robotsのオンページ、比較メディア掲載、投稿メディア→Yahoo!ニュース→取材誘発、Wikidata/Wikipedia、月次無料の効果測定、落とし穴まで。
「0件だった」を無罪の証拠にしない — ログ調査の計測器を対照群で検定する
監査ログや操作ログで「該当0件」が出たとき、それを「起きていなかった」と報告してしまう事故の防ぎ方。対照群を調査窓ではなくログの全期間で数える、日時は列を決めて読む、判定不能を終了コード2に分ける、の3点を手順と指示文つきで示す。
GAS Webアプリ 原因不明の失敗 切り分けチェックリスト
手動実行は成功するのにWebアプリ経由だけ失敗するGASの謎エラーを、サーバー最適化より先に別端末テスト→キャッシュ確認の順で切り分ける手順
GAS Webアプリの同時アクセスクォータエラー対策
複数人利用のGoogle Apps ScriptアプリでSpreadsheetApp.openByIdが同時呼び出しエラーになる問題を、リトライ+バックオフ+ジッターのラッパー関数で解消する手順