핸드오프은(는) 무엇을 하나요?
새 에이전트가 전체 대화를 다시 읽지 않고도 이 작업을 계속할 수 있도록 핸드오프 문서를 작성합니다. 상태와 의도를 캡처하고, 대화 기록을 그대로 옮기지 마세요.
저장 위치
핸드오프는 현재 프로젝트 리포지토리 내부에 저장하세요. OS 임시 디렉토리나 채팅 인라인에 절대 저장하지 마세요.
- 리포지토리 루트 확인:
git rev-parse --show-toplevel실행. 실패하면(git 리포지토리가 아닌 경우) 현재 작업 디렉토리로 대체합니다. - 해당 루트에
handoffs/디렉토리가 있는지 확인하고, 없으면 생성합니다. handoffs/<slug>-handoff-<UTC-타임스탬프>.md파일에 작성합니다. 여기서:<slug>는 작업(또는 전달된 인자)에서 파생된 짧은 케밥-케이스 주제입니다. 예:notebook-proxy-review.<UTC-타임스탬프>는YYYYMMDDTHHMMSSZ형식입니다. 예:20260527T144059Z. 타임스탬프는 각 핸드오프를 구분하며, 기존 핸드오프를 절대 덮어쓰지 않습니다.
- 작성 후, 생성한 파일의 절대 경로를 출력합니다.
작성할 내용
이 스킬에 인자가 전달된 경우, 해당 인자를 다음 세션의 초점으로 취급하고 모든 섹션을 그 방향으로 편향시킵니다.
다음 섹션을 사용하세요. 각 섹션은 제한된 길이를 유지하세요. 핸드오프는 포인터 문서이지 모든 것을 기록하는 문서가 아닙니다. 실제로 비어 있는 섹션은 채우지 말고 생략하세요.
- 헤더 — 제목, 날짜(UTC), 다음 세션의 목적에 대한 한 줄 설명. (≤5줄)
- 목표 — 목표와 성공 기준. (≤3문장)
- 현재 상태 — 완료된 것, 작동하는 것, 검증된 것과 가정된 것. (≤10개 항목)
- 다음 단계 — 다음 에이전트를 위한 구체적이고 순서화된 작업. (≤8개 항목)
- 주요 결정 및 근거 — 확정된 선택과 그 이유. 다음 에이전트가 재논의하지 않도록 합니다. (≤8개 항목)
- 주의사항 / 지뢰 — 이미 만난 함정, 예상치 못한 문제, 완료된 것처럼 보이지만 실제로는 아닌 것. (≤8개 항목)
- 관련 파일 및 참조 — 코드, PRD, 계획, 차이점, 이슈의 경로와 URL. 참조만 하고 내용을 인라인으로 포함하지 마세요. (≤12개 항목)
- 미해결 질문 — 사용자 또는 추가 작업이 필요한 미결정 사항. (≤6개 항목)
- 제안된 스킬 — 다음 에이전트가 호출해야 할 스킬과 각각의 한 줄 이유. (≤6개 항목)
규칙
- 다른 아티팩트(PRD, 계획, ADR, 이슈, 커밋, 차이점)에 이미 캡처된 내용을 중복하지 마세요. 대신 경로나 URL로 참조하세요.
- 큰 파일 내용이나 전체 명령 출력을 핸드오프에 붙여넣지 마세요. 소스를 가리키세요.
- 비밀과 개인 식별 정보(PII)를 삭제하세요. API_KEY / SECRET / TOKEN / PASSWORD / PRIVATE_KEY 또는 개인 데이터와 일치하는 모든 항목. 로컬 파일 경로는 괜찮습니다.