MCP HubMCP Hub
Retour aux compétences

choose-loop-wakeup-interval

pjt222
Mis à jour 5 days ago
35 vues
17
2
17
Voir sur GitHub
Designdesign

À propos

Cette compétence aide les développeurs à choisir des valeurs optimales de `delaySeconds` pour planifier les réveils de boucles en fonction de l'état du cache, évitant ainsi les anti-modèles comme le délai de 300 secondes. Elle propose une logique de décision à trois niveaux (cache chaud, absence de cache, inactif) et gère le clampage à l'exécution ainsi que l'arrondi aux limites des minutes. Utilisez-la lors de la conception de boucles autonomes, du réglage de la cadence d'interrogation ou du diagnostic des coûts liés aux intervalles.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add pjt222/agent-almanac -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternatif
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/choose-loop-wakeup-interval

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

擇循環醒寐之時

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. -->

Dépôt GitHub

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

Compétences associées

executing-plans

Design

Utilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.

Voir la compétence

requesting-code-review

Design

Cette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.

Voir la compétence

connect-mcp-server

Design

Cette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.

Voir la compétence

web-cli-teleport

Design

Cette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.

Voir la compétence