/video-build
당신은 코디네이터입니다. 게이트를 확인하고, 서브 에이전트를 단계별로 파견하며, 각 단계를 해당 파일로 검증하고, 자체 QA를 재실행한 후 전달 및 보고합니다. 당신은 컴포지션 코드, 사양 또는 내레이션을 작성하지 않으며, 렌더링도 수행하지 않습니다.
분할 이유: 이 스킬이 비롯된 프로덕션에서 메인 에이전트가 직접 영상을 제작할 때 컨텍스트가 8번 가득 찼으며, 한 번은 수정 중간에 발생했습니다. 반면, 조정만 수행할 때(통합, 브리프 작성, 증거 검토, 전달) 70분 만에 세 번의 수정이 배송되었습니다. 조정은 품질 게이트가 있는 곳이기도 합니다. 서브 에이전트가 "깨끗한" 렌더를 보고했지만, 코디네이터의 자체 QA에서 0.3초 플래시와 잘린 모달을 발견했습니다.
0. 작업 찾기
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
PY="$PVS_HOME/bin/pvs-py"; S="$PVS_HOME/skills/video-build/scripts" # 사용 시 둘 다 인용
<video>가 있는 경우: 현재 제품의videos/<video>/<video>가 없는 경우: 현재 있는 비디오 폴더, 또는 시트가 서명되고 현재 버전에 전달이 없는 모든 제품 비디오. 해당 목록을 표시하고, 아무것도 디스패치하기 전에 하나의 폐쇄형 질문으로 확인하세요.
각 비디오에 대해 "$PY" "$S/stages.py" <video_dir>을 실행하고 테이블을 표시하세요. 이미 완료된 단계는 건너뛰므로 /video-build는 중간에 중단된 빌드를 재개할 수 있습니다.
1. 게이트
"$PY" "$S/stages.py" <video_dir> --require signoff. BRIEF.md의 두 서명 중 하나라도 비어 있으면 중단하고, 사용자에게 무엇이 누락되었는지와 서명 방법(리뷰어가 이름을 쓰거나 /video-new에서 sign.py를 실행하도록 지시)을 알리세요. 이 확인은 가장 비용이 많이 드는 재작업(리뷰어가 설명을 원했지만 아무도 기록하지 않은 기능)이 빌드를 시작하는 것을 방지합니다.
--draft는 유일한 예외이며, 사용자가 입력한 경우에만 가능합니다. 초안은 빌드, 렌더링 및 QA 검사가 가능하여 리뷰어가 서명 전에 무언가를 볼 수 있지만, deliver.py는 이를 거부합니다. 보고서에 명시하세요.
또한 product.yaml, kit/RULES.md, BRIEF.md, COVERAGE.md 및 CLAIMS.md를 직접 읽으세요. 서브 에이전트 프롬프트를 작성하고 결과를 판단하는 데 필요합니다. 다른 것은 깊이 읽지 마세요.
2. 디스패치
백그라운드 서브 에이전트와 함께 Agent 도구를 사용하세요. 모든 단계에 대한 프롬프트는 references/stage-prompts.md에, 빌더 프롬프트는 references/builder-prompt.md에 있습니다. 첫 번째 디스패치 전에 읽고 모든 플레이스홀더를 채우세요. 각 서브 에이전트가 보고한 후, 이에 의존하는 작업을 시작하기 전에 "$PY" "$S/stages.py" <video_dir> --require <stage>를 실행하세요.
| 웨이브 | 단계 | 서브 에이전트 | 필요 항목 | 작성 항목 |
|---|---|---|---|---|
| 1 | recon | 비디오당 1개, source-recon | signoff | sources.lock, SOURCES.md |
| 2 | truth | 비디오당 1개, product-truth | recon | TRUTH.md |
| 2 | specs | 화면당 1개, ui-spec-from-code (또는 코드가 없는 화면은 ui-reference-capture) | recon | specs/<screen>.md |
| 3 | voice | 비디오당 1개, script-and-voice | truth | audio/lines.tsv, clips/, timings.json |
| 4 | compose + render | 비디오당 1개 빌더, ui-demo-composer + seek-safe-motion | specs, voice | video/, renders/<video>-v<N>.mp4 |
| 5 | qa | 당신 | render | qa/REPORT.json |
| 6 | deliver | 당신 | qa | deliveries/ |
웨이브는 비디오 간에 그리고 웨이브 내에서 병렬로 실행됩니다(truth와 모든 화면의 specs가 함께 전송됨). 여러 비디오가 하나의 머신을 공유합니다. 모든 프롬프트에서 어떤 에이전트도 자신이 시작하지 않은 프로세스를 종료하지 않으며, 다른 에이전트가 실행 중일 때 렌더가 느려질 수 있다고 명시하세요.
버전 1의 웨이브 3 이전에, 음성 제공자가 유료인 경우, 하나의 메시지로 사용자에게 내레이션 계획을 보여주세요: 챕터 표, 태그라인, 음성, 최대 세 개의 기본값이 있는 폐쇄형 결정. 내레이션 녹음은 공유 할당량을 소비하며, 리뷰어가 싫어하는 어조나 이름은 녹음 전에 변경하는 것이 가장 저렴합니다. 사용자가 이미 바로 진행하라고 말한 경우, 이를 건너뛰고 최종 보고서에서 거부권 행사를 위한 선택지를 대신 나열하세요.
서브 에이전트가 실행되는 동안 메시지로 폴링하지 마세요. 파일(수정 시간, $STAGES, 렌더 로그의 끝)을 통해 진행 상황을 확인하고, 서브 에이전트가 질문을 보내면 답변하세요. 승인은 사용자에게 올라가고, 결정은 다시 내려옵니다. 서브 에이전트가 사용자만 허용할 수 있는 것(다운로드, 새 에셋 소스)을 요청하면, 사용자에게 하나의 폐쇄형 질문을 하고 답변을 전달하세요.
서브 에이전트가 응답을 중단하면, "이전 에이전트가 에서 중단됨; 파일에서 계속"이라는 동일한 프롬프트로 새 에이전트를 시작하세요. 상태는 에이전트가 아닌 파일에 있습니다.
3. 빌더가 보고한 것과 관계없이 자체 QA
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/render-qa/scripts/qa.py" <video_dir> <mp4> \
--strip <name>:<t0>:<t1> ...
render-qa 스킬을 로드하여 결과를 읽는 방법을 확인하세요. 모든 챕터 제목, 모든 모달 및 엔드 스크린 주변에 스트립을 추가하여 핸드오프를 검증하세요(시간은 빌더의 챕터 표에서 가져옴). 그런 다음 qa/REPORT.md, 모든 콘택트 시트 및 모든 스트립을 직접 확인하세요. COVERAGE.md에 대해 내레이션을 확인하세요: 각 "yes" 행은 해당 챕터에서 설명되어야 합니다.
무언가 실패하면, 정확한 문제를 빌더에게 다시 보내거나(SendMessage로, 빌더가 살아있는 동안, references/stage-prompts.md의 압축된 수정 형식 사용), 빌더가 사라진 경우 $PVS_HOME/skills/video-review/references/fix-prompt.md의 프롬프트로 픽서를 시작하세요(파일을 읽으세요; 해당 스킬을 호출하지 마세요. 사용자 호출용입니다). 새 렌더에 대해 이 단계를 다시 실행하세요. 직접 QA하지 않은 렌더는 절대 전달하지 마세요.
4. 전달
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/render-qa/scripts/deliver.py" <video_dir> <mp4> --archive-previous
초안, 실패한 보고서 또는 sha256이 파일과 일치하지 않는 보고서는 거부합니다. 거부를 우회하지 말고 원인을 수정하세요. 전달된 파일을 덮어쓰지 마세요. deliver.py가 대신 이름을 증가시키고 경고하며, 그렇게 말하세요.
5. 보고
전체 배치에 대한 하나의 테이블, 그 다음 최대 세 개의 폐쇄형 결정:
| 비디오 | 버전 | 길이 | 챕터 | 커버리지 설명 | QA | 전달됨 |
|---|
아래에: 실제인 것과 가정된 것, 확인되지 않은 모든 것, 거부권 행사를 위한 이름, 음성 및 태그라인, 다음 단계(/video-review 및 리뷰어 노트 포함). 사용자의 언어로 짧게 작성하고, 테이블을 먼저 배치하세요.
참조 파일을 읽어야 할 때
references/stage-prompts.md: 웨이브 1~3을 디스패치하기 전, 및 모든 수정 요청 시.references/builder-prompt.md: 웨이브 4를 디스패치하기 전.