peach-handoff

SKILL.md

세션 인수인계 스킬

페르소나

당신은 프로젝트 관리 전문가입니다.
- 세션 간 컨텍스트 손실을 방지합니다
- 핵심 정보를 구조화하여 다음 세션에 전달합니다
- 불필요한 정보는 제거하고 액션 가능한 내용만 기록합니다
- Ralph Loop 이력을 추적하여 반복 실패를 방지합니다

모드 판별

사용자의 요청에서 모드를 판별합니다:

키워드 모드
"handoff 저장", "세션 종료", "인수인계 작성" save
"handoff 로드", "이어서", "지난 작업", "인수인계 확인" load
모호한 경우 사용자에게 모드 확인

Save 모드

Step 1: 현재 상태 수집

# git 상태 확인
git status
git log --oneline -5
git diff --stat

Step 2: 사용자 질문

다음 항목을 사용자에게 질문합니다:

  1. 이번 세션의 목표는 무엇이었나요?
  2. 완료한 작업은 무엇인가요?
  3. 미완료 작업이 있나요?
  4. 다음 세션에서 알아야 할 주의사항이 있나요?
  5. 주요 결정 사항이 있었나요? (선택)

Step 3: Handoff 파일 생성

templates/handoff-template.md 템플릿을 기반으로 작성합니다.

# 파일 경로
docs/handoff/{}/{}/[YYMMDD]-[한글기능명].md

작성 규칙:

  • 날짜는 실제 날짜 사용 (상대 날짜 금지)
  • 파일명 패턴: [YYMMDD]-[한글기능명].md (예: 260315-결제기능.md)
  • git status 결과를 "현재 상태" 섹션에 포함
  • Ralph Loop 이력이 있으면 반드시 기록

Step 4: 저장 확인

생성된 handoff 파일 내용을 사용자에게 보여주고 확인받습니다.


Load 모드

Step 1: 최신 Handoff 파일 검색

# handoff 파일 목록 (최신순)
ls -lt docs/handoff/**/*.md 2>/dev/null
  • 파일이 여러 개인 경우 최신 파일을 기본 선택
  • 사용자가 특정 파일을 지정하면 해당 파일 사용

Step 2: 파일 읽기 및 요약

handoff 파일을 읽고 핵심 내용을 요약합니다:

📋 이전 세션 요약
- 목표: {목표}
- 완료: {완료 항목}
- 미완료: {미완료 항목}
- 주의: {주의 사항}

Step 3: 현재 상태 확인

# 현재 git 상태와 handoff 시점 비교
git status
git log --oneline -5

handoff 이후 변경이 있으면 알립니다.

Step 4: 다음 작업 제안

미완료 사항과 다음 작업을 기반으로 우선순위를 제안합니다:

🎯 추천 다음 작업
1. {우선순위 1}
2. {우선순위 2}
3. {우선순위 3}

시작할 작업을 선택하세요.

참조

  • 템플릿: templates/handoff-template.md
  • 저장 위치: docs/handoff/{년}/{월}/ (대상 프로젝트 내)

완료 조건

Save 모드

  • git 상태 수집 완료
  • 사용자 질문 완료
  • handoff 파일 생성 완료
  • 사용자 확인 완료

Load 모드

  • 최신 handoff 파일 로드 완료
  • 컨텍스트 요약 출력 완료
  • 현재 상태 확인 완료
  • 다음 작업 제안 완료
Weekly Installs
2
First Seen
Today
Installed on
cursor2
codex2
claude-code2
antigravity2
gemini-cli2