handoff

handoff 개요

handoff skill이 하는 일

handoff는 현재 대화를 다음 에이전트를 위한 간결한 인수인계 문서로 바꿔 줍니다. 빠르게 연속성을 확보해야 하는 순간, 즉 무엇이 중요한지, 무엇이 결정됐는지, 다음 세션에서 무엇을 해야 하는지를 요약하는 데 맞춰 설계된 skill입니다.

누가 사용하면 좋은가

세션 간 작업을 넘기고 있거나, 다른 에이전트에게 작업을 인계해야 하거나, 이어서 실행할 수 있는 AI용 브리프를 준비할 때 handoff skill을 사용하세요. 특히 repo 작업, 여러 단계가 이어지는 제품 업무, 그리고 컨텍스트 손실이 재작업으로 이어지는 워크플로우에서 유용합니다.

무엇이 다른가

handoff의 핵심 가치는 단순 요약이 아닙니다. 기존 산출물을 중복하지 않고, 다음 에이전트가 어떤 원본 자료를 경로(path)나 URL로 확인해야 하는지 분명히 짚는 실행 가능한 문서를 요구한다는 점이 중요합니다. 그래서 단순한 “이 채팅 요약해 줘” 프롬프트보다 훨씬 실무적입니다.

handoff skill 사용하는 방법

handoff를 설치하고 skill 파일부터 시작하기

일반적인 handoff install 흐름에서는 repo에서 skill을 추가한 뒤 SKILL.md를 먼저 여세요:

npx skills add mattpocock/skills --skill handoff

그다음에는 자신의 워크플로우에 적용하기 전에 SKILL.md를 읽어 정확한 출력 형식과 동작 방식을 이해하는 것이 좋습니다.

실제 세션 목적을 분명히 주기

handoff usage 패턴은 다음 세션이 무엇을 위한 것인지 알려 줄 때 가장 잘 작동합니다. repository의 argument hint는 다음처럼 초점이 분명한 문장을 기대합니다:

• “Continue debugging the TypeScript build failure in the payments package.”
• “Pick up the landing page copy review and finalize the CTA variants.”
• “Resume implementation of the auth flow after the API schema changes.”

“handoff 만들어 줘”처럼 막연하게 요청하면 문서의 완성도가 떨어집니다. 다음 세션의 목표를 구체적으로 잡아 주면, 무엇을 handoff에 담고 무엇을 덜어낼지 skill이 더 정확히 판단할 수 있습니다.

작성 전에 확인해야 할 파일 읽기

이 skill은 의도적으로 가볍게 설계되어 있으므로, 주요 원본은 SKILL.md입니다. 또한 handoff에 그대로 복사하지 말고, skill이 참조하는 주변 프로젝트 산출물도 함께 확인하세요:

• README.md
• AGENTS.md
• metadata.json
• 존재한다면 rules/, resources/, references/, scripts/ 폴더

작업 내용이 이미 PRD, plan, ADR, issue, diff, commit에 담겨 있다면, handoff는 그것을 반복하지 말고 해당 항목으로 링크해야 합니다. 그래야 문서는 짧게 유지되고 다음 에이전트의 속도도 빨라집니다.

자신이 아니라 다음 에이전트를 위해 쓰기

좋은 handoff 문서에는 보통 다음이 들어갑니다:

• 현재 목표와 진행 상태
• 이미 내려진 결정
• 남아 있는 질문이나 blocker
• 다음에 확인할 정확한 file path, URL, 또는 artifact
• 후속 세션에 추천할 skill

이것이 핵심 사용 원칙입니다. 프로젝트 전체 이력을 다시 설명하지 않으면서도, 다음 단계가 무엇인지 바로 보이게 만드는 것입니다.

handoff skill FAQ

handoff는 긴 대화에만 쓰는 건가요?

아닙니다. 짧지만 복잡한 교환 뒤에도 다음 에이전트가 더 적은 준비 시간으로 시작해야 한다면 handoff가 유용합니다. 결정 사항, dependency, 보존해야 할 source artifact가 있을 때 특히 가치가 큽니다.

일반적인 프롬프트와는 뭐가 다른가요?

일반적인 프롬프트는 요약만 요청하고 끝나는 경우가 많습니다. 반면 handoff skill은 더 분명한 입장을 가집니다. 전달 문서를 만들고, 중복을 피하고, 다음 세션이 써야 할 canonical artifact를 정확히 가리키도록 설계되어 있습니다.

초보자도 handoff를 써도 되나요?

네, 다음 작업을 분명하게 말할 수 있다면 괜찮습니다. 초보자는 간단한 초점 문장을 주고, skill이 그 내용을 유용한 brief로 정리하게 할 때 가장 좋은 결과를 얻습니다.

언제는 handoff를 쓰지 말아야 하나요?

다음 세션에 연속성이 필요하지 않거나, 필요한 컨텍스트가 이미 기존 artifact에 충분히 담겨 있어 다음 에이전트가 그것만 직접 읽으면 되는 경우에는 handoff를 쓰지 마세요.

handoff skill 개선 방법

다음 세션 목표를 구체적으로 만들기

handoff 출력의 품질은 다음 세션을 얼마나 선명하게 정의하느냐에 달려 있습니다. 더 나은 입력은 단순히 프로젝트 전체가 아니라, 정확한 단계, subsystem, decision point를 짚습니다.

source of truth artifact를 명시하기

현재 작업이 doc, issue, diff 안에 있다면 그 참조를 함께 넣어 handoff가 간결하게 유지되도록 하세요. 이 skill은 이미 다른 곳에 저장된 내용을 다시 복제하지 않도록 설계되어 있기 때문에 이 점이 중요합니다.

제약과 열린 질문을 함께 적기

가장 유용한 handoff 문서는 아직 해결되지 않은 것들을 담습니다: 구현 blocker, tradeoff, reviewer concern, 아직 확인이 필요한 가정 등입니다. 이런 세부사항이 있어야 다음 에이전트가 이전의 막다른 길을 다시 밟지 않습니다.

필요할 때 후속 skill을 제안하기

이 skill은 다음 세션에 맞는 skill 제안을 명시적으로 요청하므로, 다음 작업에 다른 워크플로우가 더 맞는다면 함께 넣으세요. 예를 들어 남은 일이 무엇이냐에 따라 다음 에이전트를 planning, coding, review 중심 skill로 안내할 수 있습니다.