claude-handoff로 Claude Code의 대화를 이어받는 방법
機械翻訳 / Machine-translated
원문: claude-handoff로 Claude Code의 대화를 이어받는 방법(cccskills)
스킬 페이지: claude-handoff
이 글의 결론
claude-handoff를 도입하면 Claude Code의 현재 대화를 요약하고, 새로운 백그라운드 에이전트에 이후 작업을 맡길 수 있습니다.
긴 작업을 이어가는 분께 적합한 스킬로, 이어받는 위치는 같은 작업 디렉터리입니다.
여기서는 호출 시 발생하는 일, 다음 목적을 좁혀서 이어받는 방법, 설치 방법과 주의사항을 설명합니다.
claude-handoff를 호출하면 현재 대화가 이어받기용 요약으로 만들어집니다.
새 에이전트는 그 요약을 첫 번째 지시사항으로 받아 백그라운드에서 작동하기 시작하는 구조입니다.
이어받는 세션의 시작 위치는 현재 작업 디렉터리이므로, 같은 저장소나 폴더에서 그대로 이어서 작업할 수 있습니다.
/claude-handoff 다음 세션에서는 로그인 오류 수정에 집중한다
이 요청을 보내면 에이전트는 먼저 지금까지의 대화를 요약하고, OS의 임시 디렉터리에 파일로 저장합니다.
다음으로 claude --bg로 백그라운드 에이전트를 시작하고, 요약 파일의 내용을 첫 번째 지시사항으로 전달하는 흐름입니다.
시작 명령은 즉시 반환되므로, 기존 대화가 대기 상태가 되는 일은 없습니다.
새 에이전트에는 「Fix login bug」와 같이 내용을 알 수 있는 이름이 붙습니다.
이름이 표시되는 곳은 작업 목록, 세션 선택 화면, 터미널 타이틀입니다.
시작된 에이전트는 claude agents로 일괄 관리합니다.
claude-handoff를 사용하면 대화 요약부터 다음 에이전트 시작까지 한 번의 호출로 완료됩니다.
직접 요약을 작성해 새 세션에 붙여넣는 작업은 필요 없습니다.
주요 기능은 다음 4가지입니다.
긴 대화의 경위를 새 에이전트가 이어서 시작할 수 있는 형태로 정리합니다.
요약은 파일을 통해 시작 명령에 전달됩니다.
따라서 요약에 백틱이나 $가 포함되어 있어도 셸이 이를 실행하거나 확장하는 일은 없습니다.
호출 시 인수를 붙이면, 그것이 다음 세션의 목적으로 처리됩니다.
「로그인 오류 수정」을 덧붙이면 요약도 그 작업에 맞춰 작성됩니다.
다음에 무엇을 할지 정해진 상황에서, 불필요한 경위를 끌고 가지 않아도 되는 것이 장점입니다.
사양서, 계획, ADR(설계 판단 기록), Issue, 커밋, 차분에 남아 있는 내용은 요약에 그대로 옮겨 쓰지 않습니다.
대신 경로나 URL로 참조하므로, 같은 정보가 중복으로 포함되는 일은 없습니다.
요약에는 「suggested skills」 섹션도 포함되어, 다음 에이전트가 호출해야 할 스킬이 기재됩니다.
요약은 그대로 다음 에이전트에 대한 지시사항이 됩니다.
이 때문에 API 키, 비밀번호, 개인을 특정할 수 있는 정보는 요약에서 제외하도록 되어 있습니다.
설치 방법은 명령어를 한 줄 실행하거나 에이전트에게 부탁하는 2가지입니다.
명령어로 설치하는 경우 다음 한 줄을 실행합니다.
Claude Code나 Codex 등, 설치할 대상은 실행 시 선택할 수 있습니다.
npx skills add https://github.com/mattpocock/skills --skill claude-handoff
에이전트에게 부탁하는 경우 다음 내용을 그대로 보내주세요.
내용 확인을 먼저 마친 후 배치하는 절차로 되어 있습니다.
次の Agent Skill をインストールしてください。
https://github.com/mattpocock/skills/tree/main/skills/in-progress/claude-handoff
まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/claude-handoff/、Codex なら ~/.agents/skills/claude-handoff/ に配置してください。
직접 배치하는 경우의 위치는 다음 표와 같습니다.
| 설치 대상 | 전체 프로젝트 공통 | 프로젝트 단위 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 프로젝트의 .claude/skills/ |
| Codex | ~/.agents/skills/ | 프로젝트의 .agents/skills/ |
배포처는 GitHub의 mattpocock/skills이며, 스타 수는 320478개입니다.
claude-handoff는 이 저장소의 in-progress 폴더에 있습니다.
에이전트가 자동으로 호출하지 않는 설정이므로, 사용할 때는 /claude-handoff와 같이 이름을 지정해주세요.
기본적으로는 작업의 전환점에서 /claude-handoff를 호출합니다.
다음 목적이 정해져 있다면 인수로 덧붙여주세요.
/claude-handoff
인수 없이 호출하면 현재 대화를 정리한 요약이 만들어집니다.
새 에이전트는 그 요약을 지시사항으로 받아, 같은 작업 디렉터리의 백그라운드에서 시작하는 구조입니다.
/claude-handoff 로그인 화면 오류 수정에만 집중할 수 있도록 이어받아 줘
목적을 덧붙이면 요약이 그 작업에 맞는 내용이 됩니다.
이어받는 세션에는 작업 내용을 알 수 있는 이름이 붙으므로, 작업 목록에서 다른 에이전트와 구분하는 데 어려움이 없습니다.
/claude-handoff docs/plan.md의 계획에 따라 구현을 진행한다
계획을 파일에 남겨두었다면 요약은 그 내용을 그대로 옮겨 쓰지 않고 경로로 참조합니다.
새 에이전트는 요약과 계획 파일을 단서로 같은 작업 위치에서 이어서 시작합니다.
전제로서 claude --bg로 백그라운드 에이전트를 시작할 수 있는 Claude Code 환경이 필요합니다.
이어받는 세션 시작에는 claude 명령어를 사용합니다.
Codex에 배치하는 경우에도 이 명령어가 동작하는 환경이 필수입니다.
이어받기 전에 정해진 사양이나 계획을 파일이나 Issue에 작성해두는 것을 권장합니다.
그렇게 해두면 요약은 그것들을 경로나 URL로 참조합니다.
또한 요약 자체의 저장 위치는 OS의 임시 디렉터리입니다.
비밀 정보를 제외하는 지시는 스킬에 포함되어 있습니다.
그래도 대화에서 API 키나 비밀번호를 다룬 경우에는 호출 시 「비밀 정보는 요약에 포함하지 않는다」고 덧붙이면 안심할 수 있습니다.
라이선스는 MIT입니다.
설치 전에 SKILL.md를 읽고, 외부 전송이나 인증 정보 읽기가 없는지 확인해주세요.
같은 mattpocock/skills에는 긴 작업을 나눠가며 진행할 때 함께 활용하기 좋은 스킬이 있습니다.
chief-of-staff는 장기적인 목표를 향해 여러 서브 에이전트의 작업을 조율하는 스킬입니다.
사용자와의 대화를 이어가면서 작업 환경이나 규약의 개선도 함께 진행합니다.
한 번씩 이어받는 것보다 큰 단위로 전체 작업을 운영하고 싶은 상황에 적합합니다.
ask-matt는 상황에 맞는 관련 스킬과 그 사용 순서를 안내합니다.
다음 에이전트에 어떤 스킬을 사용할지 고민될 때 상담할 수 있는 스킬입니다.
시작 명령은 즉시 반환되므로 기존 대화는 그대로 계속 사용할 수 있습니다.
새 에이전트는 백그라운드에서 작동하며 claude agents로 관리합니다.
확인하는 곳은 claude agents입니다.
시작 시 붙여진 이름이 표시되는 곳은 작업 목록, 세션 선택 화면, 터미널 타이틀입니다.
여러 에이전트를 동시에 실행 중이어도 구별할 수 있습니다.
Codex의 배치 위치에 설치하는 것 자체는 가능합니다.
단, 이어받는 세션 시작에는 claude --bg를 사용하므로 Claude Code 명령어가 동작하는 환경이 필요합니다.
스킬에는 API 키, 비밀번호, 개인을 특정할 수 있는 정보를 제외하는 지시가 포함되어 있습니다.
그렇더라도 요약은 다음 에이전트에 대한 지시사항이 됩니다.
비밀 정보를 다룬 대화에서는 제외하도록 덧붙여 호출하면 안심할 수 있습니다.
claude-handoff는 길어진 Claude Code 대화를 요약하고 새로운 백그라운드 에이전트에 이후 작업을 맡기는 스킬입니다.
이어받는 세션은 같은 작업 디렉터리에서 알기 쉬운 이름을 붙여 시작됩니다.
다음 목적을 덧붙이면 요약의 초점이 좁혀지고, 사양서나 계획은 경로나 URL로 참조됩니다.
긴 작업을 나눠가며 진행하고 싶은 분은 cccskills 페이지에서 시도해보세요.
이 글은 cccskills의 읽을거리 「claude-handoff로 Claude Code의 대화를 이어받는 방법」의 전재입니다.
스킬의 상세 내용과 설치 방법은 cccskills의 claude-handoff 페이지에 있습니다.