返回技能列表

choose-loop-wakeup-interval

pjt222
更新于 5 days ago
36 次查看
17
2
17
在 GitHub 上查看
设计design

关于

This skill helps developers choose optimal `delaySeconds` values for scheduling loop wakeups based on cache state, avoiding anti-patterns like the 300-second delay. It provides a three-tier decision logic (cache-warm, cache-miss, idle) and handles runtime clamping and minute-boundary rounding. Use it when designing autonomous loops, tuning polling cadence, or diagnosing interval-related costs.

快速安装

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 之值於 ScheduleWakeup,合乎緩存五分之壽、調度整分之粒、[60, 3600] 之限。其擇非淺:常人之念「約五分」,正陷兩失之地——既失緩存,又不攤長待。

其理本隨 ScheduleWakeup 之具述而至呼時,然其時循環已定。此技將其理提於謀時,正其所宜也。

用時

  • 設自主 /loopScheduleWakeup 驅續,擇每刻之遲
  • 為長行之使者謀心跳之律,將察、將觀、將迭
  • 調輪詢之律以應本或緩存之壓
  • 事後察循環之本,而覺時距失宜
  • 書引、書行冊、書有 delaySeconds 之例

  • :循環所待者何(某事、某態之變、閒刻、週察)
  • :此刻讀者需新脈絡乎(緩存溫)抑或可忍冷讀(緩存失可受)
  • 可選:所待事之最早可發之下界(如「建至少四分」)
  • 可選:循環總本之上限(刻數 × 每刻之本)

第一步:分待之類

定此待屬何階:

  • 主察(緩存溫):五分內有變可期——建將成、態將遷、程方啟
  • 緩存失之待:五分內無值察之事;脈絡緩存將冷而可受
  • :無特定之兆可察;循環來察,蓋或有所得,非必有所得

得: 分明之類:主察、緩存失、或閒。

敗則: 若待不可分——若無誠答於「吾何所待」——此循環或本不宜存。跳至第五步,慎思不設醒寐。

第二步:施三階之擇

依所分擇 delaySeconds

緩存之行用於
緩存溫60 – 270 秒緩存溫存(未及五分之壽)主察——下刻需速且廉之再入
緩存失1200 – 3600 秒緩存冷;一失換久待真閒、或所待事不可早發
閒之常1200 – 1800 秒(二十至三十分)緩存冷無特兆;週察而用者可中斷

勿擇 300 秒。 此兩失之距:緩存已失,而待太短不足攤其失。若念「約五分」,降至 270 秒(保溫)或定 1200 秒以上(攤其失)。

得: 自三階中擇定一 delaySeconds,非習擇之整分之數。

敗則: 若擇屢落 300 秒,根本之問常為「此循環當以此律存乎」——重察第一步。

第三步:量於分界

調度者發於整分之界。delaySecondsN 者,實遲為 NN + 60 秒,視呼時於分中何秒而定。

例:

HH:MM:40ScheduleWakeup({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 為循環(CronCreatekind: "loop")代之。

第五步:書具體之 reason

reason 者,遙測、用者可見之狀、緩存溫之理合一也。截於 200 字。宜具體。

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

此欄之讀者乃用者,欲解循環所為而不必預知其律。為其書也。

得: 一具體之語,使用者一瞥狀態而解之。

敗則: 若無具體之由可述,重思循環是否當存(第一步與第六步)。

第六步:識勿循環之境

非每「後來」之念皆宜設醒寐。不可設刻於:

  • 用者主察——其入為正觸,非計時
  • 無收斂之準——循環無「畢」之義
  • 任務互動(於刻間問用者)
  • 所需之律短於限之底(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-hereread-continue-here 之補
<!-- Keep under 500 lines. Current: ~200 lines. -->

GitHub 仓库

pjt222/agent-almanac
路径: i18n/wenyan/skills/choose-loop-wakeup-interval
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

相关推荐技能

executing-plans

设计

该Skill用于当开发者提供完整实施计划时,以受控批次方式执行代码实现。它会先审阅计划并提出疑问,然后分批次执行任务(默认每批3个任务),并在批次间暂停等待审查。关键特性包括分批次执行、内置检查点和架构师审查机制,确保复杂系统实现的可控性。

查看技能

requesting-code-review

设计

该Skill可在完成任务、实现主要功能或合并代码前自动调度代码审查子代理,确保实现符合需求和计划。它支持通过指定git SHA范围进行精准的代码变更审查,帮助开发者在关键节点及时发现潜在问题。核心原则是"早审查、勤审查",适用于开发流程的各个关键阶段。

查看技能

connect-mcp-server

设计

这个Skill指导开发者如何将MCP服务器连接到Claude Code,支持HTTP、stdio和SSE三种传输协议。它涵盖了从安装配置到认证安全的完整流程,适用于集成GitHub、Notion、数据库等外部服务。当开发者需要添加集成、配置外部工具或提及MCP相关功能时,这个Skill能提供实用的操作指南。

查看技能

web-cli-teleport

设计

该Skill帮助开发者根据任务特性选择Claude Code的Web或CLI界面,并指导如何在两种环境间无缝迁移会话。它能分析任务复杂度、迭代需求等要素,推荐最优工作界面和工作流。关键特性包括会话状态管理、环境切换指导和上下文优化建议。

查看技能