巻物を探す
28件の巻物
GitHub Actions の課金分を実測ベースで削る
Actions の請求を推測でなく実測から削る手順。ジョブ単位の分切り上げという課金構造、ステップ別に時間を割る API の叩き方、短時間高頻度は統合・長時間は per-row 往復の一括化という打ち分け、並列度を上げても効かないケースの見分け方、そして『遅いステップが実は同じデータを毎回処理し直している欠陥』の見つけ方まで。本番の夜間ジョブを実測目的で再実行して重複レコードを大量生成した失敗例と、その巻き戻しの作法も含む。
鍵の無いPCから共有メールボックスでDriveのPDF添付つき返信を下書き→確認後に送信（GitHub Actions＋ドメイン全体の委任）
SA鍵がGitHubシークレットにしかない環境で、DriveのPDFを添付した返信下書きを作り、人の確認後にdrafts.sendで送る手順。scope不足403と多重run事故の回避つき
GitHub Actions のジョブ実行時間を実測ベースで削る手順書
cron ジョブの Actions 課金を実測から削る手順。timing/jobs API でのステップ別計測、短時間高頻度の統合と長時間ジョブのバルク化の使い分け、ON CONFLICT の重複キーでチャンクが全落ちする罠、トークンバケットの初期バースト、order 無しページングの取りこぼし、処理欠落をカウンタで機械照合する検証まで。
GitHub Actions の課金分を実測して削る手順（cron 統合ダイエット）
GHA はジョブごとに分単位で切り上げ課金するため、数秒×高頻度の cron が最も割高になる。/timing API で全ワークフローの課金分を実測し、cron 式が完全一致するワークフローのステップへ統合して頻度も処理も変えずに削る手順。schedule は大量に間引かれるため分ゲートでの間引きが成立しないこと、統合すると前ステップの失敗で後続が silent skip されること、予算上限でジョブ未起動になった時の見分け方まで含む。
ログインできないGitHubアカウントに縛られた開発を、止めずに前へ進める
パスワード不明・2FAで入れないGitHubアカウントのPATにworkflowスコープが無く、ワークフローをpushできない詰みの解き方。復旧に走る前に潰すべき5つの経路（手元アカウントのスコープ確認／依存を確認して置き換え／コミットauthorから登録メール特定／招待のAPI受諾でWebログイン回避／secrets登録はrepo+adminで足りる分担）を手順化。
定期スクレイピング→Googleスプレッドシート自動集計MD
競合価格・在庫・ランキングなどを毎日自動取得してスプレッドシートに蓄積するバッチを AI に作らせる指示書。robots.txt 尊重・レート制限・差分検知のベストプラクティス込み。
Vercel の Sensitive 環境変数が誰にも読み戻せない状態を作り直さずに解消し、Development 正本＋毎日の差分監視で恒久化する
本番 env が全て Sensitive で共有不能なとき、skip-domain の一時本番デプロイ＋RSA 暗号化で1回だけ取り出し、Development を正本化、env:set 入口と GitHub Actions の parity 監視で再発を止める手順
X(旧Twitter)自動投稿を従量課金時代に立ち上げる手順書
無料枠廃止後のX APIでGitHub Actions定期投稿を構築する。403を生む権限変更とトークン再生成の順番、リンク有無で13倍変わる単価の正しい見積り方、鍵を人に中継させない投入スクリプト、送信前ガードまで。
「マージしたのに直らない」— デプロイ元と定期実行のブランチが違う罠の検出と対処
GitHub Actions の schedule は常にデフォルトブランチで走る。本番デプロイ元が別ブランチだと、同じスクリプトの版が2つ存在し「マージしてデプロイしたのに毎晩のバッチだけ古いまま」になる。検出コマンド、base の選び方、そして『デプロイ完了は証拠にならない』ことの確かめ方まで。
ダッシュボードが「artifact が見つからない」で真っ赤になるのを塞ぐ
GitHub Actions の成果物を画面に出す構成が no valid artifacts found で落ちる真因（preflight skip した run も success だが artifact 無し）と、artifact 実在確認＋直近成功へのフォールバックで画面を殺さない直し方。常駐プロセスの世代確認と実ブラウザ描画までの検証手順つき。
定期実行が「手動なら動く」まま何週間も止まっているのを見抜いて直す
GitHub Actions の schedule だけが 403 で全滅しても手動実行は成功し続けるため気付けない。--event=schedule での生存判定、actions:read の付与、直した後に露出する次の層の潰し方、死活監視の仕組み化までを手順化する。
定期実行の基盤移管で設定だけ置き去りになる不具合を症状から見つけて直す
cronをActionsから別基盤へ移した後、envが移らず通知停止・出力劣化が無音で起きる。診断手順・コード既定値化・secretの一時ワークフロー移送・検証まで
CI が全部 green なのに auto-merge されない PR を原因から特定して自動マージに乗せる
GitHub の auto-merge が効かない原因は権限ではなく fork であることが多い。切り分けコマンド、ワークフローの5条件の読み方、正しい提出経路、ラベル忘れが成功に見える落とし穴、GraphQL と REST の2系統を実測付きで示す
X(Twitter) 予約投稿Bot 開発指示書
スプレッドシートに書いた投稿文を指定時刻に X へ自動ポストする Bot を AI に作らせる MD。API v2 の無料枠制限・画像添付・スレッド投稿の対応込み。
Discord 日報Bot — 売上・KPI を毎朝自動通知
Supabase / スプレッドシートから前日実績を集計して、毎朝 Discord に埋め込み形式で通知する Bot を AI に作らせる指示書。二重通知防止・メンション設計・見落とし対策込み。
無人バッチの「黙った空振り」を発見して止める（冪等取込の設計）
定期バッチがエラーを出さないまま毎回同じ仕事をやり直している状態の検出法・典型的な真因（取込済み集合を実体の単一カラムで持つ）・台帳による修正・打ち切り付き再試行・CI課金での効果実測まで。
複数データ源→CIで日次AIサマリー生成→自作PWAへ配信する仕組み
毎朝データ源を横断してLLMに要約・優先順位付けさせ、結果を自作PWAダッシュボードに自動表示。重い取得とLLM呼び出しはシークレットを持つCI側、PWAは結果JSONをingest受信するだけ。CI空変数・本番ビルドstale・dry-run検証の罠つき。
無人実行ジョブが「働いたのに何も残らない」を潰す設計
cron/タスクスケジューラからAIエージェントや長時間処理を無人で走らせる際の2大事故（タイムアウトkillで出力が丸ごと消える／実行されるコードがその瞬間のHEADで決まる）を構造的に潰す実装指示書。逐次進捗ファイル・待機時間の上限・作成時刻からの実行ID復元・固定worktreeへのpin・完走分だけの後片付けまで、テスト観点と完了条件付き。
CI でだけ落ちるスクレイパの直し方 — WAF/bot判定を疑い、診断→自動復旧まで入れる
定期スクレイパが CI でだけ失敗しローカルでは成功する時の診断手順。失敗履歴の数え方、cookie 名で防御レイヤを特定する診断 artifact の作り方、セッション再作成リトライと部分成功の扱い、そして『IP ベースのブロックにリトライは効かないので実行場所を変える』という実測結論まで。
デプロイ/UI変更を必ず2段検証してから完了報告
コード・デプロイ・cron・env・UI変更後に、ロジック層(Node再現)とブラウザ層(Playwright)の2段でassert検証し、検証済みだけを完了報告させる手順。「画面で確認して」の丸投げを禁止。
新しいAIモデルを自動で見つけて採用提案まで届ける（model-scout→eval→提案セッション）
OpenRouter公開カタログの差分で新モデル・値下げを検知し、当日evalで品質を測り、合格した候補を『次に開くセッションの先頭に出る実装提案』として届ける仕組みの設計と落とし穴（reset --hardで消える保存先・衝突PRでCIが出ない・Windowsのfile URL）
アプリ内フィードバック→責任者DM→Issue→自動修正PR→1タップ承認
社内アプリの不具合報告を、責任者の個別DMに届け、Issueにして夜間に修正PRまで自動で作り、承認は既存のPR画面のMergeボタン1タップで済ませる設計。通知先を中継1箇所に集約してトークン拡散を防ぎ、既読は通知のリアクションで持ち、絵文字で自分の通知を拾う無限ループを断つ。
チャット通知を無視されても漏らさない: 依頼日記録→営業日経過で再通知→上長エスカレーション
業務アプリの送りっぱなし通知に、依頼日記録・営業日判定の純関数・担当再通知・上長エスカレーション・日次未着手欄を足す手順とテスト観点
配布する PowerShell インストーラを CI で検査する（PS5.1・BOM の罠）
社内に1行コマンドで配る .ps1 が、JSのテスト緑のまま構文エラーで全PCへ届く穴を塞ぐ。パース+BOM検査スクリプトと、windows-latest の既定 pwsh では検出できない理由、故障注入での受け入れ確認まで。
ずっと skipped だった CI ジョブを掘り起こして緑にする
CI が長期間赤いと needs: の後段ジョブは skipped のまま欠陥が隠れる。過去実行の確認方法、パッケージマネージャの二重指定・静的プリレンダーの DB 接続・Playwright の webServer 未起動という典型4段を、CI ローカル再現で往復を減らしながら順に潰す手順書。
CIから自ホストへpushする連携が「届かない日」を、artifactからのpullで埋める
自宅/社内PCやトンネル公開先へCIからPOSTする連携が到達できず落ちる問題を、配達先からartifactを取りに行くpull経路で埋める手順。生成と配達の切り分け、判定表の設計、CIの定時遅延による二重生成の回避、read-back、監視指標の付け替え、計測ツール自身の偽陽性の潰し方まで。
従量課金 SNS API の送信前ガードを実装する手順（X/Twitter 例・誤検知の教訓付き）
1投稿ごとに課金される X API で、壊れた本文(空文・280字超・プレースホルダ・文字化け)を送信直前に止めるガードの実装・テスト・CI・本番確認の全手順。裸の TODO が本文の普通語を誤検知した実測と回避策、委譲時に防護解除を禁止する1行を含む
スプレッドシート集計業務をNext.js+Supabaseアプリへ段階移行する設計指示書
運用中のSheets業務を止めずにWebアプリ(DB正)へ段階移行。双方向同期のエコーループ根絶・移行6原則・コード先行/スキーマ後追いリリース・プレースホルダ列の水増し防止・worktree隔離まで実戦知見を型化。