opção

stay-within-limits

BuilderIO/skills BuilderIO/skills

Mantenha o trabalho de agentes de longa duração dentro dos limites de 5 horas e do uso semanal, verificando o consumo entre as ondas, pausando perto do limite e retomando apenas quando a janela estiver livre.

...Expandir tudo
0
Tempo atualizado 6 de Setembro de 2026

Mantenha-se Dentro dos Limites

Mantenha o trabalho de agentes de longa duração dentro das janelas de uso atuais de 5 horas e semanais. Verifique o uso antes de iniciar trabalhos substanciais e entre ondas de subagentes paralelos. Se um limite de 5 horas ou semanal ativo estiver em ou acima de 95%, pause novos trabalhos até que a janela esteja limpa o suficiente para continuar com segurança.

Loop Principal

  1. Execute uma onda de trabalho limitada. Por padrão, use no máximo 3 subagentes paralelos, a menos que o usuário ou o host forneça um limite diferente.
  2. Aguarde a conclusão da onda. Não interrompa subagentes em execução apenas para economizar orçamento; isso geralmente resulta na perda de trabalho.
  3. Verifique o uso atual de 5 horas e semanal com a ferramenta de uso/orçamento do host.
  4. Se qualquer uma das janelas estiver em ou acima de 95%, pare de lançar trabalhos e agende uma retomada autossuficiente quando a janela relevante estiver limpa.
  5. Ao retomar, verifique novamente a janela real ou o bloqueio antes de continuar. Não confie apenas no tempo decorrido no relógio.

Sinais de Uso

Prefira uma ferramenta de uso de host de primeira classe quando disponível. No Claude Code, use:

npx -y ccusage@latest blocks --active --json

Use o JSON para identificar o início do bloqueio ativo, o custo atual ou a porcentagem e o tempo restante. Ao despertar, compare o timestamp de início do bloqueio ativo com o anterior; um novo timestamp é uma evidência mais forte do que "tempo suficiente passou".

Se a ferramenta relatar custo em vez de uma porcentagem direta, converta através do limite atual da conta quando conhecido. Para blocos de 5 horas estilo Claude Max, alguns usuários preferem um limiar de cautela mais cedo em torno de $500-550; trate isso como uma proteção configurada pelo usuário, não como uma regra universal. A regra de parada padrão ainda é 95% do limite ativo de 5 horas ou semanal.

Pausando e Retomando

Quando uma ferramenta de despertar/retomada estiver disponível, agende um despertar para:

min(3600, segundosAtaLimparJanela)

Se o tempo de execução limitar os atrasos de despertar para 60-3600 segundos, encadeie despertares para esperas mais longas. Cada despertar deve verificar novamente o uso, reagendar se ainda estiver acima do orçamento e continuar apenas quando a janela estiver seguramente abaixo do limiar.

Faça os prompts de despertar autossuficientes. Inclua:

  • O plano restante.
  • A regra de verificar-então-reagendar.
  • O limiar de 95% e o limite de onda.
  • O comando de uso exato ou a ferramenta de uso do host a ser executada.
  • O identificador de bloco/janela anterior, quando disponível.
  • As próximas etapas de verificação.
  • Os pacotes de transferência da próxima onda, incluindo escopo, comandos de verificação e condições de parada, se a delegação for retomada.

Escolhendo o Mecanismo de Espera

  • Use uma ferramenta de despertar/retomada quando o agente precisar de instruções anexadas à futura retomada.
  • Use uma suspensão em segundo plano ou observador para temporizadores fixos e coisas que um processo pode observar diretamente.
  • Use cron ou agendamentos recorrentes apenas para trabalho de sessão fresca recorrente.

Evite a sondagem de curto intervalo para coisas que o host notificará você, como conclusão de tarefa em segundo plano ou subagente. Para pausas de orçamento, uma falha no cache de prompt após uma longa suspensão é aceitável; preservar o limite é mais importante.

Relatórios

