zyaizl/google-flow-director

Google Flow Director (google-flow-director)

Google Flow (Veo 네이티브 오디오-비디오 통합 생성) 를 위한 전문 상업 비디오 감독 수준의 스토리보드 및 멀티 클립 일관성 제어 시스템입니다. HiAPIAI/awesome-ai-video-workflows (상업 메인 비주얼 카메라 움직임 및 조명 표준), BigBanana-AI-Director / ArcReel (글로벌 Visual & Audio Bible + 키프레임 에셋 잠금), creatify-ai/video-ad-generator (골든 타임라인 및 높은 완독률 리듬)의 방법론을 융합했습니다.

적용 시나리오

1. 도시 문화 관광 홍보 영상 (City & Cultural Tourism): 고금의穿越, 무형 문화재 장인 정신, 자연 산하, 사이버펑크 도시, 인문학적 일상.
2. 브랜드 감성 TVC (Brand Anthem & Commercial): 하이엔드 미니멀리즘, 라이프스타일 에스테틱, 브랜드 정신 승화, 질감 있는 빈 샷 스토리텔링.
3. 제품 하이라이트 쇼케이스 (Product Hero Showcase): 디지털 하드웨어 매크로, 뷰티/향수 플루이드, 음료 하이스피드 촬영, 산업 디자인 라이트 & 섀도우 플로우 (실제 제품 사진 업로드하여 비주얼 DNA 추출 지원).

---

핵심 실행 프로세스 (4단계 순수 오디오-비디오 감독 워크플로우)

사용자가 비디오 제작 요청을 할 때마다 (예: 주제 + 목표 총 길이 + 옵션 제품 사진/스타일 선호도 제공) 다음 4단계를 엄격히 따라야 합니다.

Step 1: 제품 사진 비주얼 DNA 해체 (이미지 업로드 시) 및 글로벌 오디오-비디오 이중 잠금 (Visual & Audio Bible)

1. 사용자가 제품 사진 / 브랜드 로고 / 참조 이미지를 업로드한 경우:
   • 즉시 view_file을 사용하여 이미지를 확인하고 Product Visual DNA를 추출합니다:
     • 정확한 기하학적 형태와 비율 (Shape & Proportions)
     • 표면 재질 및 반사 속성 (예: brushed titanium, matte frosted glass, gold foil embossed serif logo)
     • 핵심 색상 코드 및 조명 특성
   • 추출된 영어 고정 외관 키워드를 subject_lock_en으로 정의하고 Google Flow Ingredients (垫图/시작 프레임 참조) 전략을 계획합니다.
2. 글로벌 Visual & Audio Bible (visual_bible + audio_guide) 구축:
   • references/cinematography_and_transitions.md를 참조하여 전체 영상에 대해 고유한 다음 항목을 결정합니다:
     • 카메라 및 렌즈 초점 거리 (예: ARRI Alexa 65 + Panavision Anamorphic Lens)
     • 조명基调 및 색온도/색상 (예: Warm amber kiln firelight contrasting with deep jade-cyan shadows, Kodak Vision3 500T)
     • 글로벌 강제 비주얼 접미사 (style_suffix_en): 25~40 단어의 표준 영어 촬영 접미사.
     • 글로벌 강제 내레이션 및 오디오 잠금 (voice_and_audio_lock_en): Google Flow는 내레이션과 사운드 효과를 직접 지원합니다. 비디오 클립 간에 나레이터가 바뀌거나 BGM이 갑자기 변하는 것을 방지하기 위해 고정된 나레이터 성격 음색 키워드 (예: Consistent warm, deep, magnetic male Mandarin Chinese documentary narrator voice, calm poetic cadence, crisp studio condenser mic)와 통일된 배경 음악基调를 정의해야 합니다.
   • 강제 합성 규칙: style_suffix_en과 voice_and_audio_lock_en은 반드시 결합되어 각 샷의 flow_video_prompt_en에 내장되어야 합니다. 이를 통해 사용자가 Google Flow에서 한 번 복사하여 일관된 화풍과 통일된 음색의 깔끔한 완성본을 동시에 생성할 수 있습니다.
   • ⚠️ 자막 명령어 절대 추가 금지: 프롬프트에 자막 생성 또는 화면 내 큰 텍스트 명령어를 포함시키지 마십시오 (AI 비디오 직접 텍스트 생성은 쉽게 왜곡되어 화질을 떨어뜨립니다). 스토리보드 내에는 중국어 대사 나레이션만 별도로 보관하여 사용자가 CapCut/PR 등 후반 편집 소프트웨어에서 음성 인식을 통해 고품질 자막을 쉽게 생성할 수 있도록 합니다.

Step 2: 총 길이 분할 및 생성 모드 결정 (15초 원샷 또는 빠른 컷 분할 지원)

사용자가 지정한 완성 영상 총 길이 (예: 30초를 2개의 15초 롱테이크로 분할하거나 여러 개의 5초~8초 샷으로 분할)에 따라:

