Communitygithub.com

런치 필름

에이전트가 '런치 필름'을 기획, 제작 또는 편집하여 최종 결과물로 랜딩 페이지, 홈페이지 또는 포트폴리오를 출력하는 방법을 안내합니다. 절차는 런치 필름, 0. 먼저 사실 확인 — 비디오가 주장할 수 있는 내용, 1. 대본 순서로 진행됩니다. 새로운 과제가 이 작업을 요구할 때 사용하세요.

런치 필름란 무엇인가요?

이 스킬은 제품 출시를 위한 홍보 영상(런치 필름)을 전체적으로 제작하는 파이프라인을 에이전트에게 제공합니다. 제품 사실과 음성 해설을 입력으로 받아 완성된 MP4 파일을 출력하며, 모든 프레임은 순수 함수 `renderFrame(t)`로 정의되어 스틸 이미지, 미리보기, 최종 렌더링 간의 일관성을 보장합니다. Node 20+, ffmpeg/ffprobe, Chromium(Playwright의 headless-shell 자동 감지)만 있으면 npm 의존성 없이 모든 스크립트를 실행할 수 있습니다. 주요 단계로는 사실 확인(제품의 실제 기능과 사용자 용어 기반), 대본 작성(script.json), 음성 녹음 및 정렬(VoiceStudio MCP 또는 ElevenLabs), 에셋 수집 및 UI 스크린샷 촬영, canvas 기반 영상 제작(film.js), 오디오 합성 및 최종 렌더링이 포함됩니다. 모든 자막과 장면 전환은 측정된 단어 테이블(words.json)로 제어되며, 브랜드 위생 규칙(타사 로고 사용 금지 등)을 엄격히 준수합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hieunguyen24041998-dotcom/launch-film-skill/tree/HEAD/launch-film

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

런치 필름은(는) 무엇을 하나요?

제품 사실 + 음성 해설을 완성된 MP4로 바꾸는 파이프라인입니다. 모든 프레임은 시간의 순수 함수(film/film.js의 renderFrame(t))이므로 스틸, 미리보기 및 최종 렌더링이 항상 일치하며, 모든 캡션/컷은 측정된 단어 테이블로 구동됩니다.

스크립트는 이 파일 옆에 있는 scripts/ 디렉토리에 있으며(로 호출), npm 의존성이 없습니다: Node 20+, PATH에 ffmpeg/ffprobe, 그리고 Chromium이 필요합니다(Playwright의 chromium-headless-shell은 자동으로 찾으며, 그렇지 않으면 CHROME=을 설정하세요). 새 프로젝트 폴더(예: ~/<product>-launch/)에서 작업하고 모든 스크립트를 그 폴더 안에서 실행하세요.

0. 먼저 사실 확인 — 비디오가 주장할 수 있는 내용

한 글자도 쓰기 전에 실제 제품을 읽으세요: 랜딩 페이지, 문서/README, UI 소스, 기존 소개 영상(ffmpeg로 프레임 캡처). 대본의 기능과 장면의 UI는 제품이 실제로 하는 일이어야 하며, 사용자가 사용하는 단어로 작성되어야 합니다. 청중이 중요합니다: 매장 주인/비기술적 구매자라면 짧고 일상적인 문장을 사용하고 전문 용어는 피하세요.

어렵게 배운 브랜드 위생:

  • 제품 이름에 타사 브랜드(예: Zalo/Shopee/Notion 대상 도구)가 포함되어 있고 공식 제휴가 아닌 경우, 해당 브랜드의 로고나 시그니처 색상을 사용하지 말고 이름을 텍스트로 표기하세요.
  • 소스 폴더는 종종 이전 클라이언트 프로젝트의 포크입니다. 스크린샷/UI 문자열에서 남아 있는 클라이언트 이름(회사명, 로고, 샘플 데이터)을 grep으로 찾아내어 영화에서 제외하세요. 확실하지 않으면 사용자에게 물어보세요.
  • 사용자가 제공하지 않는 한 실제 회사의 공식 로고를 다시 그리지 마세요. 소개 영상에 표시된 제품 자체 로고는 재현할 수 있지만, 그 사실을 알리고 원본 파일로 교체할 것을 제안하세요.
  • 화면에 표시되는 샘플 이름, 가격 및 채팅은 예시임을 사용자에게 알리세요.

1. 대본

기본 형태(상황에 맞게 조정; 길이는 내용에 따르며, 약 9–12개의 짧은 줄):

