/video-review
한 번의 리뷰 라운드: 전체 배치를 수집하고, 비디오별로 통합한 후, 피드백이 있는 모든 비디오를 동시에 수정하고, 각 결과를 직접 확인한 후 다음 버전을 전달하고 보고합니다.
배치 및 병렬 처리의 이유: 이 스킬이 나온 실제 제작 과정에서 세 개의 피드백이 5분 간격으로 도착했고, 에이전트가 첫 번째 피드백을 자체 컨텍스트에서 수정하기 시작했습니다. 컨텍스트가 가득 차서 리뷰어가 중단해야 했고, 피드백을 하나씩 처리하는 방식은 비효율적이라고 지적했습니다. 하나의 표로 통합하고 세 개의 병렬 서브 에이전트에 전달했을 때, 동일한 세 개의 수정 사항이 70분 후에 검토 및 전달되었습니다. 수정은 단순한 렌더링이 아닙니다. 편집, 내레이션, 렌더링, QA 및 보고서 작성에 비디오당 50~90분이 소요되므로 직렬 수정은 시간이 배가됩니다.
0. 설정
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
PY="$PVS_HOME/bin/pvs-py"
제품(현재 디렉토리 위에서 가장 가까운 product.yaml)을 찾고 해당 비디오 목록과 현재 버전 및 전달 상태를 확인합니다(skills/video-build/scripts/stages.py를 각각 실행).
1. 전체 배치 가져오기
인수가 파일이면 읽고, 텍스트이면 그대로 사용합니다. 그런 다음 한 번 질문합니다: "이것이 이번 라운드의 모든 비디오에 대한 모든 피드백입니까? 피드백이 없는 비디오는 그대로 둡니다." 수정을 시작하기 전에 답변을 기다립니다. 통합하는 동안 추가 피드백이 계속 도착하면 동일한 라운드에 추가하고, 메시지별로 수정을 시작하지 마십시오.
2. 비디오별로 하나의 표로 통합
"$PY" "$PVS_HOME/skills/video-review/scripts/feedback_table.py" <product_dir> <notes file or -> \
--out <product_dir>/reviews/round-<date>.md
각 피드백을 해당 비디오(ID, 제목 또는 헤딩 기준) 아래에 그대로 정렬하고, "모든 비디오"에 대한 피드백은 공유 섹션에 배치하며, 배치할 수 없는 피드백을 나열합니다. 그런 다음 각 행에 다음을 입력합니다: 의미(변경되어서는 안 되는 사항을 포함한 귀하의 해석), 수용 기준(확인 방법: 시간 범위, 스트립, 프레임), 모든 비디오에 대한 규칙?
표를 채우기 전에 references/review-protocol.md를 읽으십시오. 받아쓰기 오류, 실제로는 규칙인 피드백, 제품과 충돌하는 피드백을 다룹니다.
모든 피드백에 대해 물어볼 세 가지 질문:
- 이것이 정말 규칙입니까? 그렇다면 이번 라운드의 모든 비디오에 적용되며, 리뷰어가 지적한 비디오에만 해당하지 않습니다. 한 리뷰어가 한 비디오에 대한 적용 범위 규칙을 제시했지만, 몇 시간 후에야 모든 비디오에 적용하도록 다시 요청해야 했습니다.
- 제품이 실제로 이를 수행합니까? 수정을 약속하기 전에 코드를 확인하십시오. 그렇지 않다면, 권장 옵션("존재하는 것만 표시")이 포함된 폐쇄형 질문을 합니다.
- COVERAGE.md에 누락된 기능입니까? 그렇다면 수정 시 행을 추가합니다.
통합된 표를 사용자에게 최대 세 개의 폐쇄형 결정(기본값 명시)과 함께 보여줍니다. 침묵은 기본값을 의미합니다. 피드백이 없는 비디오는 변경되지 않은 것으로 나열됩니다.
3. 피드백이 있는 각 비디오의 다음 버전 열기
"$PY" "$PVS_HOME/skills/video-review/scripts/bump_version.py" <video_dir> --note "<quote>" ...
lines.tsv, timings.json 및 video/src를 v으로 백업하고 BRIEF 버전을 N+1로 올리며 인용문과 함께 변경 로그 섹션을 엽니다. v이 한 번도 렌더링되지 않은 경우 거부합니다(버전을 건너뛰게 됨). v 렌더링은 그대로 유지됩니다. 패리티 참조이며, 리뷰어가 공유한 파일을 덮어쓰지 않습니다.
4. 비디오당 하나의 수정 서브 에이전트, 모두 동시에
각 비디오에 대해 references/fix-prompt.md를 채우고(리뷰어의 원문, 귀하의 의미 및 수용 기준, 코드에서 이미 찾은 내용(file:line), 공유 규칙) 모든 수정기를 동시에 Agent 도구로 백그라운드에서 실행합니다. 시작하기 전에 직접 간단히 코드 조회를 수행하여 "이미 찾은 내용"을 제공하십시오. 각 수정기가 동일한 검색을 수행하는 것을 방지하고 제품이 충족할 수 없는 피드백을 찾아냅니다.
실행 중에는 직접 수정하지 말고 메시지로 폴링하지 마십시오. 파일(stages.py, 수정 시간, 렌더링 로그)을 모니터링합니다. 수정기에 승인이 필요한 경우 사용자에게 하나의 폐쇄형 질문을 하고 답변을 전달합니다. 수정기가 중단되면 중단된 위치와 동일한 프롬프트로 새 수정기를 시작합니다. 상태는 파일에 있습니다.
5. 모든 결과를 직접 확인
수정기가 보고한 내용과 관계없이 각 비디오에 대해:
- 의도적으로 변경된 구간을 제외한 이전 버전과의 패리티:
"$PY" "$PVS_HOME/skills/render-qa/scripts/parity.py" <old mp4> <new mp4> --skip a:b .... 승인된 구간이 변경되면 회귀입니다. 다시 보냅니다. - QA:
"$PY" "$PVS_HOME/skills/render-qa/scripts/qa.py" <video_dir> <new mp4> --strip ...변경된 모든 비트에서 스트립을 사용합니다.render-qa를 읽는 방법을 참조하고, 시트와 스트립을 직접 확인합니다. - 표의 각 피드백에 대한 수용 기준 확인. 렌더링이 충족하지 못하는 피드백은 동일한 수정기로 다시 보냅니다(SendMessage: 문제, 시간 범위, "다른 것은 변경하지 마십시오").
- BRIEF.md의 변경 로그 섹션을 채웁니다.
6. 전달 및 라운드 종료
"$PY" "$PVS_HOME/skills/render-qa/scripts/deliver.py" <video_dir> <new mp4> --archive-previous
그런 다음 함께 라운드를 종료합니다. 규칙이 된 피드백은 kit/RULES.md에 추가되고(날짜 및 리뷰어의 원문 포함), 다음 빌드가 이를 상속받습니다. 더 이상 업데이트되지 않는 규칙 파일은 잘못된 것이 되며, 규칙은 모든 프롬프트에서 수동으로 반복됩니다. 리뷰어가 이전 버전을 이미 어딘가에 업로드한 경우, 어떤 파일을 다시 업로드해야 하는지 알려줍니다.
7. 보고
| 비디오 | 시작 버전 | 종료 버전 | 적용된 피드백 | 확인 위치 | 패리티 | QA | 전달된 버전 |
|---|
그런 다음: 변경되지 않은 비디오, kit/RULES.md에 추가된 규칙, 확인되지 않은 사항, 최대 세 개의 폐쇄형 결정. 사용자의 언어로, 간결하게, 표를 먼저 배치합니다.
참조
references/review-protocol.md: 통합 표를 채우기 전에 읽습니다.references/fix-prompt.md: 수정기를 실행하기 전에 읽습니다.