Community코딩 & 개발github.com

BuilderIO/한도 준수

장기 실행 또는 병렬 에이전트 작업이 5시간 및 주간 사용 한도를 준수하도록 하여 작업 집단 사이에서 사용량을 확인하고, 한도에 근접하면 일시 중지하며, 창이 비워졌을 때만 재개합니다.

한도 준수란 무엇인가요?

이 스킬은 장기 실행 또는 병렬 에이전트 작업이 활성 5시간 및 주간 사용 한도를 초과하지 않도록 보장합니다. 작업 집단(기본적으로 최대 3개의 병렬 하위 에이전트)을 실행하기 전에 먼저 사용량을 확인하고, 각 집단이 완료된 후에 다시 확인합니다. 활성 5시간 또는 주간 한도가 95% 이상에 도달하면 작업을 일시 중지하고, 창이 안전하게 비워질 때까지 기다린 후에만 재개합니다. 일시 중지된 경우, 재개 알림은 남은 계획, 확인-재일정 규칙, 95% 임계값, 정확한 사용량 명령어, 이전 블록/창 식별자, 다음 확인 단계, 그리고 위임이 계속될 경우 다음 작업 집단의 핸드오프 패킷을 포함해야 합니다. Claude Code와 같은 플랫폼을 지원하며, `ccusage@latest` 도구를 사용하여 사용량을 확인합니다. 깨어나기 메커니즘은 상황에 따라 wake/resume 도구, 백그라운드 sleep/watcher, 또는 cron을 선택합니다. 일시 중지 시 사용자에게 어떤 창이 임계값을 초과했는지, 관찰된 사용량, 다음 확인 일정, 남은 작업을 보고합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BuilderIO/skills/tree/main/skills/stay-within-limits

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

한도 준수은(는) 무엇을 하나요?

장기 실행 에이전트 작업을 현재 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% 임계값 및 집단 스로틀.
  • 실행할 정확한 사용량 명령어 또는 호스트 사용량 도구.
  • 가능한 경우 이전 블록/창 식별자.
  • 다음 확인 단계.
  • 위임이 재개될 경우, 다음 집단의 핸드오프 패킷(범위, 확인 명령어, 중지 조건 포함).

대기 메커니즘 선택

  • 에이전트가 미래 재개에 첨부할 지침이 필요한 경우 깨우기/재개 도구를 사용하세요.
  • 고정 타이머 및 프로세스가 직접 관찰할 수 있는 항목에는 백그라운드 sleep 또는 watcher를 사용하세요.
  • 반복되는 새 세션 작업에만 cron 또는 정기 일정을 사용하세요.

호스트가 백그라운드 작업 또는 하위 에이전트 완료와 같이 알려줄 항목에 대해 짧은 간격 폴링을 피하세요. 예산 일시 중지의 경우 긴 sleep 후 프롬프트 캐시 미스는 허용됩니다. 한도를 보존하는 것이 더 중요합니다.

보고

일시 중지하는 경우, 사용자에게 어떤 창이 임계값을 초과했는지, 관찰된 사용량, 다음 확인을 예약했거나 예상하는 시기, 남은 작업을 알려주세요. 깨우기 프롬프트에 충분한 상태를 유지하여 다음 턴이 대화 모멘텀에 의존하지 않고 재개할 수 있도록 하세요.

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

BuilderIO/adding-a-skill

Use in the BuilderIO/skills repo whenever adding, updating, publishing, documenting, validating, or wiring a public skill. Covers the repo-local skill files, root catalog docs, plugin metadata, @agent-native/skills dynamic install path, optional managed AGENTS/CLAUDE instruction blocks in ../agent-native/framework, and generated/synced Plan skill gotchas.

BuilderIO/agent-watchdog

Use when asked to watch, babysit, audit, review, compare, or fix another agent's work from a Codex session ID, Claude Code session/transcript, chat/thread link, PR, branch, log, or pasted run summary. Monitor until the other agent is done or blocked, reconstruct what the user asked, inspect what the agent actually changed and verified, report gaps, and optionally make scoped fixes when the user authorizes repair.

BuilderIO/efficient-fable

Use when running Claude Fable on codebase-heavy or token-heavy work and the user wants Fable to orchestrate research, coding, and testing while cheaper subagents do bounded heavy lifting.

BuilderIO/efficient-frontier

Apply the same orchestration as `/efficient-fable` to any high-cost frontier model: delegate research, coding, and testing to cheaper subagents while keeping planning, synthesis, and final review with the expensive model.

BuilderIO/plan-arbiter

Use when asked to compare, cross-review, merge, judge, choose, or arbitrate competing plans from multiple agents such as Codex and Claude Code; when given two or more proposed plans, session IDs, transcripts, plan documents, PR descriptions, or pasted strategies; or when the user wants one recommended execution plan after agents review each other's proposals.

BuilderIO/plow-ahead

Use when the user explicitly wants autonomous progress without routine clarification stops: "plow ahead", "do not stop", "use your best judgment", "keep going until done", "finish while I am away", "do not ask questions unless truly blocked", or similar. Convert ordinary ambiguity into stated assumptions, proceed through implementation and validation, stop only for true blockers, and end with a clear recap of decisions, changes, verification, and residual risk.

BuilderIO/quick-recap

Use when adding or following the red/yellow/green final status block convention for agent responses, especially by installing managed AGENTS.md or CLAUDE.md instructions.

BuilderIO/read-the-damn-docs

Use when implementing, integrating, upgrading, debugging, or answering anything involving third-party APIs, libraries, frameworks, CLIs, cloud services, model/provider SDKs, fast-moving product behavior, user requests for latest/current/official behavior, unfamiliar repo docs/specs, errors that may indicate API drift, or high-stakes auth, security, billing, data, migration, deployment, compliance, or privacy behavior. Forces Codex to web-search for current official docs and read primary docs before assuming from memory.

BuilderIO/visual-plan

Turn ordinary text plans into rich interactive visual plans with diagrams, file maps, annotated code, open questions, and UI/prototype review when useful.

BuilderIO/visual-recap

Turn a PR, branch, commit, or git diff into an interactive visual recap with diagrams, file maps, API/schema summaries, annotated diffs, and focused review notes.

관련 스킬