유니버설 듀얼 엔진 비디오 디렉터 & 제너레이터 (v4.0)
Remotion 기반의 프로덕션 등급 자동 비디오 생성 스킬로, 9:16 세로형 쇼트폼 비디오(YouTube Shorts, TikTok, Instagram Reels, Facebook Ads)를 제작합니다. 두 가지 독립적인 시각 엔진을 단일 통합 프로젝트로 제공합니다.
┌────────────────────────┐
│ 사용자 스크립트/오디오 │
└───────────┬────────────┘
│
┌───────────────────────┴───────────────────────┐
▼ ▼
[ 모드 1: 캐릭터 스토리 ] [ 모드 2: 키네틱 프로모 ]
- 절차적 2D 플랫 캐릭터 - 2D 플랫 키네틱 모션 그래픽
- 대화 및 생각 말풍선 - 고정 브랜드 헤더 및 워터마크
- 100% 풀스크린 방 및 포즈 - 도트 그리드 떠다니는 캔버스
- 선택적 자막 (중복 없음) - 어두운 하단 캡션 필 + 네온 그린
- 심리적/일상 내러티브 - 스크립트 기반 맞춤형 벡터 자산
1️⃣ 엔진 모드 선택 (Dual-Engine Mode Selection)
사용자는 하나의 스킬만 설치/사용합니다. 스크립트 유형 또는 사용자 지시에 따라 자동으로 올바른 엔진이 활성화됩니다.
| 모드 | 트리거 키워드 | 스크립트 유형 | 비주얼 메타포 및 스타일 |
|---|---|---|---|
| Mode 1: 캐릭터 스토리텔링 엔진 | story, cartoon, drama, character, golpo, গল্প, কার্টুন | 캐릭터 기반 대화, 심리적 갈등, 교육적 이야기, 팟캐스트 내레이션 | 절차적 2D 플랫 캐릭터, 입술 움직임, 말풍선, 풀스크린 침실/사무실 배경 |
| Mode 2: 키네틱 모션 그래픽 & 프로모 엔진 | promo, ad, commercial, saas, kinetic, explainer, বিজ্ঞাপন, প্রমো | 제품 광고, SaaS/소프트웨어 데모, e-커머스 프로모, 비즈니스 전략 | 도트 그리드 텍스처, 브랜드 헤더, 모서리 워터마크, 폰 목업, 카드 메커닉, 어두운 하단 캡션 필 |
[!TIP] 사용자가 특정 모드를 명시하지 않은 경우, 스크립트에 눈에 띄는 캐릭터나 대화가 있으면 **Mode 1 (Story)**를, 비즈니스 문제/제품 솔루션이 있으면 **Mode 2 (Promo)**를 자동으로 선택하며, 승인 테이블에 이를 명시합니다.
2️⃣ ⚠️ 매우 중요한 규칙: 100% 데이터 기반 유니버설 스킬 아키텍처 (Universal Data-Driven Architecture)
[!CAUTION] 새로운 스크립트마다 새로운 React 컴포넌트, 코드 파일, 별도 폴더 또는 일회성
.mjs스크립트를 만드는 것을 엄격히 금지합니다! 이는 전역 유니버설 스킬로, 모든 사용자가 설치하여 어떤 주제의 스크립트든 실행할 수 있습니다. 모든 스크립트별 변경 사항(캐릭터 외형, 의상, 배경 테마, 대화, 액션 비트, 인포그래픽 및 선택적 카드)은 단 하나의 입력 JSON 파일에서만 구성해야 합니다.
유니버설 비디오 생성 파이프라인 (단 4가지 명령어):
- 스크립트에서 자동 합성 및 입력 JSON 생성 (AI Director Analyzer):
- 스크립트의 내용, 신체 활동, 객체/소품, 감정 및 대화를 자동 분석하여 동적 스토리보드를 생성합니다:
python3 scripts/analyze-script-director.py --script=scripts/<story-name>.txt --out=scripts/<story-name>-input.json - 또는
examples/sample-story-input.json참조하여 씬별로scripts/<story-name>-input.json을 직접 생성합니다.
- 스크립트의 내용, 신체 활동, 객체/소품, 감정 및 대화를 자동 분석하여 동적 스토리보드를 생성합니다:
- 유니버설 오디오 및 타이밍 합성:
node scripts/tts-engine.mjs --input=scripts/<story-name>-input.json- 자동으로 Cartesia 또는 선택된 TTS를 사용하여 각 씬의 음성을 생성하고, 오디오의 정확한 초/프레임 타이밍을 입력 JSON에 저장합니다.
- 유니버설 타임라인 컴파일:
node scripts/build-story-timeline.mjs --input=scripts/<story-name>-input.json- Remotion 준비
template/src/timeline.json을 생성합니다.
- Remotion 준비
- 미리보기 확인 및 전체 렌더링:
cd template && npx remotion render src/index.ts Main ./out/<video-name>.mp4 --concurrency=4
3️⃣ 모드 1: 캐릭터 스토리텔링 엔진 규칙 (Mode 1 Guidelines)
- 캐릭터 구성, 캐스팅 및 3명 이상 캐릭터 스테이징 (Dynamic Character Casting & Staging):
- 스크립트 기반 캐스팅: 스크립트에 필요한 캐릭터 수를 파악하여 각각 고유한 신원을 생성해야 합니다.
- 얼굴의 독창성: 여러 캐릭터가 있을 때 동일한 얼굴/안경을 복제해서는 안 됩니다. 나이, 헤어스타일, 의상에 명확한 차이가 있어야 합니다.
- 안경 사용: 노인이나 특정 직업의 캐릭터에게만 안경을 착용시킵니다. 일반 고객이나 직원에게 불필요하게 동그란 안경을 씌우는 것을 엄격히 금지합니다.
- 의상과 신원: 가게 주인(반바지/쿠르타), 판매 직원(유니폼/폴로), 고객(캐주얼 티셔츠/후드) 등.
- 단단한 헤어라인 캡: 두피가 완전히 덮여야 합니다 (빈 초승달 자국 없음).
- 스케일링 및 프레이밍 (1, 2 또는 3명 캐릭터):
- 1명 캐릭터:
scale: 1.85, 중앙 (center) 또는 왼쪽/오른쪽. - 2명 캐릭터:
scale: 1.75, 왼쪽과 오른쪽 (left: 80,right: 80,bottom: 160). - 3명 캐릭터 (
tertiaryCharacter): 9:16 프레임에서 3명이 있을 때 완벽한 구성을 위해scale: 1.55를 사용합니다. 왼쪽에 보조 캐릭터 (left: 20), 중앙에 3번째 캐릭터 (center), 오른쪽에 주인공 (right: 20,flip: true).
- 1명 캐릭터:
- 배경 군중 레이어 (
crowd):- 가게에 손님 또는 사무실에 팀이 있을 때
crowd: "shoppers"|"office_team"|"village_crowd"|"classroom_students"를 추가합니다. 이는 캐릭터 뒤에 (zIndex: 12), 작은 스케일 (scale: 1.1 - 1.15),bottom: 240-260, 약간의 블러 (blur: 2px)를 적용하여 자연스러운 피사계 심도를 만듭니다.
- 가게에 손님 또는 사무실에 팀이 있을 때
- 환경 및 맥락 분석 (Dynamic Environment & Semantic Procedural Fallback):
- 환경에 따라 사전 제작된 26개 이상의 배경 테마를 사용합니다:
- 상점:
clothing_store,electronics_store,pharmacy,grocery_store - 주거 및 모임:
living_room,home_study,tea_stall,cafe,wedding_hall - 사무실 및 기관:
corporate_office,hospital_clinic,police_station,classroom,deep_library - 마을 및 야외:
village_bazaar,village_sunset,street_outdoor,bus_interior - 분위기 및 갈등:
dark_conflict,dramatic_red,blue_melancholy,golden_sunrise
- 상점:
- 스마트 시맨틱 절차적 방 생성기 (No Blind Office Fallback):
- 완전히 새롭거나 목록에 없는 테마(예:
bakery,gym,bank,courtroom,kitchen)가 주어지면 엔진은 맹목적으로 사무실로 대체하지 않습니다. 대신 테마 이름을 디코딩하여 관련 실루엣, 간판 및 인테리어 색상 벡터를 자동 생성합니다.
- 완전히 새롭거나 목록에 없는 테마(예:
- 각 씬은 화면 시작부터 끝까지 100% 풀스크린 (
width: 100%, height: 100%)입니다.
- 환경에 따라 사전 제작된 26개 이상의 배경 테마를 사용합니다:
- 카메라 흔들림 및 캐릭터 떨림 규칙 (Tone-Calibrated Screen Shake & Character Tremble - STRICT MAX 1.0-1.2 SECONDS):
- ⚠️ 지속적인 흔들림 또는 캐릭터 떨림 금지: 어떤 상황에서도 한 씬에서 10~20초 동안 카메라를 흔들거나 캐릭터를 떨게 해서는 안 됩니다. 시청자에게 극심한 불편을 초래합니다.
- 캐릭터 떨림 제한 (
trembleX): 캐릭터의 공포, 분노 또는 충격 시 떨림은 최대 1.01.2초 (3036프레임) 동안 지속되며, 이후 부드럽게 0으로 감소하여 정상 자세로 안정됩니다. - 톤 체크: 일반 대화, 평범한 논쟁, 고객 대화 또는 설명 중에는 화면과 캐릭터가 완전히 정지합니다 (
screenShake: false). - 갑작스러운 충격 제한: 극도로 강한 갑작스러운 충격 또는 충격의 경우에만 최대 1.0
1.2초 (3036프레임) 동안 일시적인 흔들림을 허용하며, 즉시 부드럽게 감쇠되어 카메라가 다시 안정됩니다.
- 대화 및 생각 말풍선 (
SpeechCalloutBubble):- 높이
top: 650으로 말풍선의 꼬리가 말하는 캐릭터의 머리를 직접 가리키도록 합니다 (왼쪽left: 180, 오른쪽right: 180). - 화자 이름 태그: 말풍선 위에 떠다니도록 합니다 (
zIndex: 60,padding: "5px 20px",border: "2.5px solid #ffffff").
- 높이
- ⚠️ 선택적 자막 및 완벽한 음성 동기화 캡션 (Selective Subtitles & Voice-Matched Karaoke Pill):
- 화면에 말풍선 또는 풀스크린 중앙 카드가 있을 때, 아래에 별도의 자막을 완전히 비활성화합니다 (중복 없음).
- 위에 말풍선이나 카드가 없을 때만, 내레이션의 실제 음성 텍스트에서 동적으로 3~5단어의 강력한 구절 캡션이 아래에 나타납니다.
- 캡션은 절대 한 줄의 정적 요약을 늘리지 않습니다. 오디오에서 발음되는 단어 그대로, 구절 단위로 실시간으로 화면에 표시됩니다.
- 시각 효과:
- 각 구절이 나타날 때 어두운 유리 캡슐 필이 부드러운 스프링 팝(
spring스케일)으로 진입합니다. - 발음되는 실시간 단어: 네온 그린 (
#22C55E) 빛나는 텍스트 + 배경 필 하이라이트 +scale(1.08)펀치. - 하이라이트 키워드: 생생한 호박색/황금색 배지 (
#F59E0B➔#EA580C). - 구절 전환 시 빈 프레임이나 깜빡임이 없어야 합니다. 한 구절에서 다음 구절로 매끄럽게 전환됩니다.
- 각 구절이 나타날 때 어두운 유리 캡슐 필이 부드러운 스프링 팝(
- ⚠️ 입술 움직임 및 활성 화자 규칙 (Selective Speaker Lip-Sync Rule):
- 화면에 두 사람이 있을 때, 그중 말풍성이 가리키는 사람(
speechBubble.speakerPosition)의 입만 움직입니다 (isSpeaking: true). - 다른 청자 또는 듣는 캐릭터의 입은 조용히 닫혀 있어야 합니다 (
isSpeaking: false-> 닫힌 휴식선). 두 사람의 입이 동시에 움직여서는 안 됩니다.
- 화면에 두 사람이 있을 때, 그중 말풍성이 가리키는 사람(
- ⚠️ 화자 대 대화 타이밍 (Narrator vs Dialogue Timing Rule):
- 어떤 씬에서 내레이터나 화자가 3인칭으로 사건을 설명할 때, 화면의 어떤 캐릭터의 입도 움직이지 않아야 (
isSpeaking: false) 하며 말풍선도 없어야 합니다. - 말풍선은 캐릭터의 1인칭 대화 시간에만 특정 프레임 (
speechBubbles: [{ start, duration }])에 떠오르며, 해당 특정 초 동안만 입이 움직입니다. 대화가 끝나면 말풍선은 사라지고 입은 다시 닫힙니다.
- 어떤 씬에서 내레이터나 화자가 3인칭으로 사건을 설명할 때, 화면의 어떤 캐릭터의 입도 움직이지 않아야 (
- ⚠️ 캐릭터 역할 및 대화 무결성 (Speaker Identity & Role Integrity):
- 한 캐릭터의 대화를 다른 캐릭터의 옷을 입은 캐릭터의 입을 통해 말하게 해서는 안 됩니다 (예: 직원의 말을 고객의 입을 통해 내보내는 것은 심각한 실수).
- 어떤 씬에서 대화 캐릭터가 변경되면(주인 대 직원에서 고객 등장): 씬을 작은 샷으로 나누어(Camera Cut) 화면에 말하는 사람의 올바른 옷을 입은 캐릭터가 보이도록 해야 합니다.
- ⚠️ 신체 활동 및 한눈에 보는 액션 비트 (At-A-Glance Timed Action Beats):
- 캐릭터를 로봇처럼 팔을 곧게 펴고 계속 서 있게 하거나, 어떤 활동도 전체 씬 동안 10~15초 동안 멈추게 해서는 안 됩니다.
- 액션 및 소품은 관련 대화 시간에만 한눈에 (2.0~3.5초) 나타납니다 (
characterPoses/secondaryPoses):- 장부 확인 (
checking_khata): 계산 또는 장부 이야기 시 두 손으로 빨간 장부를 들고 보며, 눈은 아래를 봅니다. 대화가 끝나면 장부를 내리고 정상 자세로 돌아옵니다. - 재고 찾기 (
searching_inventory): 찾는 대화 시간에 선반 쪽으로 손을 뻗어 돋보기와 빈 선반 태그가 보입니다. 말을 마치면 손을 내리고 정상적으로 말합니다. - 샘플 셔츠 들어올리기 (
holding_shirt): 고객이 셔츠를 요청하는 순간 2~3초 동안 옷걸이에 셔츠를 들어 올려 보여준 후, 팔을 접고 기다립니다. - 참을성 없는 기다림 (
arms_crossed): 가슴에 팔을 교차하여 서 있습니다.
- 장부 확인 (
- ⚠️ 쇼트폼 페이싱 및 카드 유지 제한 (Max 12-18s Card/Scene Retention Rule):
- TikTok, YouTube Shorts 또는 Reels에서 단일 정적 모션 그래픽 또는 인포그래픽 카드를 20~40초 동안 계속 화면에 유지해서는 안 됩니다. 이는 극심한 시청자 이탈(Audience Drop-off / Retention Killer)을 유발합니다.
- 긴 내레이션 또는 설명 텍스트(예: 이야기의 교훈 및 결말)는 자동으로 작은 시각적 비트로 분할해야 합니다:
- 캐릭터 감정적 해결 / 깨달음 애니메이션 씬 (12~15초): 주인공의 감정과 조용한 결말.
- 핵심 교훈 비교 카드 (15~18초): 빠르게 읽을 수 있는 핵심 포인트 비교.
- 시청자 상호작용 및 팔로우 CTA 카드 (10~12초): 시청자에게 직접 댓글 및 팔로우 요청.
- 각 씬 및 카드는 최대 8~18초 내에 변경되어 새로운 시각적 자극을 생성해야 합니다.
- ⚠️ 활동 기반 비주얼 매핑 및 소품 (Activity-Driven Visual Storytelling & Literal Narrative Mapping):
- 스크립트 또는 음성 해설에서 특정 신체 활동을 언급할 때 (예: "컴퓨터에서 눈을 떼지 않고 말했다", "책상에 앉아 일했다", "주인이 불렀다", "사직서를 제출했다", "항의했다"):
- 씬에는 해당 활동과 적절한 소품이 반드시 시각적으로 포함되어야 합니다 (
prop: "office_desk_computer"|"executive_desk"|"ceo_office_desk"|"resignation_letters"및 캐릭터 포즈:using_computer|sitting_desk|pointing|reading_document|celebrating). - 캐릭터를 절대 빈 방에 로봇처럼 세워두어서는 안 됩니다. 설명에 컴퓨터나 책상이 언급되면 테이블에 앉아 모니터로 작업하는 관점을 표현해야 합니다.
- 씬에는 해당 활동과 적절한 소품이 반드시 시각적으로 포함되어야 합니다 (
- 스크립트 또는 음성 해설에서 특정 신체 활동을 언급할 때 (예: "컴퓨터에서 눈을 떼지 않고 말했다", "책상에 앉아 일했다", "주인이 불렀다", "사직서를 제출했다", "항의했다"):
- ⚠️ 씬 분할 및 빈번한 장면 전환 (Strict 4-10s Scene Granularity & Dynamic Perspective Rule):
- 전체 이야기에서 단일 배경이나 프레임을 20~30초 동안 계속 유지해서는 안 됩니다. 음성 해설에서 주제나 분위기가 변경되면 시각적 장면도 반드시 컷(Cut)해야 합니다.
- 각 씬은 최대 4~10초 길이여야 합니다.
- 설명에서 시간 변화, 직위 전환 또는 장소 이동이 있을 때 (예: 평범한 직원 ➔ 항의 ➔ 모임 ➔ 관리자 승진 ➔ 경고장 ➔ 동료들의 두려움 ➔ 수민과의 갈등 ➔ 집단 사직 ➔ 사장실 ➔ 혼자만의 깨달음) 각각에 대해 별개의 시각적 씬, 프레임 및 관점을 보장해야 합니다.
- ⚠️ 유니버설 액션, 객체 및 좌석 매트릭스 (Universal Semantic Action-to-Prop & Seating Matrix):
- 스크립트에서 어떤 주제나 환경을 언급하든, 캐릭터를 맹목적으로 서 있게 해서는 안 됩니다. 아래 매트릭스에 따라 자동 소품 및 좌석을 배치해야 합니다:
씬 및 맥락 자동 소품 ( prop)좌석 사무실/회의 office_desk_computer,executive_desk,ceo_office_desksitting_desk카페/찻집 coffee_cup,tea_glass,laptopsitting_chair병원/진료소 stethoscope,clipboard,medical_chartsitting_chair교실 whiteboard,textbook,pensitting_desk가게/시장 product_box,cash_register,shopping_bagstanding(일반적으로)길거리/야외 street_lamp,treestanding(일반적으로)집/거실 sofa,tea_cup,remote_controlsitting_sofa결혼식장 garland,flowerstanding(일반적으로)
- 스크립트에서 어떤 주제나 환경을 언급하든, 캐릭터를 맹목적으로 서 있게 해서는 안 됩니다. 아래 매트릭스에 따라 자동 소품 및 좌석을 배치해야 합니다:
4️⃣ 모드 2: 키네틱 모션 그래픽 & 프로모 엔진 규칙 (Mode 2 Guidelines)
- 브랜드 헤더 및 워터마크 (Persistent Brand Header & Watermark):
- 모든 씬 상단에 브랜드 로고/텍스트 헤더가 지속적으로 표시됩니다.
- 오른쪽 하단 모서리에 회색조 워터마크 로고가 표시됩니다.
- 도트 그리드 떠다니는 캔버스 (Dot-Grid Floating Canvas):
- 배경에 부드럽게 움직이는 도트 그리드가 깔려 있습니다.
- 드물게 마우스 커서 효과가 나타날 수 있습니다.
- 어두운 하단 캡션 필 + 네온 그린 (Dark Bottom Caption Pill + Neon Green):
- 모든 구절/요점에 대해 어두운 배경의 캡슐 필이 사용됩니다.
- 강조 단어는 네온 그린 (
#22C55E)으로 표시됩니다.
- 스크립트 기반 맞춤형 벡터 자산 생성 (Script-Driven Bespoke Vector Asset Synthesis):
- ⚠️ 기존 아이콘 재사용 금지: 각 주제에 대해 완전히 새로운 SVG 벡터 컴포넌트가 생성됩니다. 기존 라이브러리에서 관련 없는 아이콘을 가져오지 않습니다.
- 엔진은 스크립트를 분석하여 키워드를 추출하고, 각 키워드에 대해 의미적으로 관련된 맞춤형 SVG 일러스트레이션을 절차적으로 생성합니다.
- 폰 목업 및 카드 메커닉 (Phone Mockup & Card Mechanics):
- 필요시 폰 목업 화면에 앱 UI 또는 웹사이트 데모가 표시됩니다.
- 정보 카드는 체계적으로 나타나고 사라집니다 (스택, 슬라이드, 페이드).
- 타이포그래피 및 모션 그래픽 규칙 (Typography & Motion Graphics Rules):
- 굵고 현대적인 산세리프체 사용.
- 텍스트 애니메이션: 나타나기, 슬라이드, 강조 표시.
- 각 화면은 하나의 주요 메시지에 집중.
5️⃣ 품질 보증: 시각적 자기 점검 워크플로우 (Self-Check Visual Inspection)
렌더링 후 또는 미리보기 중에 다음을 검사합니다:
- 중복 자막 확인: 말풍선/카드가 있을 때 하단 캡션 없음.
- 입술 움직임 확인: 말하는 캐릭터만 입술 움직임.
- 캐릭터 얼굴/의상 구분: 모든 캐릭터가 시각적으로 구별됨.
- 소품/액션 일치: 언급된 모든 활동이 시각화됨.
- 씬 길이 준수: 4~10초 규칙 위반 없음.
- 카메라 흔들림 제한: 1.2초 초과 흔들림 없음.
- 배경 일관성: 100% 풀스크린, 의미적으로 적절함.
6️⃣ 엄격한 승인 워크플로우 (Two-Point Approval Workflow)
- 첫 번째 승인 (컨셉 승인): AI Director Analyzer가 생성한
scripts/<story-name>-input.json의 내용을 검토합니다. 캐릭터 캐스팅, 배경 선택, 액션 비트가 스크립트와 일치하는지 확인합니다. - 두 번째 승인 (렌더링 승인): 렌더링된 비디오를 검토하여 위의 품질 보증 항목을 통과했는지 확인합니다.
[!IMPORTANT] 두 승인 모두 완료되어야 최종 비디오로 간주됩니다. 어느 단계에서든 수정이 필요한 경우, 워크플로우를 처음부터 다시 시작해야 합니다.