이것은 [이름]입니다. [카테고리]… [가치]를 위해 만들어졌습니다. 어떤 [것]에서든 [동사]하세요! ← 드롭 · [입력]을 주면, 그냥… 이해합니다. · 더 많이 사용할수록, 더 좋아집니다. · [3가지 설정/기능, 각각 짧은 줄] · 모든 [출력물], 정확히 상상한 그대로. · [이름]. 지금 출시되었습니다.

  • 강조는 한 단어만(그라데이션 + 광택). 브랜드 색상 이름은 추가로 괜찮습니다.
  • 모든 주요 기능(사용자 요청)을 다루려면 각 기능에 자체 짧은 줄을 할당하고 영화를 22초 대신 약 27~30초로 실행하세요.
  • script.json 작성(templates/script.example.json 참조): lines[] → units[]를 쉼표/문장 끝에서 분할하고 각각에 end: ","|"."를 지정합니다. 줄은 캡션과 장면이 키로 사용하는 대상입니다. extraBefore(초)는 줄 앞에 여유 시간을 추가합니다(로고 모음 전에 사용).

2. 음성

선호: VoiceStudio MCP가 연결되어 있으면 사용(list_voices, generate_speech with profile_id, language, steps: 32). 그렇지 않으면 사용자 키로 ElevenLabs를 HTTPS로 사용합니다. 전체 대본의 4개 테이크를 생성하여 voice/에 읽을 수 있는 이름으로 복사하고, 각각을 측정합니다(ffmpeg -af silencedetect=noise=-38dB:d=0.12): 길이, 가장 긴 일시 중지, 피크. 표를 제시하고 사용자가 선택하도록 하세요; 사용자가 선택하지 않으면 가장 유창한 테이크(일시 중지가 가장 적음/짧음)를 선택하고 그렇게 말하세요.

참고: VoiceStudio의 instruct는 음성 디자인 속성 문자열("female, young adult, american accent")이며 감정 태그가 아닙니다 — 감정은 구두점과 음성 자체에서 나옵니다. ASR이 활성화되지 않은 경우 transcribe가 409를 반환할 수 있습니다; 아래 정렬기는 ASR이 필요하지 않습니다.

그런 다음 선택한 테이크를 정렬하고 정리합니다:

node <skill>/scripts/voice_align.mjs voice/take.wav script.json build/voice.wav build/words.json 0.9

≥100 ms 일시 중지에서 음성을 분할하고, 동적 프로그래밍으로 세그먼트를 대본 단위에 정렬하고(쉼표는 일시 중지되거나 되지 않음), 0.28초 초과 일시 중지를 0.2초로 자르고, 각 줄을 중앙값 쪽으로 85% 레벨링(게인은 일시 중지 내에서만 이동), words.json(phrases[], words[] with t0/t1)을 작성합니다. 인쇄된 정렬 테이블이 합리적인지 확인하세요(각 단위가 그럴듯한 오디오에 있음). 구문 내 단어 시간은 음절 비례이며 포락선 딥에 스냅됩니다 — 타이핑 캡션에 적합합니다; 사용자가 단어별 ASR 정밀도를 기대하는 경우 그렇게 말하세요.

3. 에셋

node <skill>/scripts/assets.mjs fonts            # Be Vietnam Pro(모든 베트남어 발음 구별 부호) + Geist Mono
node <skill>/scripts/assets.mjs pool 2 11        # 약 1000개의 무료 썸네일 + 선택할 수 있는 접촉 시트
node <skill>/scripts/assets.mjs get <id> <id>…   # 선택한 사진을 640²로
node <skill>/scripts/shoot-ui.mjs <product>/public ref/ui index.html other.html   # 읽기 전용 UI 스크린샷(백엔드 없음)

시트(.jpg 읽기)를 보고 제품 세계에 맞는 이미지를 선택하세요; 무료 스톡은 주로 풍경이므로 스톡이 맞지 않으면 제품 시각 자료를 절차적으로 그리세요(템플릿은 평평한 티셔츠, 채팅 카드, 파일 카드, 코드 카드를 그립니다). 실제 UI는 스크린샷/소스에서 캔버스에 다시 그려집니다 — 동일한 레이아웃, 색상(CSS 변수 읽기), 레이블 및 샘플 흐름 — 붙여넣은 스크린샷이 아닙니다.

4. 영화

templates/film/을 프로젝트에 film/으로 복사하고, 단어 테이블을 내보낸 다음 film.js를 조정하세요:

node -e "const j=require('./build/words.json');require('fs').writeFileSync('film/words.js','window.WORDS='+JSON.stringify(j)+';')"

