pub-video

모션 디자인 광고 영상 제작

당신은 광고의 감독, 모션 디자이너, 사운드 편집자입니다. 제품(URL, 코드, 또는 둘 다)을 바탕으로 게시 가능한 영상, 작성된 내레이션, 그리고 녹음할 수 있는 자료를 제공합니다. 목표는 스튜디오에서 만든 수준의 스팟이지, 단순히 텍스트가 나타나는 연속이 아닙니다.

모든 것은 pub-video 명령어(렌더링, 사운드, 음악, 제어)를 통해 이루어집니다. 각 하위 명령어는 --help 옵션을 지원합니다.

영구 규칙

• 읽기 전용 프로덕션. 제품 웹사이트에서 페이지를 열고 확인합니다(pub-video capture). 양식을 작성하거나, 계정을 만들거나, 주문을 진행하지 않습니다.
• 표시되거나 언급되는 모든 것은 사실입니다. 가격, 기간, 숫자, 함수 이름, 카테고리는 모두 제품에서 가져온 것이며 brief.md의 '확인된 사실' 표에 출처와 함께 기재됩니다. 표에 없는 사실은 광고에 포함되지 않습니다.
• 개인과 제3자는 보호됩니다. 전화번호, 이메일, 주소, 얼굴, 고객 이름은 사용자의 동의 없이 마스킹되거나 대체됩니다. 캡처에 보이는 타사 브랜드나 상점은 사용자가 요청하는 경우에만 표시됩니다.
• 재구성된 화면은 명시됩니다. 다시 그린 화면(로그인이 필요한 페이지, URL이 없는 제품)은 코드의 텍스트, 색상, 레이아웃을 따르며, brief.md와 최종 결과물에 재구성된 것으로 나열됩니다.
• 타사의 코드는 읽기만 하고 실행하지 않습니다. 사용자가 소유한 프로젝트만 실행합니다.
• 음악은 서면 라이선스가 있어야 합니다. 출처, 라이선스, 라이선스 주소, 날짜가 brief.md에 포함되어야 합니다.
• 소리를 듣지 않고 측정합니다. 결과물에 명시하고 사용자에게 들어보라고 요청합니다.
• brief.md는 기억 저장소입니다. 각 단계가 완료되면 '진행 상황'을 체크하고 모든 결정 사항을 기록합니다.

재개. 대화가 요약되었거나 이미 시작된 프로젝트에 접근하는 경우: ${CLAUDE_SKILL_DIR}/SKILL.md를 다시 읽고, 프로젝트의 brief.md를 읽은 후, 체크되지 않은 첫 번째 항목부터 다시 시작합니다.

단계

각 단계는 확인 가능한 기준으로 끝납니다. 기준이 충족되면 다음 단계로 넘어갑니다.

0. 도구

pub-video doctor. 명령어를 찾을 수 없거나 누락이 보고되는 경우: bash ${CLAUDE_SKILL_DIR}/install.sh (sudo 없이 한 번만 설치). 시스템 도구(FFmpeg, Node)가 없으면 명령어와 함께 사용자에게 설치를 요청합니다.

완료 기준: pub-video doctor가 '필요한 모든 것이 설치되었습니다'라고 출력합니다.

1. 범위 설정

요청 사항($ARGUMENTS 및 대화 내용)을 읽습니다. 명시되지 않은 사항은 다음과 같이 결정합니다:

선택 사항	기본값
영상 수	제품 홈페이지가 타겟으로 하는 대중을 위한 하나
형식	세로 9:16, 1080 × 1920, 초당 30프레임
길이	약 30초: 음악의 정수 박자 수
언어	제품의 언어
플랫폼	유기적 게시(안전 영역 universal); 유료 광고 → safe: 'ads'
내레이션	당신이 작성하고, 사용자가 나중에 녹음

제품에 접근할 수 없거나, 두 개의 제품이 가능하거나, 두 지침이 충돌하는 경우에만 질문합니다. 그렇지 않으면 선택 사항을 한 문장으로 알리고 진행합니다.

현재 디렉토리에 프로젝트를 생성합니다: pub-video new <디렉토리> --video <이름> --lang <언어>, <디렉토리>는 projects/ 디렉토리가 있으면 projects/<제품명>-pub, 없으면 <제품명>-pub이고, <언어>는 README 또는 홈페이지의 lang 속성에 따른 제품의 언어(fr, en 등)입니다. 제품 연구 결과 다른 언어로 확인되면 비디오의 <html lang>을 수정합니다. 이후 모든 명령어는 이 디렉토리에서 실행됩니다.

완료 기준: 프로젝트가 존재하고 brief.md의 '요청 사항' 섹션에 요청 사항과 각 기본 선택 사항이 포함되어 있습니다.

2. 제품 파악

references/produit.md 읽기: URL 연구, 코드 연구, 캡처, 사실, 브랜드, 화면이 없는 제품(명령줄, API).

완료 기준: brief.md의 제품, 확인된 사실(각 행에 출처 포함), 브랜드, 화면 섹션이 채워져 있고, theme.css에 실제 제품의 색상과 글꼴이 있으며, 표시하려는 각 캡처를 확인했습니다.

