마케팅 비디오
비디오는 하나의 HTML 페이지로, 모든 픽셀이 시간의 순수 함수 seek(t)에 의해 결정되며, 모션 블러와 밀리초 단위로 배치된 사운드트랙과 함께 프레임별로 렌더링됩니다. 브랜드에 특화된 모든 것은 입력(intake)에서 비롯되며, 어떤 것도 가정하지 않습니다. 사용자의 언어로 대화하세요. SKILL_DIR은 이 파일이 포함된 폴더입니다.
0. 첫 실행: 도구 확인
bash SKILL_DIR/scripts/check_deps.sh
이 명령은 현재 시스템에서 누락된 것(node 18+, ffmpeg, python3, numpy)을 찾아 해당 시스템에 맞는 설치 명령어를 함께 출력합니다. 누락된 것이 있으면 사용자에게 각 도구의 용도를 쉽게 설명하고, 명령어를 보여준 후 설치할지 한 번 물어보세요. '예'라는 답변을 받으면 설치를 진행하고, 확인 스크립트를 다시 실행하세요. 비밀번호가 필요하거나 자체 설치 프로그램(Homebrew, sudo)을 여는 명령어는 사용자가 자신의 터미널에서 직접 실행해야 합니다; 명령어를 알려주고 기다리세요. 한편으로는 입력 질문을 진행하세요: 도구에 의존하는 작업은 2단계까지 없습니다.
1. 입력: 먼저 모든 것을 물어보세요
references/intake.md의 질문을 한 번에 보내세요. 무엇이든 만들기 전에 다음이 필요합니다:
- 주제: 비디오가 무엇을 말하는지, 누구에게 전달하는지, 어디에 게시될지;
- 참고 비디오: 가장 유용한 단일 입력;
- 디자인 시스템, 또는 중립 기본값을 사용하겠다는 명시적 허가;
- UI 스크린샷: 비디오에 제품이 표시될 때마다.
모든 입력은 로컬 파일로 끝나야 합니다: 다운로드를 요청하거나, 도구가 허용할 때 직접 가져오세요. 다른 모든 항목에는 명시된 기본값이 있습니다. 한 번 알린 후에도 필수 항목이 여전히 누락되면, 그 항목에 의존하는 것은 아무것도 시작하지 마세요; 참고 비디오의 경우에만, 엔진의 자체 스타일(하나의 연속적인 변형 형태)을 제안하고 사용자가 수락할 때까지 기다리세요.
그런 다음 프로젝트를 생성하고 답변을 brief.md에 기록하세요:
bash SKILL_DIR/scripts/setup.sh ~/marketing-videos/<slug> # 템플릿, 스크립트, 로컬 Playwright
cd ~/marketing-videos/<slug> # 이후 모든 명령어는 여기서 실행
2. 참고 비디오 읽기 및 확인
python3 inspect_inspiration.py <video> # 콘택트 시트, 컷, 샷 길이, 음악 템포
두 시트를 모두 보고, 최대 열 줄의 스타일 분석을 작성하세요: 연속 변형 또는 컷, 비트당 이벤트 및 상태 지속 시간, 카메라 움직임, 이징, 팔레트, 타이포그래피, 사운드. 이를 보여주고 무엇을 유지할지 물어보세요. 사용자의 서면 지시(규칙, 금지 목록, 구조)는 분석 내용을 무효화합니다. 사용자가 음악을 제공했다면 지금 측정하고(python3 inspect_inspiration.py track.mp3), 그리드 전에 CONFIG.bpm을 해당 템포로 설정하세요.
3. 비트 그리드의 상태 목록, 그런 다음 대기
비트당 한 행씩 표 형태: 시간, 화면 상태, 움직임 방식, 커서 동작, 카메라. references/craft.md에 규칙이 있습니다. 사용자가 승인할 때까지 아무것도 만들지 마세요. 여기서 반복하는 데는 1분이 걸리지만, 빌드 후에는 1시간이 걸립니다.
4. 빌드
scene.html을 편집하세요: CONFIG(템포, 마디, 루프 또는 종료 카드, 토큰, 폰트)를 설정하고 예제 장면을 교체합니다. references/craft.md를 먼저 읽으세요: 엔진, 모션 규칙 및 주의사항이 설명되어 있습니다.
- 폰트: 브랜드의 파일을
fonts/에 넣고(Google Fonts는 woff2로 다운로드)fonts.json에 나열하세요;CONFIG.font는 그 패밀리 중 하나를 먼저 지정합니다.python3 build.py가 이를 인라인으로 포함시킵니다. - 로고: 브랜드의 SVG를 그대로 붙여넣으세요. 워드마크를 폰트로 다시 입력하지 마세요.
- 스크린샷은 HTML로 단순화된 재현을 위한 참조이며, 이미지로 붙여넣지 않습니다.
- 실사 영상:
python3 frames.py --src clip.mp4 --name <who> --sheet로 깨끗한 창을 선택한 다음, 프레임의 종횡비에 맞게 크롭하여 추출합니다. 영상은 5단계에서 사운드가 믹싱되지 않으면 무음으로 재생됩니다.
5. 검증, 그런 다음 사운드
python3 build.py && node preview.mjs # 포맷별 콘택트 시트, 비트당 한 프레임, 콘솔 및 폰트 오류
node checks.mjs # 버튼 내부 클릭, 포인터가 읽힌 텍스트 위에 없음
둘 다 기본적으로 1440x1440 및 1080x1920으로 설정되며, 다른 크기는 1920x1080 형식으로 전달하세요. 모든 시트를 읽고 그리드에서 벗어난 부분, 비좁은 부분, 휴대폰 크기에서 읽기 어려운 부분, 또는 도착해야 할 때 전환 중인 부분을 수정하세요. checks.mjs는 모든 포맷에서 통과해야 합니다; 각각의 새 클릭과 보호할 텍스트를 window.CHECKS에 선언하세요.
python3 audio.py는 장면의 템포에 맞춰 배경음을 합성하고 각 window.CUES 사운드를 측정된 피크에 배치합니다. --music track.mp3 --offset <s>는 사용자의 트랙을 사용하고, --voice clip.mp4:at:start:dur는 촬영된 사람의 음성을 믹싱하고 그 아래 음악을 낮춥니다.
6. 렌더링 및 전달
node render.mjs scene.built.html 1440 1440 out/<slug>-v1-1x1.mp4 audio/bed.wav
node render.mjs scene.built.html 1080 1920 out/<slug>-v1-9x16.mp4 audio/bed.wav
각 전달 버전은 새 파일 이름을 얻고, 소스는 전달 시 versions/v<N>/에 복사됩니다. 새 렌더링이 완료될 때까지 전달된 파일을 덮어쓰지 마세요. MP4를 사용자가 원하는 위치에 복사하고, 변경된 사항, 통과한 검사, 사용자를 대신하여 내린 판단 결정을 보고하세요.
7. 반복
craft.md#iterating을 따르세요: 명명된 것만 변경하고, 재안무보다는 시간을 늘리며, 모든 변경 후에 preview.mjs와 checks.mjs를 다시 실행하세요.
요구 사항
폴더는 자체 포함되어 있습니다. 스크립트는 node 18+, ffmpeg 및 python3(와 numpy)가 필요하며(0단계에서 누락된 것을 찾아 설치), setup.sh는 각 프로젝트에 Playwright의 Chromium을 추가합니다. 프로젝트가 자체 규칙을 가진 저장소에 있는 경우 해당 규칙을 따르고, 렌더링, 영상, 프레임 및 node_modules는 버전 관리에서 제외하세요.