편집 전에 references/film-template.md를 읽으세요 — 모든 장면, 헬퍼(typeWords, glass, tile, aura, cam, push), 타이밍 변수, 사운드 이벤트 테이블 및 META.runs를 매핑합니다. 스타일이 작동하게 만드는 규칙을 유지하세요:

  • 장면 시작은 구문 시작(B[])에 위치하고, 크로스 페이드는 이를 걸쳐 있습니다(±0.18 초). 장면당 카메라 푸시 1.00→1.04; 콘텐츠가 다음 장면으로 이어질 때, 해당 장면을 이전 장면이 끝난 줌에서 시작하세요.
  • 아무것도 갑자기 나타나지 않음: ≥0.3초의 완화된 페이드. 유일한 하드 컷은 16분 음표 실행(이미지 플래시, 카드 스왑, 시드 롤)이며, 드롭에 고정된 그리드에 정렬됩니다.
  • 화면에 마침표 없음. 선택 상자 강조, 흰색 플래시, 슬램, 3D 없음.
  • 유리 뒤에 무언가(오라 또는 흐릿한 사진 워시)가 필요하지 않으면 사라집니다.

5. 전체 렌더링 전에 스틸 확인

node <skill>/scripts/render.mjs events build/events.json          # 또한 페이지가 부팅됨을 증명
SUB=1 node <skill>/scripts/render.mjs stills build/stills 1.7 3.9 6.4 7.6 …   # 장면당 하나 + 주요 순간
node <skill>/scripts/finish.mjs sheet build/stills build/contact.jpg

접촉 시트를 직접 읽고 사용자에게 보여주기 전에 보이는 문제를 수정하세요: 칩/레이블이 명명하는 카드와 동기화되지 않음, 배지 중복, 유리 아래 텍스트 실행, 주제에서 벗어난 이미지로 시퀀스 종료, 프레임 가장자리에 의해 잘린 캡션, 번역되지 않았거나 남아 있는 문자열. SUB=8로 영향을 받는 스틸을 다시 렌더링하여 모션 블러가 올바르게 보이는지 확인하세요. 사용자가 스틸 승인을 요청한 경우 약 8개의 스틸(경로 + 각 스틸이 보여주는 내용)을 보여주세요; 그렇지 않으면 진행하세요.

6. 사운드, 렌더링, 확인

node <skill>/scripts/finish.mjs audio                 # 음악+SFX 합성, 3밴드 덕, 구문당 중간 트림 약 +9 dB, loudnorm -14 LUFS
node <skill>/scripts/finish.mjs video <name>.mp4 3    # 약 1초/프레임/워커; 백그라운드에서 실행

audio.mjs는 드롭(META.D)에 고정된 바 그리드가 있는 130 BPM 배경과 이벤트당 하나의 SFX(입력된 문자당 키, 이미지 변경당 클릭, 우슈, 드롭/로고로의 라이저, 임팩트, 강조 단어의 부드러운 착지)를 합성하므로 아무것도 다운로드할 필요가 없습니다. 사용자가 트랙을 제공하면 대신 믹싱하고 동사 줄에 드롭을 유지하세요. 인쇄된 음성 오버 음악 표를 정직하게 보고하세요: 드롭 후 줄은 약 +9dB에 위치해야 하며; 드문 인트로/아웃트로 줄은 의도적으로 더 높습니다.

finish.mjs video는 병렬로 렌더링하고, AAC 320k를 먹스하며, META.runs 외부에서 단일 프레임 팝을 위해 프레임 차이를 스캔하고, 크기/fps/음량을 출력합니다. 그런 다음 최종 MP4에서 몇 프레임을 추출하여 보고하기 전에 살펴보세요.

7. 보고

MP4 경로, 사양, 각 장면이 보여주는 내용, 검사 결과(팝, LUFS/피크, 음성 오버 음악), 그리고 예시 또는 다시 그려진 내용(로고, 샘플 데이터, 절차적 제품 샷, 합성 음악)을 설명하고, 실제 에셋으로 교체할 수 있는 한 줄 제안을 포함하세요. 사용자에게 그들의 언어와 평이한 단어로 작성하세요.

주의사항

  • Windows의 셸 도구: 프로세스 대체 대신 ffmpeg -f concat 목록을 사용하고; 긴 백그라운드 렌더링의 경우 동일한 명령 내에서 cd를 설정하세요.
  • canvas.letterSpacing 및 ctx.filter는 최신 Chromium이 필요합니다 — 번들된 파인더는 최신 Playwright 빌드를 선택합니다.
  • 글꼴: Geist는 일부 베트남어 문자 모양이 부족합니다; 베트남어 텍스트에는 Be Vietnam Pro를 사용하세요.
  • 모션 블러는 하드 16분 컷을 걸치며 하나의 혼합 프레임을 보여줍니다 — 이는 예상된 것이며, 해당 범위는 META.runs에 속합니다.

관련 스킬