Heim

Skill

Produktivität und Workflow

stay-within-limits

BuilderIO/skills

Halten Sie die Arbeit langlaufender Agenten innerhalb der 5-Stunden- und wöchentlichen Nutzungsgrenzen, indem Sie die Nutzung zwischen den Wellen überprüfen, in der Nähe der Grenze pausieren und erst dann fortsetzen, wenn das Zeitfenster frei ist.

...Alle erweitern

Zeit aktualisiert 6. September 2026

# Claude Code # rate limiting # agent orchestration # budget management # ccusage # pause resume # usage limits

Innerhalb der Grenzen bleiben

Halten Sie langlaufende Agentenarbeiten innerhalb der aktuellen 5-Stunden- und wöchentlichen Nutzungsfenster. Prüfen Sie die Nutzung vor dem Start umfangreicher Arbeiten und zwischen Wellen paralleler Subagenten. Wenn ein aktives 5-Stunden- oder wöchentliches Limit bei oder über 95 % liegt, pausieren Sie neue Arbeiten, bis das Fenster klar genug ist, um sicher fortzufahren.

Kernschleife

Führen Sie eine begrenzte Arbeitswelle durch. Standardmäßig maximal 3 parallele Subagenten, es sei denn, der Benutzer oder Host gibt eine andere Drosselung vor.
Warten Sie, bis die Welle abgeschlossen ist. Unterbrechen Sie keine laufenden Subagenten nur, um Budget zu sparen; das führt normalerweise zum Verlust von Arbeiten.
Prüfen Sie die aktuelle 5-Stunden- und wöchentliche Nutzung mit dem Nutzungs-/Budget-Tool des Hosts.
Wenn eines der Fenster bei oder über 95 % liegt, stoppen Sie das Starten neuer Arbeiten und planen Sie eine eigenständige Wiederaufnahme, wenn das relevante Fenster voraussichtlich freigegeben wird.
Prüfen Sie bei der Wiederaufnahme erneut das tatsächliche Fenster oder Block, bevor Sie fortfahren. Verlassen Sie sich nicht allein auf die verstrichene Wanduhrzeit.

Nutzungssignale

Bevorzugen Sie ein First-Party-Host-Nutzungs-Tool, wenn verfügbar. Verwenden Sie in Claude Code:

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

Verwenden Sie das JSON, um den Start des aktiven Blocks, die aktuellen Kosten oder den Prozentsatz sowie die verbleibende Zeit zu identifizieren. Vergleichen Sie beim Aufwachen den Zeitstempel des Starts des aktiven Blocks mit dem vorherigen; ein neuer Zeitstempel ist ein stärkerer Hinweis als „genug Zeit ist vergangen“.

Wenn das Tool Kosten anstelle eines direkten Prozentsatzes meldet, konvertieren Sie diesen durch das aktuelle Kontolimit, wenn bekannt. Für 5-Stunden-Blöcke im Claude-Max-Stil bevorzugen es einige Benutzer, einen früheren Warnschwellenwert von etwa 500–550 $ zu verwenden; betrachten Sie dies als eine benutzerdefinierte Sicherheitsvorrichtung, nicht als universelle Regel. Die Standard-Stopregel bleibt 95 % des aktiven 5-Stunden- oder wöchentlichen Limits.

Pausieren und Fortsetzen

Wenn ein Wake-/Resume-Tool verfügbar ist, planen Sie einen Weckruf für:

min(3600, secondsUntilWindowClears)

Wenn die Laufzeit Weckverzögerungen auf 60–3600 Sekunden beschränkt, verketten Sie Weckrufe für längere Wartezeiten. Jeder Weckruf sollte die Nutzung erneut prüfen, bei weiterhin über Budget neu planen und nur fortfahren, wenn das Fenster sicher unter dem Schwellenwert liegt.

Machen Sie Weckaufforderungen eigenständig. Fügen Sie hinzu:

Den verbleibenden Plan.
Die Regel „Prüfen und neu planen“.
Den 95 %-Schwellenwert und die Wellendrosselung.
Den genauen Nutzungsbefehl oder das Host-Nutzungs-Tool, das ausgeführt werden soll.
Die vorherige Block-/Fensterkennung, wenn verfügbar.
Die nächsten Verifikationsschritte.
Die Übergabepakete der nächsten Welle, einschließlich Umfang, Verifikationsbefehlen und Stoppbedingungen, falls die Delegation fortgesetzt wird.

Auswahl des Wartemechanismus

Verwenden Sie ein Wake-/Resume-Tool, wenn der Agent Anweisungen benötigt, die an die zukünftige Wiederaufnahme angehängt sind.
Verwenden Sie einen Hintergrund-Schlaf oder Beobachter für feste Timer und Dinge, die ein Prozess direkt beobachten kann.
Verwenden Sie Cron oder wiederkehrende Zeitpläne nur für wiederkehrende Arbeiten in neuen Sitzungen.

Vermeiden Sie Polling mit kurzen Intervallen für Dinge, über die der Host Sie benachrichtigt, wie z. B. die Fertigstellung von Hintergrundaufgaben oder Subagenten. Für Budgetpausen ist ein Prompt-Cache-Miss nach einem langen Schlaf akzeptabel; die Einhaltung des Limits ist wichtiger.

Berichterstattung

Wenn Sie pausieren, teilen Sie dem Benutzer mit, welches Fenster den Schwellenwert überschreitet, die beobachtete Nutzung, wann Sie die nächste Prüfung geplant oder erwartet haben und welche Arbeiten noch ausstehen. Halten Sie genügend Status im Weckprompt, damit die nächste Runde ohne Abhängigkeit von der Gesprächsdynamik fortgesetzt werden kann.

Auf GitHub ansehen

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