본문으로 건너뛰기
cccskills
무료GitHub에 공개

aura-guard

토큰 예산 모니터. 컨텍스트 사용량 감시 및 컴팩트 방어 시스템 지원. Internal skill — not user-invocable.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

smorky850612/Aurakit
설치 방법 보기

포함된 파일(1)

  • SKILL.md3.6 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

AuraKit Guard — 컴팩트 방어 시스템

컨텍스트 창 과부하를 방지하는 자동 방어 레이어. 이 스킬은 내부적으로 동작하며 사용자가 직접 호출하지 않는다.

컴팩트 방어 아키텍처

세션 시작
    │
    ▼
컨텍스트 사용량 모니터링
    │
    ├─ 65% 미만 → 정상 작업 계속
    │
    └─ 65% 도달 ─────────────────────────────────────────┐
                                                          │
                                              CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=65
                                                          │
                                                          ▼
                                              pre-compact-snapshot.sh (PreCompact hook)
                                              ├─ 현재 스냅샷 백업
                                              ├─ transcript 요약 (claude -p)
                                              └─ .aura/snapshots/current.md 저장
                                                          │
                                                          ▼
                                                   /compact 자동 실행
                                                          │
                                                          ▼
                                              post-compact-restore.sh (PostCompact hook)
                                              ├─ .aura/snapshots/current.md 읽기
                                              └─ 내용을 stdout → Claude 컨텍스트 주입
                                                          │
                                                          ▼
                                              새 컨텍스트에서 이전 상태 복구됨

환경변수 설정

# ~/.bashrc 또는 ~/.zshrc에 추가 (init.sh가 자동 추가)
export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=65

이 설정으로 컨텍스트 65% 시점에 자동 컴팩트가 트리거된다. 기본값(90%)보다 일찍 압축하여 컨텍스트 손실을 방지한다.

토큰 사용량 확인 방법

Claude Code에서 /context 명령으로 현재 컨텍스트 사용량을 확인할 수 있다.

/context  →  현재 토큰 사용량 및 남은 용량 표시

Hook 연동

Hook 이벤트파일동작
PreCompactpre-compact-snapshot.sh스냅샷 저장
PostCompactpost-compact-restore.sh스냅샷 복구 + 컨텍스트 주입

스냅샷 파일 관리

.aura/snapshots/
├── current.md              ← 가장 최신 스냅샷 (항상 덮어씀)
├── SNAPSHOT-20250115-143022.md  ← 이전 스냅샷 백업
├── SNAPSHOT-20250115-152841.md
└── ...
  • current.md: 현재 작업 상태. PostCompact 후 컨텍스트에 주입됨
  • SNAPSHOT-*.md: 자동 백업. 수동 복구 시 참조

토큰 절약 원칙 (AuraKit 전체)

원칙절감량
Hook-First (bash hook으로 검증)~60%
Context:fork 에이전트 격리~25%
Fail-Only 출력~10%
Progressive Disclosure~5%

AuraKit — Context Budget Guard: 65% 방어선으로 무손실 작업 보장

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

aura

무료

All-in-one fullstack dev engine. /aura: 46 modes (build/fix/clean/deploy/review/spec/lore/ax/experiment/payment/debug/qa/orchestrate/escalate+), 6-layer security with 32 hooks, tiered models (ZERO/ECO/PRO/MAX), 8 languages, 16 specialized agents, SPEC/EARS/TRUST5/XLOOP/RALF/Autopus absorbed. ~55% token savings.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

smorky850612/Aurakit432026년 4월 16일 업데이트

aura-compact

무료

스냅샷 저장 + /compact 안내. 단일 명령으로 완료.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

smorky850612/Aurakit432026년 4월 16일 업데이트

smorky850612의 스킬 모두 보기

이 스킬의 문제 신고