handoff-baton은(는) 무엇을 하나요?
컨텍스트가 소진되기 전에 배턴을 넘기세요: 긴 에이전트 세션을 새로운 세션으로 전환하여 토큰 비용을 절감하는 정지-훅 + 스킬입니다.
개요
이 스킬은 장기 실행 AI 에이전트 작업 중 컨텍스트 창이 가득 차거나 토큰 비용이 증가할 때 현재 세션을 종료하고 새로운 세션으로 전환(핸드오프)하는 기능을 제공합니다. 정지-훅을 사용하여 세션 종료 전에 현재 상태(채팅 메시지, 파일 변경 사항 등)를 저장하고 새 세션에서 자동으로 복원합니다.
사용 방법
- 에이전트 세션에서 이 스킬을 활성화합니다.
- 작업 중 컨텍스트가 부족해지면
handoff-baton명령을 실행하거나 정지-훅이 자동으로 트리거됩니다. - 현재 세션이 종료되고 새 세션이 시작되며, 저장된 컨텍스트가 복원됩니다.
지원 플랫폼
- Claude Code
- Cursor
- Codex
설치
에이전트 설정에 따라 스킬을 설치하세요. 자세한 내용은 공식 문서를 참조하세요.
구성
환경 변수나 설정 파일을 통해 동작을 조정할 수 있습니다:
| 변수 | 설명 | 기본값 |
|---|---|---|
HANDBATON_SAVE_PATH | 상태 저장 경로 | ./.handbaton |
HANDBATON_AUTO_HOOK | 자동 훅 활성화 여부 | true |
명령어
/handoff- 현재 세션을 종료하고 배턴을 넘깁니다./status- 현재 저장된 컨텍스트 정보를 확인합니다.
참고
- 저장된 컨텍스트는 로컬 파일 시스템에 보관됩니다.
- 새 세션은 이전 세션의 작업 디렉터리와 주요 상태를 그대로 유지합니다.