スキル一覧に戻る

choose-loop-wakeup-interval

pjt222
更新日 6 days ago
14 閲覧
17
2
17
GitHubで表示
デザインdesign

について

このスキルは、キャッシュを考慮したロジック、実行時のクランプ処理、アンチパターンの回避を適用して、ループのウェイクアップをスケジューリングする最適な `delaySeconds` 値を計算します。自律ループの設計、ハートビート間隔の計画、またはポーリング間隔の調整時に使用されます。出力には、選択された間隔を説明するテレメトリ対応の `reason` フィールドが含まれます。

クイックインストール

Claude Code

推奨
メイン
npx skills add pjt222/agent-almanac -a claude-code
プラグインコマンド代替
/plugin add https://github.com/pjt222/agent-almanac
Git クローン代替
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/choose-loop-wakeup-interval

このコマンドをClaude Codeにコピー&ペーストしてスキルをインストールします

ドキュメント

擇循喚時

delaySeconds:守 5 分緩存 TTL、整分粒度、[60, 3600] 夾。避「5 分」兩敗之位。

  • /loopScheduleWakeup 之每勾延→用
  • 長駐代理之心拍→用
  • 輪詢頻率之調→用
  • 事後察費過高→用
  • 書指南、劇本→用

  • :循之所待(事、遷、勾、察)
  • :讀時須熱緩存乎?或冷可受乎?
  • :事件可生之下界
  • :總費之上界

一:分類

  • 熱察:5 分內將變(構近畢、狀遷輪詢)
  • 冷待:5 分內無足察;緩存冷可受
  • :無專號;因或遇而察

得:分類明(熱/冷/閒)。

敗:無「待何」之誠答→循或不當存→赴步五。

二:三層擇

範圍緩存用時
60–270 s溫留(<5 分 TTL)熱察
1200–3600 s冷;一失長待真閒或事件不及
1200–1800 s(20–30 分)無專號;可打斷

勿擇 300 s:兩敗之位——緩存失、待太短不攤。欲「5 分」者→降 270 s(熱)或赴 1200+(攤失)。

得:依層取一值,非習慣之整分。

敗:屢擇 300 s→問循當存否→返步一。

三:整分之偏

排程按整分發。delaySeconds N→實 NN+60 s,依呼時之秒。

例:

HH:MM:40ScheduleWakeup({delaySeconds: 90})→目標 HH:(MM+2):00——實待 140 s,非 90。

故:秒精無義。視所傳為。若分偏為患→頻率過急,此器不宜。

得:受實待可長 60 s。熱勾 270 s 或成 330 s→出熱界。

敗:常近上限→下墊用 240 s 代 270 s。

四:守夾

運行夾 delaySeconds[60, 3600]。遙測分 chosen_delay_secondsclamped_delay_seconds,不合則 was_clamped: true

依夾後值策,非所求:

  • 求<60→實 60 s+分偏(可達 120 s)
  • 求>3600→實 3600 s(1 時)
  • 運行不延上限;多時之待須多勾

得:值在 [60, 3600] 內,或已明受夾。

敗:真須多時(如 4 時)→鏈勾(3600 勾內自再排)或用 CronCreatekind: "loop")。

五:書具體 reason

reason 為遙測、用者狀訊、緩存熱之由,三合一行。截 200 字。須具體。

  • 佳:checking long bun buildpolling for EC2 instance running-stateidle heartbeat — watching the feed
  • 劣:waitingloopnext tickcontinuing

讀者為用,無預見頻率而欲知循何為。為彼而書。

得:一句具體之由,狀訊一目可懂。

敗:無具體由→問循當存否(步一、六)。

六:識「勿循」之況

非每「稍後回」皆須勾。勾當:

  • 用者正察→彼輸入為發機,非計時
  • 無收斂準→循無「畢」之義
  • 任務互動(勾間問用者)
  • 所需頻率<60 s 夾底→此為事發驅動,非循

得:明擇勾與不循。「因能」非由。

敗:屢勾屢被用打斷→模式誤,非區間。

  • 分類:熱/冷/閒(擇一)
  • delaySeconds 在三層範圍內(60–270、1200–3600、或閒 1200–1800)
  • 值非 300(兩敗)
  • 值在 [60, 3600] 內或已明受夾
  • 已計分偏(值視為底)
  • reason 具體且<200 字
  • 已察「勿循」——勾確當

  • 整分慣性(300 s):最常誤。「5 分」自然而剛誤。降 270 或攤至 1200+
  • 忽分偏:於分末求 60 s→實可達 120 s。熱勾或逸 TTL
  • 秒精追求:粒度為分。85 vs 90 vs 95 皆噪——擇而行
  • 模糊 reason"waiting" 無助用者亦減遙測之用
  • 以此技辯不必之循:「察何」模糊→無區間可救→循勿存
  • 手工夾於提示:勿於推理中夾(「我封 3600 以安」)。運行夾之,任之
  • 忘 7 日汰:動態循默 7 日後收(用者可至 30)。長循宜於前畢,勿搶此限

示例

例一——熱察

bun build 已啟;代理欲速察使結果至時緩存仍熱。

  • 分類:熱察(步一)
  • 層:熱(步二),取 240 s
  • 分偏(步三):最壞實待~300 s——仍在 5 分 TTL 內(60 s 餘)
  • 由(步五):checking long bun build

例二——閒心拍

代理每時察低頻之流,覓可為之事。

  • 分類:閒(步一)
  • 層:閒默(步二),取 1800 s(30 分)
  • 分偏(步三):無關——60 s 偏於此頻可忽
  • 由(步五):idle heartbeat — watching the feed

例三——反模式

代理欲「待 5 分」使遠端 API 重試。求 300 s。

  • 患:5 分緩存冷→300 s 付失——然 300 s 太短不攤
  • 正:降 270 s(熱)或赴 1500 s(攤)。勿擇 300

  • manage-token-budget
  • du-dum
  • read-continue-here
  • write-continue-here

GitHub リポジトリ

pjt222/agent-almanac
パス: i18n/wenyan-ultra/skills/choose-loop-wakeup-interval
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

関連スキル

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、モバイル環境を切り替える際のセッション状態とコンテキストを管理することで、ワークフローを最適化します。様々な段階で異なるツールを必要とする複雑なプロジェクトにご活用ください。

スキルを見る