Communitygithub.com

flivideo/flivideo

PO와 Dev 에이전트 간 핸드오버 커뮤니케이션을 중앙 큐 파일을 통해 관리합니다. (1) PO가 전체 컨텍스트와 함께 작업을 Dev에 전달할 때, (2) Dev가 큐에서 할당된 작업을 읽을 때, (3) Dev가 작업 완료를 메모와 함께 표시할 때, (4) PO가 완료된 항목을 체인지로그로 처리할 때 사용합니다. 현재 프로젝트 기준 `docs/handover-queue.md`에서 작동합니다.

flivideo란 무엇인가요?

이 스킬은 PO(Product Owner)와 Dev(개발자) AI 에이전트 간의 작업 전달(핸드오버)을 구조화된 큐 파일을 통해 관리합니다. 프로젝트 루트의 `docs/handover-queue.md` 파일을 단일 진실 공급원으로 사용하여 PO가 작업을 제출하고, Dev가 작업을 읽고 진행하며, 완료된 작업을 다시 PO가 검토하고 체인지로그에 반영하는 전체 워크플로를 지원합니다. 큐 파일은 `## Pending`, `## Completed`, `## Archived` 섹션으로 구성되어 있으며, 각 항목은 문제 정의, 구현 세부사항, 완료 노트를 포함하여 자기 완결적으로 작성됩니다. 이 스킬은 Claude Code, Cursor 등 파일 시스템을 기반으로 협업하는 모든 AI 에이전트에서 사용 가능하며, 별도의 외부 서비스나 복잡한 설정 없이 마크다운 파일 하나로 명확한 작업 전달과 상태 추적이 가능하게 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/flivideo/flivideo/tree/HEAD/.claude/skills/handover-queue

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

핸드오버 큐

PO와 Dev 에이전트 간의 중앙 파일 기반 커뮤니케이션.

파일 위치

큐 파일: docs/handover-queue.md (프로젝트 루트 기준)

파일이 존재하지 않는 경우: 사용자에게 파일 생성을 요청합니다. 동의하면 references/queue-format.md의 템플릿으로 생성합니다.

명령어

PO: 핸드오버 생성

PO가 "FR-XX 핸드오버" 또는 유사한 말을 하면:

  1. docs/handover-queue.md를 읽습니다.
  2. ## Pending 섹션에 새 항목을 추가합니다:
### FR-XX: 제목
**생성일:** YYYY-MM-DD
**상태:** Pending

**문제:** [한 문장]

**구현:**
[전체 구현 세부사항 - 파일, 코드 스니펫, 승인 기준]
[완전하고 자급자족적이어야 함 - Dev가 이것만 보고 작업]

---
  1. 핸드오버가 추가되었음을 확인합니다.

Dev: 큐 읽기

Dev가 "내 큐에 뭐가 있나요?" 또는 작업을 시작할 때:

  1. docs/handover-queue.md를 읽습니다.
  2. ## Pending 섹션의 항목들을 보여줍니다.
  3. 특정 FR-XX를 시작하는 경우 상태를 In Progress로 업데이트합니다.

Dev: 작업 완료

Dev가 "FR-XX 완료 표시" 또는 핸드오버를 제공할 때:

  1. docs/handover-queue.md를 읽습니다.
  2. FR-XX 항목을 ## Pending에서 ## Completed로 이동합니다.
  3. 항목을 업데이트합니다:
### FR-XX: 제목
**생성일:** YYYY-MM-DD
**완료일:** YYYY-MM-DD
**상태:** Complete

**문제:** [원본]

**구현:** [원본]

**완료 노트:**
[구현된 내용]
[변경된 파일]
[테스트 노트]

---

PO: 완료 항목 처리

PO가 "완료 항목 처리" 또는 유사한 말을 하면:

  1. docs/handover-queue.md를 읽습니다.
  2. ## Completed의 각 항목에 대해:
    • PO에 요약을 보여줍니다.
    • docs/changelog.md 업데이트를 도와줍니다.
    • docs/backlog.md 상태 업데이트를 도와줍니다.
  3. 처리 후 ## Completed 섹션에서 항목을 제거합니다.
  4. 선택적으로 기록 보존을 위해 ## Archived로 이동합니다.

큐 파일 형식

전체 템플릿과 예제는 references/queue-format.md를 참조하세요.

주요 원칙

  • 자기 완결적 핸드오버: Dev는 큐만 보고 작업하며, 파일을 뒤질 필요가 없습니다.
  • 단일 진실 공급원: 모든 활성 핸드오버가 한 곳에 있습니다.
  • 깔끔한 전환: 항목이 Pending → Completed → Archived/Removed 순서로 이동합니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