stay-within-limits

制限内に収める

長時間にわたるエージェントの作業は、現在の5時間および週間の使用量ウィンドウ内に収めてください。 大規模な作業を開始する前と、並列サブエージェントの各ウェーブの間に使用量を確認してください。有効な5時間または週間の制限が95%以上に達している場合は、安全に続行できる程度までウィンドウがクリアになるまで、新たな作業を一時停止してください。

基本ループ

1. 作業を区切ってウェーブを実行します。ユーザーまたはホストから別の上限が指定されていない限り、並列サブエージェントは最大3つを標準とします。
2. ウェーブが完了するまで待ちます。予算を節約するためだけに、実行中のサブエージェントを中断しないでください。通常、それでは作業が失われます。
3. ホストの使用量／予算ツールで、現在の5時間および週間の使用量を確認します。
4. いずれかのウィンドウが95%以上に達している場合は、作業の開始を停止し、該当するウィンドウがクリアになる見込みの時刻に、自己完結した再開をスケジュールします。
5. 再開時には、続行する前に実際のウィンドウまたは制限を再確認します。経過した実時間だけを信用しないでください。

使用量のシグナル

利用可能な場合は、ホストが提供するファーストパーティの使用量ツールを優先してください。Claude Codeでは、次を使用します。

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

JSONから、有効なブロックの開始時刻、現在のコストまたは使用率、残り時間を確認します。再開時には、有効なブロックの開始タイムスタンプを前回のものと比較してください。「十分な時間が経過した」ことよりも、新しいタイムスタンプのほうが確かな証拠です。

ツールが直接の使用率ではなくコストを報告する場合は、現在のアカウント上限が分かっていれば、それを使って換算します。Claude Max形式の5時間ブロックでは、ユーザーによっては$500-550程度の、より早い注意喚起しきい値を好む場合があります。これはユーザーが設定するガードレールとして扱い、共通のルールとはみなさないでください。既定の停止ルールは、引き続き有効な5時間または週間の上限の95%です。

一時停止と再開

起床／再開ツールが利用できる場合は、次の時刻に起床をスケジュールします。

min(3600, secondsUntilWindowClears)

ランタイムによって起床までの待機時間が60～3600秒に制限される場合は、待ち時間が長くなるよう、起床を連鎖させます。起床するたびに使用量を再確認し、予算超過が続いていれば再スケジュールします。ウィンドウがしきい値を十分に下回った場合にのみ続行してください。

起床プロンプトは自己完結させてください。次の内容を含めます。

• 残りの計画。
• 確認してから再スケジュールするルール。
• 95%のしきい値とウェーブの上限。
• 実行すべき正確な使用量コマンドまたはホストの使用量ツール。
• 利用可能な場合は、前回のブロック／ウィンドウ識別子。
• 次の確認手順。
• 委任を再開する場合は、スコープ、確認コマンド、停止条件を含む、次のウェーブへの引き継ぎ情報。

待機方法の選択

• エージェントが再開時に適用する指示を添える必要がある場合は、起床／再開ツールを使用します。
• 固定タイマーや、プロセスが直接監視できるものには、バックグラウンドのスリープまたはウォッチャーを使用します。
• 定期的に開始する新しいセッションの作業に限り、cronまたは定期スケジュールを使用します。

バックグラウンドタスクやサブエージェントの完了など、ホストから通知される事柄について、短い間隔でポーリングするのは避けてください。予算の一時停止では、長時間のスリープ後にプロンプトキャッシュがミスしても問題ありません。制限を守ることのほうが重要です。

報告

一時停止した場合は、どのウィンドウがしきい値を超えているか、観測した使用量、次の確認をいつスケジュールしたか、またはいつ実施する見込みか、残っている作業をユーザーに伝えてください。次のターンで会話の流れに頼らず再開できるよう、起床プロンプトに十分な状態情報を含めてください。