| name | handoff-prompt |
| description | Use when ending a session, switching AI tools, or creating a PR — to generate a structured handoff prompt that the next AI session can use as context. Covers branch state, completed work, do-not-touch constraints, verification results, and next actions. Does NOT capture raw logs or auto-summarize conversation. |
| metadata | {"source":"born-here","summary":"세션 전환 시 다음 AI 세션에 붙여넣을 handoff prompt를 사람이 직접 작성하도록 안내","routing":{"visibility":"contextual","risk_level":"medium","task_types":["handoff","session-transfer"],"triggers":[{"kind":"keyword","values":["핸드오프","인수인계","새 세션","넘겨줘","handoff"]},{"kind":"intent","values":["prepare_next_session_context"]}],"keywords":{"ko":["핸드오프","인수인계","넘겨","새 세션"],"en":["handoff","transfer","next session"]},"use_when":["세션 종료나 AI 도구 전환 전에 다음 세션이 이어받을 수 있는 짧은 export prompt가 필요한 경우"],"do_not_use_when":["장기 보존할 설계 맥락을 docs/context에 축적해야 하는 경우"],"requires":["current_repo_state"]}} |
Handoff Prompt — 세션 전환 export 가이드
이 스킬의 범위
이 스킬은 세션이 끝날 때 다음 AI 세션에 붙여넣을 handoff prompt를 사람이 직접 작성하도록 안내한다.
- raw log 읽기 금지
- transcript_path 읽기 금지
- 자동 summary 생성 금지
- hook, script, make target 없음
- 자동
docs/context 승격 없음
입력: 현재 repo 상태, 사람이 확인한 결정·제약·다음 액션
출력: 복붙용 handoff prompt 텍스트
project-context와의 차이
| 항목 | handoff-prompt | project-context |
|---|
| 목적 | 다음 세션의 즉시 실행을 위한 단기 export | 장기 설계·결정 맥락 축적 |
| 저장 위치 | 기본 미저장. 필요 시 local-only 임시 파일 | docs/context/* (Git tracking 가능) |
| 입력 | 현재 repo 상태 + 사람이 확인한 제약/결정 | human-confirmed 설계 배경, 장기 보존 맥락 |
| Git tracking | 금지 | curated 내용만 가능 |
| 수명 | 다음 세션 시작 후 폐기 | 장기 유지 |
handoff-prompt는 project-context를 반드시 거칠 필요 없다. 현재 repo 상태만으로도 생성 가능하다.
conversation-capture와의 차이
conversation-capture는 raw event 관측 계층이다. raw log를 생성하고 redacted candidate를 만든다.
handoff-prompt는 그 candidate를 사람이 검토·확인한 뒤에 쓰는 export 단계다.
흐름: conversation-capture → raw log → human review → confirmed → handoff-prompt export
안전 경계 (항상 준수)
- raw log 원문을 handoff prompt에 포함하지 않는다
- tool output 원문을 장기 복사하지 않는다
- secret / token / 개인 경로를 포함하지 않는다
- 자동 summary를 사실로 단정하지 않는다
- 민감 정보가 포함된 prompt를 다른 AI 세션에 전달하지 않는다
- next session에 raw log를 자동 주입하지 않는다
Handoff Prompt 작성 절차
1. 현재 repo 상태 수집 (CLI로 직접 확인)
git remote -v
git branch
git status
git log --oneline -3
gh pr list
2. 사람이 직접 확인해야 할 항목
아래를 CLI 결과나 직접 판단으로 채운다. 자동 summary가 아니라 사람이 인지하고 있는 사실만 써야 한다.
- 완료된 변경의 목적
- 중요한 결정과 이유
- 다음 액션 (1~3개, 구체적으로)
- 건드리면 안 되는 브랜치·파일·stash
- 검증 결과 (pass/fail/blocked)
3. 템플릿 채우기
아래 템플릿을 복사해서 채운다. 빈 항목은 (없음) 또는 N/A로 표시한다.
Handoff Prompt 템플릿
# Agent Handoff Prompt
## Goal
- <작업 목표와 완료 기준>
## Current Repo State
- Repository: <owner/repo 또는 local path>
- Current branch: <branch>
- Base branch: <base>
- Worktree status: <clean / dirty + 파일 목록>
- Last commit: <sha 제목>
- Remote: <credential 제거한 remote URL>
## Related Work
- Primary PR: <번호/URL/상태>
- Related PRs: <건드리면 안 되는 PR 포함>
- Tags / release baselines: <있으면>
## Do Not Touch
- master 직접 push 금지
- reset / rebase / force push 금지
- <다른 PR 브랜치 이름> 브랜치 금지
- stash@{n} 건드리지 않음
- <generated file 목록> 직접 수정 금지 (make instructions로 재생성)
## Local State / Stash
- Stashes: <관련 항목만>
- Must not apply/drop: <주의 stash>
- Local-only files/profiles: <profiles/local 등 git tracking 안 되는 파일>
## Completed Work
- <완료된 변경 요약 — raw log 아니라 사람이 판단한 사실>
- <중요 결정과 이유>
## Verification
- `make instructions`: <pass / fail / skip>
- `git diff --check`: <pass / fail / skip>
- `make doctor`: <pass / fail / skip>
- Known environment issues: <bwrap 등 환경 제약이 있으면>
- Generated file drift: <make instructions 후 clean 여부>
## Next Action
1. <정확한 다음 액션>
2. <그 다음 액션>
3. <있으면>
## Expected Final Report
- Branch:
- Changed files:
- Verification:
- Risks:
- Whether push/merge/tag was done:
작성 후 체크리스트
저장 여부
기본: 저장하지 않는다. 붙여넣고 세션 시작 후 폐기한다.
저장이 필요하면:
- local-only 임시 경로 (
~/.local/state/oh-my-ai/handoff-prompt-<date>.md)
- Git tracking 금지
- 민감 정보 포함 여부 재확인 후 저장
docs/context/에 그대로 저장하지 않는다. docs/context/는 human-confirmed 장기 맥락 전용이다.