• 15초 복합 원샷 모드 (Google Flow 15초 직접 출력에 권장):
  • 30초를 CLIP 01 (00:00 - 00:15) 및 CLIP 02 (00:15 - 00:30)로 분할합니다.
  • 각 15초 프롬프트 내에서 [0-5s] -> [5-10s] -> [10-15s]로 연속적인 카메라 여정 (Continuous Camera Journey)과 초 단위 사운드 효과 및 나레이션 큐 포인트를 계획합니다.
  • 동시에 예비 열 (keyframe_image_prompt_en)에 8s Base + 7s SceneBuilder Extend (분할 내레이션 및 사운드 효과 포함) 분할 프롬프트를 제공하여 사용자가 Flow에서 유연하게 선택할 수 있도록 합니다.
• 지능적 생성 모드 할당 (gen_mode_badge):
  • T2V 텍스트-비디오 (오디오-비디오 통합) (기본 70%~85%): 풍경, 유체, 수묵화, 조명 빈 샷에 사용되며, 내장된 글로벌 비주얼 잠금 + 글로벌 오디오 잠금으로 일관성을 유지합니다.
  • I2V 이미지-비디오 (시작 프레임 참조 / Ingredients) (15%~25%): 구체적인 제품 자체, 브랜드 로고 또는 핵심 국보 유물이 화면에 나타날 때 활성화되며, 사용자에게 참조 이미지를 Ingredients로 업로드하도록 안내합니다.
  • F2V 프레임-투-프레임 브릿지 (핵심 변형 전환): 인접한 두 샷 간에 초현실적인 매끄러운 변형이 필요할 때 활성화됩니다.

Step 3: 전후 샷 간 매끄러운 전환 브릿지 + 오디오-비디오 통합 프롬프트 작성 (자막 없는 깔끔한 화면)

1. 비주얼 매끄러운 전환 (Transition Bridge):
   • references/cinematography_and_transitions.md의 6대 전환 매트릭스 (MATCH_SHAPE 동심원 매칭, WHIP_WIPE 빠른 패닝 마스크, SPEED_RAMP_DIVE 매크로 진입, LIGHT_BOKEH 보케 브레스, MOTION_RELAY 모션 릴레이, SCENE_EXTEND 네이티브 확장)에서 전환을 선택합니다.
   • 이전 샷의 끝에 Exit Momentum을 포함하고, 다음 샷의 시작에 해당 Entry Momentum을 포함합니다.
2. 오디오-비디오 통합 프롬프트 구조 (All-in-One Clean Flow Prompt):
   • 각 샷의 flow_video_prompt_en은 다음 모듈을 하나의 완전한 프롬프트로 결합하여 Google Flow에 직접 복사하여 붙여넣을 수 있도록 해야 합니다 (어떠한 자막 텍스트 명령어도 포함하지 않음):
     1. [Visual & Continuous Camera]: 초/초 단위 화면 및 연속 카메라 움직임 설명;
     2. [Native Audio, Foley & BGM]: 화면 동작과 엄격히 동기화된 네이티브 환경 사운드 효과 (ASMR/Foley) 및 배경 음악 진행;
     3. [Voiceover (Mandarin Chinese)]: 나레이터 음색 설명과 따옴표 안의 중국어 대사 원문을 직접 포함 (예: A warm, deep, magnetic male narrator speaks in standard Mandarin Chinese with poetic documentary cadence: "一捧高岭土，落笔藏山河；千度烈焰里，淬炼不灭的温润。");
     4. [Global Visual Lock]: 글로벌 카메라 및 필름 스타일 조명 접미사 잠금.

Step 4: 듀얼 모드 전달 (Markdown 실행 시트 + 인터랙티브 HTML 감독 스토리보드) 및 클라우드 동기화

1. 전체 기획 및 스토리보드 데이터를 구조화된 JSON으로 구성하여 /home/antigravity/flow_projects/<project_slug>.json에 저장합니다.
2. 이 Skill에 포함된 내보내기 스크립트를 호출하여 로컬 파일과 시각화 HTML을 생성합니다:

   python3 /shared/user/.gemini/skills/google-flow-director/scripts/export_storyboard.py \
     /home/antigravity/flow_projects/<project_slug>.json \
     --out-dir /home/antigravity/flow_projects \
     --html-artifact <ArtifactDirectoryPath>/<project_slug>_storyboard.html
   

3. 클라우드 드라이브 동기화 스크립트를 호출하여 생성된 .md 스토리보드 실행 시트, .html 인터랙티브 스토리보드 및 .json 소스 데이터를 사용자의 Google Drive (Google_Flow_Director_Hub/01_项目分镜与故事板_Projects/<project_slug>/)에 자동으로 아카이브합니다:

   python3 /shared/user/.gemini/skills/google-flow-director/scripts/sync_to_drive.py \
     --project-dir /home/antigravity/flow_projects
   

4. 동시에 <project_slug>_storyboard.html을 write_to_file ( ArtifactMetadata: UserFacing: true, RequestFeedback: false 포함)을 통해 미리보기 가능한 Artifact로 등록하고, 응답에 핵심 스토리보드 하이라이트와 파일/클라우드 드라이브 링크를 요약하여 포함합니다.