choose-loop-wakeup-interval
について
このスキルは、開発者がキャッシュの状態に基づいてスケジュールされたループのウェイクアップに最適な `delaySeconds` 値を選択できるように支援し、300秒遅延のようなアンチパターンを回避します。3段階の決定ロジック(キャッシュウォーム、キャッシュミス、アイドル)を提供し、実行時のクランプ処理と分単位の境界丸めを行います。自律ループの設計、ポーリング間隔の調整、または間隔に関連するコストの診断を行う際にご利用ください。
クイックインストール
Claude Code
推奨npx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/choose-loop-wakeup-intervalこのコマンドをClaude Codeにコピー&ペーストしてスキルをインストールします
ドキュメント
擇循環醒寐之時
擇 delaySeconds 之值於 ScheduleWakeup,合乎緩存五分之壽、調度整分之粒、[60, 3600] 之限。其擇非淺:常人之念「約五分」,正陷兩失之地——既失緩存,又不攤長待。
其理本隨 ScheduleWakeup 之具述而至呼時,然其時循環已定。此技將其理提於謀時,正其所宜也。
用時
- 設自主
/loop或ScheduleWakeup驅續,擇每刻之遲 - 為長行之使者謀心跳之律,將察、將觀、將迭
- 調輪詢之律以應本或緩存之壓
- 事後察循環之本,而覺時距失宜
- 書引、書行冊、書有
delaySeconds之例
入
- 必:循環所待者何(某事、某態之變、閒刻、週察)
- 必:此刻讀者需新脈絡乎(緩存溫)抑或可忍冷讀(緩存失可受)
- 可選:所待事之最早可發之下界(如「建至少四分」)
- 可選:循環總本之上限(刻數 × 每刻之本)
法
第一步:分待之類
定此待屬何階:
- 主察(緩存溫):五分內有變可期——建將成、態將遷、程方啟
- 緩存失之待:五分內無值察之事;脈絡緩存將冷而可受
- 閒:無特定之兆可察;循環來察,蓋或有所得,非必有所得
得: 分明之類:主察、緩存失、或閒。
敗則: 若待不可分——若無誠答於「吾何所待」——此循環或本不宜存。跳至第五步,慎思不設醒寐。
第二步:施三階之擇
依所分擇 delaySeconds:
| 階 | 範 | 緩存之行 | 用於 |
|---|---|---|---|
| 緩存溫 | 60 – 270 秒 | 緩存溫存(未及五分之壽) | 主察——下刻需速且廉之再入 |
| 緩存失 | 1200 – 3600 秒 | 緩存冷;一失換久待 | 真閒、或所待事不可早發 |
| 閒之常 | 1200 – 1800 秒(二十至三十分) | 緩存冷 | 無特兆;週察而用者可中斷 |
勿擇 300 秒。 此兩失之距:緩存已失,而待太短不足攤其失。若念「約五分」,降至 270 秒(保溫)或定 1200 秒以上(攤其失)。
得: 自三階中擇定一 delaySeconds,非習擇之整分之數。
敗則: 若擇屢落 300 秒,根本之問常為「此循環當以此律存乎」——重察第一步。
第三步:量於分界
調度者發於整分之界。delaySeconds 為 N 者,實遲為 N 至 N + 60 秒,視呼時於分中何秒而定。
例:
於
HH:MM:40呼ScheduleWakeup({delaySeconds: 90}),則目標為HH:(MM+2):00——即實待 140 秒,非 90 秒。
故:秒下之意無義。所傳之值視為下限,非精確之期。若一分之差緊要,則循環之律過密,不宜用此機。
得: 已受實待可長於 delaySeconds 達 60 秒。於緩存溫之刻此要緊——270 秒實可成約 330 秒,入緩存失之境。
敗則: 若近上限之值(如求溫之 265 秒)常見,則降之——用 240 秒替 270 秒,以保溫之諾於最壞之分界偏移下。
第四步:敬其限
行時以 delaySeconds 限於 [60, 3600]——逾者默調。遙測分所求(chosen_delay_seconds)與實定(clamped_delay_seconds),不合則設 was_clamped: true。
謀以限後之值,非所求之值:
- 求低於 60 → 實待 60 秒加分界偏移(實可達 120 秒)
- 求高於 3600 → 實待 3600 秒(一時)
- 無運行延其上;數時之待需多刻
得: 所擇之值落於 [60, 3600] 內,或有意受限後之行。
敗則: 若真需數時(如「四時後喚吾」),鏈醒寐——設 3600 秒之刻而自再定——或以 cron 為循環(CronCreate 附 kind: "loop")代之。
第五步:書具體之 reason
reason 者,遙測、用者可見之狀、緩存溫之理合一也。截於 200 字。宜具體。
- 善:
checking long bun build、polling for EC2 instance running-state、idle heartbeat — watching the feed - 惡:
waiting、loop、next tick、continuing
此欄之讀者乃用者,欲解循環所為而不必預知其律。為其書也。
得: 一具體之語,使用者一瞥狀態而解之。
敗則: 若無具體之由可述,重思循環是否當存(第一步與第六步)。
第六步:識勿循環之境
非每「後來」之念皆宜設醒寐。不可設刻於:
- 用者主察——其入為正觸,非計時
- 無收斂之準——循環無「畢」之義
- 任務互動(於刻間問用者)
- 所需之律短於限之底(60 秒)——此密之輪詢屬事驅之機,非循環
得: 明擇設醒寐或不循環。「因可」非循環之由。
敗則: 若所設醒寐屢為用者於發前中斷,則式誤,非時誤也。
驗
- 待已分為主察、緩存失、或閒(三擇其一)
- 所擇
delaySeconds落於三階之一(60–270、1200–3600、或閒之 1200–1800) - 非 300(兩失之距)
- 於
[60, 3600]內,或明受限後之行 - 分界偏移已計(所值視為下限)
-
reason具體且不及 200 字 - 勿循環之察已行——醒寐確當
陷
- 整分之常(300 秒):最常之誤。「約五分」似然而正誤。降至 270 秒或定 1200 秒以上。
- 忽分界之偏:於分末求 60 秒可生約 120 秒之實遲。於緩存溫之刻,此可推越五分之壽。
- 追秒下之精:調度者粒為分。求 85 秒、90 秒、95 秒皆噪——擇一而行。
reason欄晦:"waiting"於用者無益而減遙測之用。書其由如用者將讀於狀態線。- 用此技以證冗循環:若「吾何所察」誠答含糊,無時距可救——循環本不宜存。
- 於提示中手限:勿於推理中限(「吾將限於 3600 以安」)。行時自限,任其自為。
- 忘七日之老:動循環默七日後收(用者可調至三十日)。長行之循環宜設其盡遠於上限,非與之競。
例
例一——緩存溫之主察
bun build 方啟;使者欲速察使緩存尚溫於果至時。
- 分(第一步):主察
- 階(第二步):緩存溫,擇 240 秒
- 分界(第三步):最壞實待約 300 秒——仍於五分之壽內含 60 秒餘
- 由(第五步):
checking long bun build
例二——閒之心跳
自主使者一時察低量之饋一次,尋值行之事。
- 分(第一步):閒
- 階(第二步):閒之常,擇 1800 秒(三十分)
- 分界(第三步):無關——此律下 60 秒之偏微不足道
- 由(第五步):
idle heartbeat — watching the feed
例三——反式
使者欲「待五分」於遠端 API 再試之時。所求 300 秒。
- 問:緩存於五分冷,故 300 秒已失——而 300 秒太短不足攤其失
- 補:或降至 270 秒(保溫)或定 1500 秒(攤其失)。勿擇 300。
參
manage-token-budget— 長存使者循環之本限;緩存之量其一桿也du-dum— 察行分離之式;此技量察鍾之距於循環無 cron 時read-continue-here— 跨會話之交接;此技涵會話內之醒寐write-continue-here—read-continue-here之補
GitHub リポジトリ
関連スキル
executing-plans
デザインexecuting-plansスキルは、完全な実装計画があり、それを管理されたバッチでレビューチェックポイントを設けながら実行する場合に使用します。このスキルは計画を読み込んで批判的にレビューした後、小さなバッチ(デフォルトは3タスク)でタスクを実行し、各バッチの間に進捗状況を報告してアーキテクトのレビューを受けます。これにより、品質管理チェックポイントが組み込まれた体系的な実装が保証されます。
requesting-code-review
デザインこのスキルは、コードレビュアーサブエージェントを起動し、処理を進める前に要件に対してコード変更を分析します。タスク完了後、主要な機能の実装後、またはmainブランチへのマージ前などに使用すべきです。このレビューは、現在の実装と元の計画を比較することで、問題を早期に発見するのに役立ちます。
connect-mcp-server
デザインこのスキルは、開発者がHTTP、stdio、またはSSEトランスポートを使用してMCPサーバーをClaude Codeに接続するための包括的なガイドを提供します。GitHub、Notion、カスタムAPIなどの外部サービスを統合するためのインストール、設定、認証、セキュリティについて解説しています。MCP統合のセットアップ、外部ツールの設定、またはClaudeのModel Context Protocolを扱う際にご利用ください。
web-cli-teleport
デザインこのスキルは、タスク分析に基づいて開発者がClaude Code WebとCLIインターフェースの選択を支援し、これらの環境間でのシームレスなセッションテレポーテーションを可能にします。Web、CLI、モバイル環境を切り替える際のセッション状態とコンテキストを管理することで、ワークフローを最適化します。様々な段階で異なるツールを必要とする複雑なプロジェクトにご活用ください。
