/video-new
아무것도 만들기 전에, 비디오가 무엇을 설명해야 하고 무엇을 주장할 수 있는지 기록하고, 검토자가 두 가지에 모두 서명하도록 하세요. 그런 다음 중단합니다.
이 스킬이 존재하는 이유: 이 스킬이 비롯된 프로덕션에서는 26개 버전 중 9개가 비디오가 검토자가 중요하게 생각하는 기능을 설명하지 못했기 때문에 발생했습니다. 아무도 빌드 전에 해당 기능들을 기록하지 않았고, 각각은 리뷰에서 표면화되어 전체 렌더링 및 QA 사이클 비용이 발생했으며, 다른 모든 비디오에 수동으로 적용해야 했습니다. 포지셔닝과 클레임도 같은 방식으로 3개의 버전을 더 소모했습니다. 사전에 서명된 두 장의 시트는 그러한 라운드 비용보다 저렴합니다.
시작하기 전에
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
제품을 찾으세요: 현재 디렉토리 위에서 product.yaml이 있는 가장 가까운 폴더입니다. 없으면 사용자에게 먼저 /product-new를 실행하라고 알리세요 (사용자가 직접 호출해야 하므로 대신 실행할 수 없습니다). product.yaml, kit/RULES.md 및 videos/에 있는 모든 형제 비디오의 BRIEF를 읽으세요: 형제의 커버리지 매트릭스와 클레임이 가장 좋은 시작점이며, 캐스트는 모든 비디오에서 동일하게 유지되어야 합니다.
비디오 ID는 인수에서 가져옵니다 (소문자, 숫자, 대시). videos/<video>/가 이미 존재하면 중단하세요: 기존 비디오는 처음부터 다시 시작하는 것이 아니라 /video-review로 진행합니다.
1. 비디오의 용도 묻기
하나의 메시지에 최대 네 개의 질문을 하며, 각각 제안된 기본값을 제공합니다:
- 누가 시청하고 어디에 게시되는지 (피치 데크, 짧은 제품 둘러보기, 문서 페이지, 온보딩, 랜딩 루프).
- 시청자가 보고 나서 무엇을 믿거나 할 수 있어야 하는지 (한 문장).
- 대략적인 길이 (기본값: 피치 90초, 둘러보기 30초, 문서 120초, 튜토리얼 240초, 루프 15초). 둘러보기는 하나 또는 두 개의 기능으로 축소된 피치입니다: 같은 오프닝, 엔드 스크린 및 잠금, 더 적은 챕터. 검토자가 "빠른 둘러보기"를 요청하거나 45초 미만을 요청할 때 선택하세요.
- 검토자에게 가장 중요한 기능. 이름으로 물어보고, 그중 어떤 것이 언급되는 대신 실제로 작동하는 모습을 보여줘야 하는지 물어보세요.
2. 폴더 생성
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/video-new/scripts/new_video.py" <product_dir> <video> \
--format <format> [--title "<title>"] [--duration <s>]
_template/video를 복사하고 BRIEF 프론트매터 (제목, 비디오, 형식, 기간, 언어 및 product.yaml의 검토자, 버전 1)를 채우며 두 서명은 비워둡니다. 중복 ID는 거부합니다.
3. 세 개의 시트 작성
작성 전에 각 시트의 형식과 작업된 예제 행에 대해 references/sheets.md를 읽으세요.
- BRIEF.md: 의도 (사용자의 자신의 말을 인용), 대상 청중, 제안된 챕터, 비디오에서 사용할 모든 가상 이름과 숫자에 대한 노트 (제품 캐스트에서 가져오며, 묻지 않고 새로운 것을 사용하지 않음), 그리고 v1을 위한 빈 변경 로그 항목.
- COVERAGE.md: 기능당 한 행으로 "화면에서 설명해야 하는가? 예/아니오", 해당 기능을 설명하는 챕터, 증거 (시청자가 보는 동작). 엔드 스크린에만 이름이 언급된 기능은 다루지 않은 것입니다: 이것이 정확히 가장 많은 버전을 소모한 격차입니다. 구성 가능한 부분 (설정, 트리거 (예약된 트리거 포함), 핸드오버, 후속 작업)을 포함하세요. 검토자들이 사후에 계속 요청했던 기능들이기 때문입니다.
- CLAIMS.md: 포지셔닝 라인 (
product.yaml에서 가져오며, 마케팅 문서에서 가져오지 않음), 피해야 할 구문 (never_say및 사용자가 추가한 모든 것), 승인이 필요한 모든 내레이션 주장, 승인된 태그라인, 그리고 레거시 문자열에 대응하는 표준 제품 이름.
모든 클레임과 기능을 sources/와 문서에서 볼 수 있는 내용과 대조 확인하세요. 제품이 사용자가 요청한 것을 수행하지 않으면, 폐쇄형 질문과 권장 옵션으로 말하세요 ("존재하는 것만 보여주기"가 일반적으로 올바른 기본값입니다). 코드가 뒷받침할 수 없는 기능을 매트릭스에 초안으로 작성하지 마세요.
4. 챕터 제안
챕터 테이블을 BRIEF.md에 추가하세요. 챕터당 하나의 아이디어, 챕터당 하나의 프레이밍, 모든 "반드시 설명해야 하는" 기능을 챕터에 매핑하세요. 컨텍스트 (제품 이름과 제품이 무엇인지 한 줄)로 열고, UI 중간에서 시작하지 마세요. 기본적으로 전체 페이지를 1x로 프레임하세요; 심층 확대는 원래 프로덕션에서 두 번 거부되었습니다. 제품이 할 수 있는 다른 기능 (너비)으로 끝낸 후 잠금으로 마무리하세요.
5. 중단하고 서명 요청
사용자에게 하나의 메시지로 다음을 보여주세요:
- 커버리지 매트릭스 ("예" 행)와 챕터 테이블.
- 포지셔닝 라인, 승인이 필요한 클레임, 제안된 태그라인.
- 최대 세 개의 폐쇄형 결정. 각각 기본값 포함 (예: 태그라인, 캐스트 이름, 기능 제외). 침묵이 의미하는 바를 말하세요: 기본값.
그런 다음 검토자에게 서명을 요청하세요. 검토자가 직접 BRIEF.md에 coverage_signed_by와 claims_signed_by에 이름을 쓰거나, 자신의 이름으로 서명하라고 자신의 말로 지시하면 다음을 실행하세요:
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/video-new/scripts/sign.py" <video_dir> \
--coverage "<reviewer name>" --claims "<reviewer name>"
자신의 주도로 서명하지 마세요. 시트가 "완전해 보인다"고 서명하지 마세요. 검토자가 제공하지 않은 이름으로 서명하지 마세요. 서명은 매트릭스가 검토자가 비디오를 평가할 기준이라는 검토자의 진술입니다. sign.py는 빈 매트릭스나 누락된 포지셔닝 라인을 거부합니다. 플래그 없이 실행하면 상태만 표시합니다.
사용자가 같은 메시지에서 서명하더라도 여기서 빌드, 렌더링, 내레이션 녹음 또는 하위 에이전트 파견을 수행하지 마세요. 빌드는 사용자가 입력하는 /video-build입니다. 이 분리는 에이전트가 서명되지 않은 브리핑으로 값비싼 빌드를 시작하는 것을 방지합니다.
보고
| 항목 | 값 |
|---|---|
| 비디오 | videos/<video>/, 형식, 대상 길이 |
| 커버리지 | 화면에서 설명할 N개 기능, 나열만 된 M개, 챕터 |
| 클레임 | 포지셔닝, 승인 대기 중인 클레임 |
| 결정 | 최대 세 개의 폐쇄형 질문과 기본값 |
| 서명 | 미서명 (또는 서명한 사람) |
다음, 서명 후: /video-build <video>.
이 문서는 원본 SKILL.md를 기반으로 한국어로 번역 및 현지화되었습니다.