Community코딩 & 개발github.com

Willis1214/Token-Gate-Skill

비용이 많이 드는 에이전트 작업 전에 불필요한 토큰 낭비를 방지하는 Codex 스킬입니다.

Token-Gate-Skill란 무엇인가요?

이 스킬은 Codex 에이전트가 고비용 작업(예: 장기 실행, 다단계 추론 또는 대규모 컨텍스트 처리)에 들어가기 전에 토큰 사용량을 사전 점검하여 불필요한 토큰 낭비를 방지합니다. 개발자는 이 스킬을 통해 에이전트가 실행 계획을 수립할 때 예상 토큰 비용을 평가하고, 과도한 토큰이 소모될 것으로 예상되는 작업을 조정하거나 중단할 수 있습니다. 주로 Codex 플랫폼에서 동작하며, 사전 정의된 임계값(threshold)을 기준으로 작업의 토큰 효율성을 판단합니다. SKILL.md 문서에는 임계값 설정 방법, 토큰 추적 방식, 그리고 경고 및 중단 로직이 상세히 기술되어 있어, 개발자가 자신의 워크플로우에 맞게 쉽게 커스터마이징할 수 있습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add Willis1214/Token-Gate-Skill

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

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

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

문서

Token-Gate-Skill은(는) 무엇을 하나요?

비용이 많이 드는 에이전트 작업 전에 불필요한 토큰 낭비를 방지하는 Codex 스킬입니다.

개요

이 스킬은 Codex 에이전트가 고비용 작업을 시작하기 전에 예상 토큰 사용량을 평가하여 낭비를 방지합니다. 작업이 설정된 토큰 임계값을 초과할 경우 경고를 표시하거나 작업을 중단할 수 있습니다.

주요 기능

  • 토큰 사용량 사전 점검: 에이전트가 실행 계획을 수립할 때 예상 토큰 비용을 계산합니다.
  • 임계값 기반 제어: 사용자 정의 가능한 토큰 한도(예: 10000 토큰)를 설정하여 초과 시 작업을 차단합니다.
  • 경고 및 중단 시스템: 임계값 초과 시 경고 메시지를 출력하고 사용자 승인을 기다리거나 자동으로 중단합니다.
  • 커스터마이징 가능: SKILL.md 파일에서 임계값, 동작 모드(차단/경고)를 쉽게 수정할 수 있습니다.

사용 방법

  1. 스킬을 Codex 환경에 추가합니다.
  2. SKILL.md 파일에서 TOKEN_LIMIT 및 ACTION 변수를 설정합니다.
    TOKEN_LIMIT: 10000
    ACTION: "block"  # 또는 "warn"
    
  3. 에이전트가 작업을 시작할 때 자동으로 토큰 사용량을 추적합니다.
  4. 임계값 초과 시 설정된 동작이 실행됩니다.

지원 플랫폼

  • Codex CLI
  • Codex IDE (곧 지원 예정)

예제

# 토큰 한도를 5000으로 설정하고 경고 모드로 사용
TOKEN_LIMIT=5000 ACTION=warn codex run "작업 설명"

라이선스

MIT

관련 스킬