handoff-skill

Handoff는 동일한 작업이 여러 AI 에이전트 세션에 걸쳐 이어지는 저장소를 위한 에이전트 스킬입니다. 목록에 남겨진 체크되지 않은 작업이 반드시 미완료 상태인 것은 아닙니다. 다른 에이전트가 이를 구현했거나, 커밋이 이를 충족했거나, 요구사항이 변경되었거나, 다른 누군가가 여전히 관련 파일을 소유하고 있을 수 있기 때문입니다. 이 스킬은 공유 원장 파일인 HANDOFF.md와 Git 기록, 현재 코드, 테스트, 소유권 등의 저장소 증거를 함께 사용하여 실제로 미완료된 작업이 무엇인지 판단합니다. 기록된 워크플로는 6단계로 구성됩니다. 사전 점검(Preflight)은 세션 이름을 선점하고, 버전이 지정된 하나의 스냅샷에서 단계, 최근 완료된 항목 요약, 구조 오류 및 Git 상태가 포함된 모든 열린 원장 항목을 반환합니다. 인테이크(Intake)는 각 요청을 날짜가 지정된 작업 항목으로 변환하며, 별도의 진행 중 및 완료 체크박스, 단계, 검증, 상태 라인을 포함합니다. 점진적 감사(Progressive audit)는 이후의 원장 항목, 커밋, 현재 소스, 실시간 소유권, 이전 항목의 체크박스를 비교하여 유효한 범위를 완료, 부분 완료, 대체됨, 미완료 또는 알 수 없음으로 분류하고, 기록이 보존되도록 삭제하는 대신 주석을 남깁니다. 소유권 해결(Ownership resolution)은 사용자가 이미 명시적인 순서를 지정하지 않은 경우, 새로운 작업이 시작되기 전에 자격이 있는 작업을 먼저 완료해야 할지 또는 현재 소유자에게 남겨두어야 할지 묻습니다. 안전한 쓰기(Safe writes)는 동료들이 동일한 트리에 쓸 수 있을 때 잠긴 비교-교환(compare-and-swap)을 통해 업데이트를 라우팅합니다. 마지막으로 에이전트는 명시적 경로를 스테이징하고, 검증 및 커밋 식별자를 기록하며, 다음 에이전트가 이어갈 수 있는 상태를 남깁니다. 원장 항목에는 소유자 레이블, 선택적 하네스 필드(Claude Code, Codex, Cursor, VS Code 자동 감지 및 환경 변수를 통한 재정의 가능), 상태 상자, 체크 및 미체크된 단계, 상태 라인, 다음 작업이 기록됩니다. 완료된 작업은 원장이 기록으로 읽힐 수 있도록 두 상자 모두 체크된 상태로 유지됩니다. 세션은 백 명의 신화 속 인물 명단에서 이름을 선점하며, 선착순으로 배포되고 원장에 이미 존재하는 소유자와 절대 중복되지 않습니다. 이 프로젝트는 에이전트와 작업을 위한 실시간 curses 대시보드가 포함된 표준 라이브러리 Python CLI를 제공합니다. 이 대시보드는 완료된 작업 대 전체 작업, 진행 중 및 대기 중인 수, 단계 진행 상황, 그리고 기록된 경우 각 소유자가 사용한 하네스를 보여줍니다. 또한 일반 텍스트 스냅샷 모드, 읽기 전용 모드, 현재 버전이 고정된 설치를 해결하는 PATH 런처 뒤에서 실행할 수도 있습니다. 대시보드는 작업을 잘라내어 다른 소유자에게 붙여넣는 기능을 지원하며, 이는 소유자 레이블을 다시 쓰고 동일한 잠금 상태에서 이동을 기록합니다. 상태 표시줄 스크립트는 한 줄의 진행 상황 행을 출력하며, Claude Code, Grok CLI, Kimi Code 상태 표시줄에서 작동하고 Codex 및 기타 CLI를 위한 tmux 래퍼와 함께 작동하는 것으로 문서화되어 있습니다. 로컬 에이전트 채널은 데몬이나 소켓 없이 하나의 체크아웃 범위로 제한된 gitignored SQLite 파일에 메시지와 승인을 저장합니다. 에이전트는 질문을 보내고, 답변하고, 가용성을 보고하고, 미완료 버킷을 해제하고, 임대에 대한 갱신 마감일을 선언하고, 다른 에이전트가 응답함을 보여주기 위해 챌린지/증명 넌스 교환을 사용할 수 있습니다. 설치는 마켓플레이스의 Claude Code 플러그인, Cursor 마켓플레이스 가져오기, 또는 다른 호스트를 위한 npx skills add를 통해 제공되며, README에 따르면 Git, 저장소 읽기/편집 권한이 있는 에이전트, Python 3.9+가 필요하며 API 키, 호스팅 서비스 또는 타사 Python 패키지는 필요하지 않습니다. 머신을 벗어나는 유일한 기능은 구성 파일이 존재할 때까지 비활성화 상태로 유지되는 옵션 ssh 게시 단계입니다. 5개의 슬래시 명령어는 원장 초기화, 보기, 상태, 계속 및 정리를 다루며, README는 curses 대시보드 및 상태 표시줄 빠른 경로에 대한 Windows 제한 사항을 언급합니다.