북토크 비디오 1:1 복제 파이프라인
벤치마크 채널의 비디오 포맷을 재사용 가능한 레시피로 분해한 후, 산업용 파이프라인(스토리보드 게이트 → 컷별 TTS 타임라인 → 렌더링 레이어 자막 → headless 프레임 렌더링)을 통해 동일 포맷의 오리지널 콘텐츠를 생산합니다. 복제하는 것은 포맷(구조/패키징/리듬/아트 스타일)이지, 콘텐츠가 아닙니다. 스크립트, 이미지, 내레이션은 모두 오리지널입니다.
본 스킬은 《생각에 관한 생각》(벤치마크 '향부혹', 109컷, 654.9초 완성 영상)으로 완전히 검증되었습니다.
시작 전 사용자에게 확인할 세 가지 사항
- 벤치마크 비디오: 로컬 파일 경로 또는 링크(抖音/Bilibili 등). 비디오 파일을 얻을 수 없으면 사용자에게 화면 녹화 또는 다운로드 후 프로젝트에 넣도록 요청
- 이번 주제 도서: 다룰 책(경영/인지/심리/비즈니스/성장 분야 최적)
- 브랜드명 + 페르소나명: 예: '지행연구소 / Mark'
단계 A · 프로젝트 초기화
PROJ=프로젝트 디렉토리(사용자 지정 또는 새로 생성)
mkdir -p $PROJ/{00_benchmark,01_script,02_storyboard,03_audio,04_subtitles,05_assets/images,07_hyperframes_production,08_publish,scripts}
cp <skill 디렉토리>/templates/{pipeline.py,create_storyboard.py,gen_audio_minimax.py,build_hyperframes_html.py,render_html_video.py} $PROJ/scripts/
cp <skill 디렉토리>/templates/.env.example $PROJ/.env # 사용자가 MINIMAX_API_KEY 입력
의존성: python3 + playwright(포함 chromium) + ffmpeg. 없으면 먼저 설치: pip install playwright && playwright install chromium.
단계 B · 레시피 분석 → 레시피 산출
references/benchmark-analysis.md 에 따라 벤치마크 비디오를 분석하여 00_benchmark/recipe.md(사양/리듬/구조/시각/오디오 5단계 레시피)를 산출합니다. 그런 다음 레시피를 템플릿에 주입:
| 레시피 항목 | 주입 위치 |
|---|---|
| 본문 아트 스타일 키워드 | create_storyboard.py의 STYLE_SUFFIX |
| 챕터 카드 배경/엔딩 카드 배경 설명 | 동일 CARD_BG_PROMPT / OUTRO_CARD_PROMPT |
| 강조 색상/제목 색상 CSS | build_hyperframes_html.py의 #ffde59(강조 노랑)/#e8c66a(제목 금) 등 |
기본 템플릿은 '미국식 복고 만화 + 블랙 골드 베이스' 레시피(벤치마크 '향부혹')를 포함하고 있습니다. 벤치마크가 이 경로를 사용한다면 주입을 건너뛸 수 있습니다.
단계 C · 스크립트 작성 (6단계 구조)
references/copywriting-template.md 에 따라 01_script/final.md를 작성합니다.
철칙: 모든 문장은 구체적인 이미지로 그려질 수 있어야 합니다 — 다음 단계의 커버리지 게이트는 스크립트에 문자 단위로 의존합니다. 동시에 create_storyboard.py 상단의 【매회 설정】을 업데이트합니다(SCRIPT_MD는 기본적으로 final.md와 BOOK_TITLE을 가리킴).
단계 D · 스토리보드 (게이트 ①)
스크립트를 문장 단위로 scripts/create_storyboard.py의 SHOTS 4-튜플(내레이션=원문 정확한 슬라이스, 비주얼=문자 그대로의 직역, card_id, overlay_text)에 채워 넣은 후:
python3 scripts/create_storyboard.py
커버리지 게이트를 통과하지 못하면 멈추고 수정해야 합니다. 절대 문제를 안고 다음 단계로 진행하지 않습니다. 산출물: 02_storyboard/prompts.tsv + nano_banana_prompts.md.
단계 E · 일괄 이미지 생성 (수동 단계)
nano_banana_prompts.md 전체를 사용자의 이미지 생성 도구(Gemini Antigravity / Nano Banana 또는 기타 도구)에 전달합니다. 지침 요점: 16:9, 파일명이 정확히 목록과 일치해야 함, 05_assets/images/에 배치, 기존 파일은 건너뜀. N개의 본문 이미지 + chapter_card_bg.png + outro_card.png를 생성해야 합니다. 이 단계는 단계 F와 병렬로 진행할 수 있습니다.
단계 F · 더빙 + 프레임 수준 타임라인
python3 scripts/gen_audio_minimax.py --limit 3 # 먼저 3컷 합성하여 사용자 음색 테스트
python3 scripts/gen_audio_minimax.py # 전체(18RPM 속도 제한, ~110컷 약 7분)
타임라인 = PCM 바이트 수로 시간 계산, 컷별로 정확하며 Whisper를 사용하지 않습니다. 단어 수정 시 해당 컷만 다시 합성(캐시 해시 사용).
단계 G · 렌더링 완성 (게이트 ② + 엔진)
python3 scripts/build_hyperframes_html.py # 일괄 검증: '전부 준비됨'일 때만 렌더링 허용
python3 scripts/render_html_video.py --start 0 --duration 6 --out /tmp/smoke_hook.mp4
python3 scripts/render_html_video.py --start <특정 챕터 카드 시점> --duration 6 --out /tmp/smoke_card.mp4
python3 scripts/render_html_video.py --start <엔딩 5초 전> --duration 6 --out /tmp/smoke_outro.mp4
# 세 구간 스모크 테스트 육안 검사 통과 후 전체 영상 (~110컷 ≈ 11분 영상, 렌더링 약 14분)
python3 scripts/render_html_video.py
렌더링이 중단되면 바로 다시 실행(중단점에서 재개). 렌더링 레이어는 먼저 브라우저에서 미리 볼 수 있음: open 07_hyperframes_production/index.html(스페이스바 재생, ←→ 각 5초).
단계 H · 검수 + 배포
검수 명령 목록, 프레임 추출 육안 검사 요점, 배포 자료 템플릿(제목 공식/태그/썸네일/고정 댓글)은 references/pipeline-guide.md 를 참조하고, 자료는 08_publish/에 기록합니다.
하드 규칙 (언제나 위반 금지)
- 게이트를 통과하지 못하면 다음 단계로 진행하지 않습니다: 커버리지 게이트(스크립트=내레이션), 일괄 검증(이미지가 모두 준비되었을 때만 렌더링)
- API 키는
.env에만 입력, 어떤 스크립트/문서/대화 산출물에도 하드코딩 금지 - 이미지에 글자를 그리지 않고, 모든 글자는 렌더링 레이어를 통해 처리 — 챕터 카드/데이터 카드/자막/브랜드는 모두 HTML로 오버레이되며, 책을 바꿀 때 이미지를 다시 그릴 필요가 없음
- 전체 영상 렌더링 전에 반드시 세 구간 스모크 테스트(훅/챕터 카드/엔딩)를 육안 검사 통과
- 이미지 생성 프롬프트에는 항상 고유 색상 스타일 접미사 + 화면비 16:9 + 배경에 텍스트/간판 금지 추가
실제 성능 기준 (사용자 기대치 조정)
스크립트 3601자 → 109컷 → 654.9초 완성 영상; TTS 7분; 렌더링 24프레임/초(전체 약 14분); 총 인력 작업 시간 ≈ 1일(스크립트가 절반 이상 차지).