Community코딩 & 개발github.com

letsroave/token-triage

고비용 작업 전 토큰 및 컨텍스트 비용을 절감하기 위한 이식 가능한 AI 에이전트 스킬입니다.

token-triage란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 고비용 추론이나 긴 응답 생성에 들어가기 전에 불필요한 컨텍스트, 토큰 낭비를 사전에 정리하도록 설계되었습니다. `token-triage`는 프롬프트의 크기와 복잡성을 평가하여 관련 없는 정보를 식별하고, 작업에 정말 필요한 부분만 남겨 비용(토큰 소비)과 성능을 최적화합니다. 다양한 AI-에이전트 플랫폼에서 이식 가능하도록 만들어졌으며, 명시적인 규칙이나 설정 없이도 에이전트가 자율적으로 컨텍스트 축소를 수행할 수 있습니다. 특히 대규모 코드베이스, 여러 파일의 컨텍스트, 긴 대화 기록이 포함된 작업에서 큰 효율성 향상을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add letsroave/token-triage

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

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

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

문서

token-triage은(는) 무엇을 하나요?

고비용 작업 전 토큰 및 컨텍스트 비용을 절감하기 위한 이식 가능한 AI 에이전트 스킬입니다.

개요

token-triage 스킬은 AI 에이전트가 작업을 시작하기 전에 현재 컨텍스트를 분석하고, 불필요하거나 중복된 정보를 제거하여 토큰 비용과 컨텍스트 길이를 줄이는 데 도움을 줍니다. 이는 특히 긴 대화 기록, 많은 파일 참조, 또는 큰 코드베이스 작업에서 유용합니다.

작동 방식

  1. 컨텍스트 분석: 에이전트가 현재까지 누적된 프롬프트, 파일 내용, 이전 응답을 스캔합니다.
  2. 비용 평가: 각 요소의 중요도와 현재 작업에 대한 관련성을 평가합니다.
  3. 축소 제안: 불필요한 요소(예: 참조되지 않은 파일, 오래된 대화, 중복된 정보)를 제거하거나 요약하는 제안을 생성합니다.
  4. 적용: 에이전트 또는 사용자가 제안을 승인하면 컨텍스트가 최적화됩니다.

사용 방법

이 스킬을 활성화한 후, 다음과 같은 명령어로 사용할 수 있습니다:

/token-triage

또는 에이전트가 자동으로 트리거할 수도 있습니다(예: 컨텍스트 길이가 임계값을 초과할 때).

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex
  • 기타 AI-에이전트 플랫폼 (이식 가능)

설정

별도의 설정 파일이 필요하지 않습니다. 이 스킬은 환경 변수나 에이전트 설정에 따라 동작합니다:

  • TOKEN_TRIAGE_ENABLED: true로 설정하면 스킬이 활성화됩니다. (기본값: true)
  • TOKEN_TRIAGE_THRESHOLD: 토큰 수가 이 값을 초과하면 자동 트리지가 실행됩니다. (기본값: 8000)

주의사항

  • 스킬이 불필요한 정보를 제거할 때 중요한 컨텍스트가 손실되지 않도록 주의하세요.
  • 제안된 변경 사항은 항상 검토 후 적용하는 것이 좋습니다.

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

관련 스킬