choose-loop-wakeup-interval
О программе
Этот навык вычисляет оптимальное значение `delaySeconds` для планирования пробуждений цикла, применяя кэш-ориентированную логику, ограничения времени выполнения и предотвращение антипаттернов. Он используется при проектировании автономных циклов, планировании ритма heartbeat или настройке интервалов опроса. Выходные данные включают готовое для телеметрии поле `reason`, объясняющее выбранный интервал.
Быстрая установка
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:守 5 分緩存 TTL、整分粒度、[60, 3600] 夾。避「5 分」兩敗之位。
用
- 策
/loop或ScheduleWakeup之每勾延→用 - 長駐代理之心拍→用
- 輪詢頻率之調→用
- 事後察費過高→用
- 書指南、劇本→用
入
- 必:循之所待(事、遷、勾、察)
- 必:讀時須熱緩存乎?或冷可受乎?
- 可:事件可生之下界
- 可:總費之上界
行
一:分類
- 熱察: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→實 N 至 N+60 s,依呼時之秒。
例:
於
HH:MM:40呼ScheduleWakeup({delaySeconds: 90})→目標HH:(MM+2):00——實待 140 s,非 90。
故:秒精無義。視所傳為底。若分偏為患→頻率過急,此器不宜。
得:受實待可長 60 s。熱勾 270 s 或成 330 s→出熱界。
敗:常近上限→下墊用 240 s 代 270 s。
四:守夾
運行夾 delaySeconds 於 [60, 3600]。遙測分 chosen_delay_seconds 與 clamped_delay_seconds,不合則 was_clamped: true。
依夾後值策,非所求:
- 求<60→實 60 s+分偏(可達 120 s)
- 求>3600→實 3600 s(1 時)
- 運行不延上限;多時之待須多勾
得:值在 [60, 3600] 內,或已明受夾。
敗:真須多時(如 4 時)→鏈勾(3600 勾內自再排)或用 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 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-budgetdu-dumread-continue-herewrite-continue-here
GitHub репозиторий
Похожие навыки
executing-plans
ДизайнИспользуйте навык executing-plans, когда у вас есть полный план реализации для выполнения контролируемыми партиями с контрольными точками проверки. Он загружает и критически анализирует план, затем выполняет задачи небольшими партиями (по умолчанию 3 задачи), сообщая о прогрессе между каждой партией для проверки архитектором. Это обеспечивает систематическую реализацию со встроенными контрольными точками проверки качества.
requesting-code-review
ДизайнЭтот навык запускает суб-агента для ревью кода, который анализирует изменения в коде на соответствие требованиям перед дальнейшими действиями. Его следует использовать после завершения задач, реализации крупных функций или перед слиянием с основной веткой. Ревью помогает выявить проблемы на ранней стадии, сравнивая текущую реализацию с исходным планом.
connect-mcp-server
ДизайнЭтот навык предоставляет разработчикам подробное руководство по подключению серверов MCP к Claude Code с использованием транспортов HTTP, stdio или SSE. Он охватывает установку, конфигурацию, аутентификацию и безопасность для интеграции внешних сервисов, таких как GitHub, Notion и пользовательские API. Используйте его при настройке интеграций MCP, конфигурации внешних инструментов или работе с Model Context Protocol от Claude.
web-cli-teleport
ДизайнЭтот навык помогает разработчикам выбирать между веб-интерфейсом Claude Code и CLI на основе анализа задачи, а также обеспечивает бесшовное перемещение сессий между этими средами. Он оптимизирует рабочий процесс, управляя состоянием и контекстом сессии при переключении между веб-интерфейсом, CLI или мобильным приложением. Используйте его для сложных проектов, требующих различных инструментов на разных этапах работы.