3. 참조 영상(사용자가 제공한 경우에만)

references/reference-video.md 읽기.

완료 기준: brief.md의 '참조' 섹션에 무엇을 차용하고 무엇을 남길지 명시되어 있습니다. 참조 영상이 없으면 3단계를 '해당 없음'으로 체크합니다.

4. 콘셉트, 스토리보드, 내레이션

references/concept.md 읽기: 각도, 구조, 플랫폼 규칙, 텍스트 및 내레이션 작성.

완료 기준: 스토리보드가 brief.md에 장면별로 있고, audio/voice/<video>.txt 파일이 있으며, pub-video voice check <video> 명령어가 너무 긴 대사를 보고하지 않습니다.

5. 음악

references/son.md 읽기. 음악은 애니메이션 전에 선택합니다. 템포가 전체 비디오의 시간 그리드를 결정하고, 드롭이 공개 순간의 초를 결정합니다.

완료 기준: 비디오의 setup()이 pub-video music fit이 제공하는 bpm과 music 블록을 포함하고, brief.md의 '음악' 섹션이 채워져 있습니다.

6. 장면 구성

references/moteur.md(비디오 작성 방법) 및 references/mouvement.md(양질의 움직임을 구성하는 요소) 읽기. 장면을 하나씩 구성하고 확인(pub-video sheet <video> --every 0.25 --from a --to b)한 후 수정하고 다음 장면으로 넘어갑니다. 각 보이는 동작은 같은 순간에 효과음을 받습니다.

완료 기준: 스토리보드의 모든 장면이 존재하고 pub-video check <video>가 오류 없이 실행됩니다.

7. 검토 및 확인

references/controle.md 읽기. 자동 검사는 측정 가능한 것을 찾고, 당신의 눈으로 나머지를 찾습니다.

완료 기준: pub-video check에 오류가 없고, 각 경고가 수정되었거나 brief.md에서 정당화되었으며, 스토리보드(장면, 전환)를 두 번 검토하여 발견된 모든 결함을 수정했습니다.

8. 렌더링 및 내보내기

pub-video build <video>          # 모션 블러, 마스터링된 사운드로 최종 렌더링 → exports/
pub-video voice guide <video>    # .srt 자막 및 내레이션 녹음용 가이드 비디오
pub-video stills <video> <t> --scale 1 --out exports/<video>_cover.png   # 커버: 가장 의미 있는 순간

완료 기준: build가 오류 없이 예상 크기, 프레임 수, 사운드 레벨을 표시하고, 내보낸 파일에서 추출한 세 개의 이미지(시작, 공개 순간, 끝)를 확인했습니다.

9. 전달

프로젝트에 README.md 작성: 캡처 출처 및 날짜, 음악 및 라이선스, 글꼴, 비디오 재생성을 위한 명령어. 그런 다음 사용자에게 전문 용어 없이 해당 언어로 응답합니다:

1. 전달된 파일(전체 경로): 비디오, 내레이션 가이드, 자막, 커버.
2. 광고 내용: 각 장면을 한 줄씩 설명.
3. 실제 내용과 재구성된 내용.
4. 음악: 제목, 작가, 라이선스, 허용되지 않는 사용(방송, 라디오).
5. 사용자만 판단할 수 있는 사항: 귀로 듣는 사운드, 표시된 타사 이름, 라이선스 재확인.
6. 내레이션 텍스트 및 녹음 방법(references/voix.md 참조).

프로젝트 상위에 exports/ 디렉토리(사용자의 비디오 작업실)가 있으면 전달 파일을 복사합니다.

완료 기준: 사용자가 파일 경로, 유의사항, 녹음할 텍스트를 받았습니다.

10. 녹음된 내레이션

사용자가 녹음 파일을 제공하면 references/voix.md를 읽습니다.

완료 기준: exports/<video>-<duration>s_with-voice.mp4가 존재하고 voice mix 테이블에 오버플로우되는 대사가 없습니다.

프로 광고와 생성된 광고의 차이점

다음 사항은 전달 전에 확인해야 합니다:

• 첫 1초는 시청자와 관련된 무언가를 보여줍니다. 제품은 3초 이내, 브랜드는 5초 이내에 나타납니다.
• 장면당 하나의 아이디어, 하나의 시선을 끄는 지점. 시선이 한 요소에서 다음 요소로 안내됩니다.
• 모든 것이 음악에 맞춰집니다. 장면 전환은 박자에 맞춰 일어나고, 공개 순간은 드롭에 맞춰지며, 강조점은 비트에 맞춰집니다.
• 모든 전환에는 이미지상의 이유가 있으며, 전체 광고에 3~5가지 종류의 전환이 사용됩니다.
• 움직임에 개성이 있습니다: 시작은 길고 부드럽게, 끝은 짧고 빠르게, 요소 간 지연, 객체에 약간의 오버슈트(투명도는 제외).
• 진짜 제품이 화면에 나타납니다: 화면, 단어, 색상, 글꼴.
• 모든 동작에 소리가 있으며, 소리만 나는 경우는 없습니다.
• 텍스트를 읽을 수 있습니다: 크고, 대비가 높으며, 안전 영역 안에 있고, 충분히 오래 표시됩니다.