프로젝트 인계 (Project Handoff)
새로운 에이전트가 대화 내용 없이도 작업을 계속할 수 있도록 현재 스냅샷을 생성하세요. 직접 대화를 지우지 마십시오.
1. 대상 디렉터리 확인
문서를 작성하기 전에 인계 대상을 결정합니다:
- 호출 시 명시적으로 제공된 디렉터리가 있다면 우선 사용합니다. 경로를 정규화하고 존재하는지 확인합니다.
- 명시된 디렉터리가 없다면, 이 세션에서 실제로 논의, 읽기, 생성, 편집된 디렉터리와 파일을 바탕으로 후보를 추론합니다.
- 현재 작업 디렉터리, Codex 작업공간 루트, 버전 관리 루트,
README.md,AGENTS.md,package.json,pyproject.toml과 같은 프로젝트 표시자는 신호로만 사용합니다. 그 자체로 권위 있는 것은 없으며, 프로젝트가 Git을 사용할 필요도 없습니다. - 세션 증거가 명확하게 하나의 후보를 지지하는 경우에만 묻지 않고 진행합니다.
- 대상이 없거나 모호한 경우, 가능한 후보를 보여주고 한 문장으로 질문합니다:
HANDOFF.md 要写到哪个目录？추측하지 마십시오.
여러 개의 독립적인 프로젝트가 변경되었다면 각각 별도의 HANDOFF.md를 선호하고, 디렉터리를 확인한 후 작성합니다.
2. 실제 상태 조사
각 대상 디렉터리를 확인한 후:
- 관련 세션 작업을 검토하고 대상의 구조, 지침, 주요 문서, 구현 파일, 출력물을 조사합니다.
- 버전 관리가 존재하면 상태와 관련 변경 사항을 조사합니다. 없더라도 오류로 처리하지 않고 계속 진행합니다.
- 기존 테스트나 검증 증거를 활용합니다. 유용할 때만 가볍고 안전한 확인을 실행하며, 의존성을 설치하거나 관련 없는 프로젝트 변경을 하지 않습니다.
- 기존
HANDOFF.md를 업데이트하기 전에 읽습니다. 여전히 유효한 정보는 유지하고, 오래된 상태는 교체하며, 새로 완료된 작업은 남은 작업 섹션에서 제거합니다.
파일 시스템 증거를 사용할 수 있을 때 대화 내용에만 의존하지 마십시오.
3. HANDOFF.md 작성
다음 섹션이 포함된 간결한 현재 상태 문서로 <확인된-대상>/HANDOFF.md를 생성하거나 업데이트합니다:
# 프로젝트 인계 (Project Handoff)
> 업데이트: YYYY-MM-DD
> 대상: /절대/경로/확인됨
## 현재 상태 및 구조
## 완료된 작업
## 결정 사항 및 규칙
## 남은 작업 및 정확한 다음 단계
## 함정 및 막다른 길
## 검증, 위험 및 미해결 질문
다음 규칙을 적용합니다:
- 완료된 작업에는 구체적인 결과와 프로젝트 기준 파일/디렉터리 경로를 명시합니다.
- 결정 사항, 기술 선택, 스타일/명명 규칙 및 그 이유를 기록합니다. 필요한 경우 증거 위치를 포함합니다.
- 남은 작업을 실행 가능하게 작성합니다: 우선순위, 정확한 시작 파일 또는 명령어, 차단 요소, 완료 조건.
- 실패한 접근 방식과 실패 이유를 기록하여 다음 에이전트가 반복하지 않도록 합니다.
- 실행된 테스트나 확인 및 결과를 명시합니다. 확인되지 않은 것은 명확히 언급합니다.
- 관찰된 사실과 세션 주장 및 추론을 구분합니다. 불확실성은
待确认으로 표시합니다. 완료, 결정, 테스트 결과를 절대 조작하지 마십시오. - 절대 날짜, 간결한 문장, 경로를 사용하고 대화록 스타일의 서술은 피합니다.
- 자격 증명, 토큰, 개인 정보, 환경 파일 내용, 대규모 원시 로그를 절대 포함하지 마십시오.
- 추가 전용 기록이 아닌 최신 인계 스냅샷으로 파일을 유지합니다.
사용자가 명시적으로 다른 변경을 요청하지 않는 한, 의도한 HANDOFF.md만 수정합니다.
4. 확인 및 보고
완성된 파일을 다시 읽고 다음을 확인합니다:
- 확인된 디렉터리에 있는지;
- 필요한 모든 섹션이 있는지;
- 다음 작업이 새 에이전트가 즉시 시작할 수 있을 만큼 구체적인지;
- 주장, 경로, 날짜, 검증 상태가 사용 가능한 증거와 일치하는지;
- 민감한 정보가 문서에 복사되지 않았는지.
작성된 경로, 간략한 요약, 그리고 해결되지 않은 불확실성을 보고합니다. 사용자가 수동으로 /clear를 실행하여 인계를 검토할 수 있도록 여기서 멈춥니다.