Se você pausar, informe ao usuário qual janela está acima do limiar, o uso observado, quando você agendou ou espera a próxima verificação e qual trabalho permanece. Mantenha estado suficiente no prompt de despertar para que o próximo turno possa retomar sem depender do impulso da conversa.

Ver no GitHub
---
name: stay-within-limits
description: Keep long-running agent work within 5-hour and weekly usage limits by checking usage between waves, pausing near the cap, and resuming only when the window is clear.
---

# Stay Within Limits

Keep long-running agent work inside the current 5-hour and weekly usage windows.
Check usage before launching substantial work and between waves of parallel
subagents. If an active 5-hour or weekly limit is at or above 95%, pause new
work until the window is clear enough to continue safely.

## Core Loop

1. Run a bounded wave of work. Default to at most 3 parallel subagents unless
   the user or host gives a different throttle.
2. Wait for the wave to finish. Do not interrupt in-flight subagents just to
   save budget; that usually loses work.
3. Check current 5-hour and weekly usage with the host's usage/budget tool.
4. If either window is at or above 95%, stop launching work and schedule a
   self-contained resume when the relevant window should clear.
5. On resume, re-check the real window or block before continuing. Do not trust
   elapsed wall-clock time alone.

## Usage Signals

Prefer a first-party host usage tool when available. In Claude Code, use:

```sh
npx -y ccusage@latest blocks --active --json
```

Use the JSON to identify the active block start, current cost or percentage, and
time remaining. On wake, compare the active block start timestamp with the
previous one; a new timestamp is stronger evidence than "enough time passed."

If the tool reports cost instead of a direct percentage, convert through the
current account limit when known. For Claude Max-style 5-hour blocks, some users
prefer an earlier caution threshold around $500-550; treat that as a
user-configured guardrail, not a universal rule. The default stop rule is still
95% of the active 5-hour or weekly limit.

## Pausing And Resuming

When a wake/resume tool is available, schedule a wakeup for:

```txt
min(3600, secondsUntilWindowClears)
```

If the runtime clamps wake delays to 60-3600 seconds, chain wakeups for longer
waits. Each wakeup should re-check usage, reschedule if still over budget, and
continue only when the window is safely below the threshold.

Make wake prompts self-contained. Include:

- The remaining plan.
- The check-then-reschedule rule.
- The 95% threshold and wave throttle.
- The exact usage command or host usage tool to run.
- The previous block/window identifier when available.
- The next verification steps.
- The next wave's handoff packets, including scope, verification commands, and
  stop conditions, if delegation will resume.

## Choosing The Wait Mechanism

- Use a wake/resume tool when the agent needs instructions attached to the
  future resume.
- Use a background sleep or watcher for fixed timers and things a process can
  observe directly.
- Use cron or recurring schedules only for recurring fresh-session work.

Avoid short-interval polling for things the host will notify you about, such as
background task or subagent completion. For budget pauses, a prompt-cache miss
after a long sleep is acceptable; preserving the limit matters more.

## Reporting

If you pause, tell the user which window is over threshold, the observed usage,
when you scheduled or expect the next check, and what work remains. Keep enough
state in the wake prompt that the next turn can resume without relying on
conversation momentum.

Todos os arquivos

0 arquivos

Instalar stay-within-limits

Baixe e extraia os arquivos de habilidade para o diretório .claude/skills/.

Baixar ZIP

Clone o repositório e copie os arquivos da habilidade para o seu projeto.

git clone https://github.com/BuilderIO/skills/tree/main/skills/stay-within-limits # Copy SKILL.md to your .claude/skills/ directory

Copiar Copiar
Configuração rápida: Copie a pasta de habilidades para .claude/skills/ O Claude detectará e usará automaticamente a habilidade
Repositório BuilderIO/skills

Habilidades relacionadas

seo-programmatic
Tempo atualizado 29 de Junho de 2026
notion-automation
Tempo atualizado 29 de Junho de 2026
airtable-automation
Tempo atualizado 29 de Junho de 2026
fairdb-backup-manager
Tempo atualizado 29 de Junho de 2026
OR