Communitygithub.com

btcson66-rgb/ecommerce-video-pipeline-skill

다양한 브랜드(Fantini Pelletteria 가방, ESPNER 선글라스 등)의 상업용 세로형 쇼트 비디오(9:16, 1080x1920, 30fps CFR)를 제작하기 위한 필수 표준 운영 절차(SOP)입니다. 모든 비디오는 반드시 3개의 서로 다른 실제 AI 비디오(S1, S2, S3)로 구성되어야 하며, 정적 이미지 슬라이드쇼나 단일 장면 비디오는 엄격히 금지됩니다.

ecommerce-video-pipeline-skill란 무엇인가요?

이 스킬은 다중 브랜드 제품(예: Fantini Pelletteria 가방, ESPNER 아이웨어/선글라스)의 상업용 세로형 쇼트 비디오(9:16, 1080x1920, 30fps CFR)를 자동으로 제작하기 위한 표준 운영 절차(SOP)를 정의합니다. 핵심은 모든 영상이 S1(Gemini App Veo 라이프스타일 액션), S2(Gemini/Flow 앰비언트 클로즈업 푸시인), S3(Google Flow Omni 1.1 Flash 3D 턴테이블 회전 쇼케이스)의 3가지 고유한 실제 AI 비디오로 구성되어야 하며, 순수 정적 이미지 슬라이드쇼나 단일 장면 비디오는 엄격히 금지된다는 것입니다. 이 SOP는 제품 이미지 획득 및 AI 전처리, Gemini(Veo) 및 Google Flow(Omni 1.1 Flash) 이중 엔진 생성, 음성 해설(edge-tts, zh-TW-YunJheNeural) 및 FFmpeg 기반 '제로 컷, 제로 프리즈 프레임' 이중 버전 렌더링, 마지막으로 Google Drive 클라우드 전송을 위한 7개 파일 패키지 준비까지의 전체 파이프라인을 다룹니다. 주요 특징으로는 Gemini 세션 격리(여러 제품 간 캐시 오염 방지), Google Flow 에셋 칩 및 최소 5초 지속 시간 제어(크레딧 절약), 제품 전환 그래픽이 포함된 '멀티 컬러' 버전과 단일 메인 컬러 360° 회전 뷰 버전의 이중 출력이 포함됩니다. 품질 보증을 위해 각 세그먼트의 프레임을 추출하여 실제 제품과 일치하는지 시각적으로 확인하는 단계가 포함되어 있습니다. 이 스킬은 Claude Code와 함께 사용하도록 설계되었으며, 다양한 브랜드의 고품질 상업 소셜 미디어 비디오를 생성하기 위한 재현 가능하고 엄격한 파이프라인을 제공합니다. 대상 사용자는 동영상 제작자, 디지털 마케터, 전자상거래 전문가로, 수동 편집을 최소화하면서 대량의 제품 비디오를 빠르게 제작해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add btcson66-rgb/ecommerce-video-pipeline-skill

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

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

문서

프리미엄 쇼트 비디오 자동화 제작 표준 운영 절차 (SOP) — 다중 브랜드 통합 플래그십 에디션

⚠️ 【철칙: 게으름과 편법은 절대 금지】

  1. 모든 완성 영상은 반드시 3개의 서로 다른 실제 AI 비디오로만 구성되어야 합니다:
    • S1 (Gemini App): 라이프스타일 착용 동적 영상 (유럽 스트리트 스냅, 비즈니스 복도, 테니스 코트 산책).
    • S2 (Gemini / Flow): 제품 휴식 배치 및 부드러운 푸시인 클로즈업 (카페 나무 테이블, 경기장 벤치).
    • S3 (Google Flow 3D 턴테이블): 360° 회전 쇼케이스 클로즈업 (최소 5초로 크레딧 절약 + Asset Chips 정품 태그).
  2. 순수 정적 이미지 슬라이드쇼(Ken Burns / Zoompan)로 메인 영상을 대체하는 것은 엄격히 금지됩니다!
  3. 단 1~2개의 세그먼트만으로 작업을 조잡하게 마무리하는 것은 엄격히 금지되며, S3 턴테이블 클로즈업 샷은 절대 빠질 수 없습니다!

1. 표준 3-세그먼트 샷 구성 및 순수 광고 규정

1.1 표준 3-세그먼트 샷 구성 아키텍처 (S1 + S2 + S3)

  • S1 (Gemini App 착용 동적 영상, 8초 9:16):
    • 가방: 도시 거리 산책, 비즈니스 복도 진입, 숄더백/핸드백의 자연스러운 움직임을 보여줌 (외관 스타일링만 촬영하며, 동전 지갑 내부 플랩이나 지퍼의 매크로 구조는 절대 촬영하지 않음).
    • 스포츠 선글라스: 햇볕이 내리쬐는 테니스 코트, 운동 트랙 산책, 한 손으로 프레임을 만지는 클로즈업.
    • 레트로 선글라스: 해변 야자수 길 산책, 햇볕이 내리쬐는 거리 스타일링.
  • S2 (Gemini / Flow 클로즈업 푸시 트랙, 5~8초 9:16):
    • 가방: 야외 카페 나무 테이블 위에 놓인 모습, 햇빛이 비치는 가죽 질감과 하드웨어 디테일.
    • 선글라스: 프리미엄 야외 카페 나무 테이블 위에 아이스 커피와 함께 배치, 핸드메이드 메탈 프레임과 G-15 렌즈의 부드러운 푸시인 클로즈업; 또는 코트 옆 벤치에 라켓과 함께 배치된 클로즈업.
  • S3 (Google Flow 3D 턴테이블 회전, 5초 9:16 최소 시간으로 크레딧 절약):
    • 전시대 위에서 360° 회전하여 제품을 보여주며, 여러 색상 전환 소개 또는 단일 색상의 완전한 360° 회전.

1.2 순수 제품 공식 광고 모드 (기본값 'Shopee 제외' Pure Brand Commercial)

  • 사용자가 특별히 Shopee 태그를 요청하지 않는 한, 항상 순수 브랜드 공식 이미지 광고 모드를 사용합니다.
  • 상단 캡슐, 하단 자막 카드, 쇼핑 유도 CTA 버튼, 나레이션 및 caption.txt 에는 'Shopee'라는 문구가 절대 나타나서는 안 됩니다. 대신 '공식 플래그십 한정 / 현장 재고', '아래를 클릭하여 탐색 / 구매'와 같이 표준 문구를 사용하세요.

2. 1단계: 정품 이미지 캡처, AI 친화적 전처리 및 이중 검증

  1. 고화질 정품 원본 이미지 캡처 및 특징 확인:
    • 실제 브랜드 (FANTINI, ESPNER 등), 모델명, 가격, 현장 재고 색상 및 세부 특징을 기록합니다.
  2. AI 인식에 최적화된 참조 이미지 사전 정리 (Pre-processing Reference Image):
    • scripts/preprocess_ai_ref.py 스크립트를 사용하여 제품 메인 이미지에서 프로모션 텍스트 보더를 제거하고, 이미지를 중앙에 배치하여 깨끗한 단색 배경의 1024×1024 RGB 이미지 (*_gemini_studio.jpg 또는 *_gemini_hero.jpg)로 출력합니다. 이는 AI의 크기 인식 오류를 방지합니다.
  3. 이중 검증 (오배치 방지 + 블랙 스크린 방지):
    • read_file 을 사용하여 참조 이미지를 직접 눈으로 확인하고, 실제 제품과 100% 일치하는지 확인해야 합니다.
    • scripts/validate_assets.py 스크립트를 실행하여 이미지 모드가 RGB인지 확인합니다 (RGBA 투명 배경 이미지를 직접 사용하는 것은 엄격히 금지됨).

3. 2단계: Gemini (Veo) 및 Google Flow (Omni 1.1 Flash) 이중 엔진 생성 규정

3.1 Gemini 다중 턴 대화 캐시 오염 방지 (세션 격리 철칙)

  • 제품을 교체할 때는 Gemini App에서 반드시 새 대화(New Chat)를 시작해야 하며, 백엔드 캐시가 이전 제품의 이미지를 잘못 사용하는 것을 방지합니다.
  • 비디오를 다운로드한 후에는 즉시 ffmpeg를 사용하여 프레임을 추출하고 read_file로 직접 눈으로 확인해야 합니다. 이전 대화로 인해 스타일이 오염되었거나 디테일이 일치하지 않는 경우, 즉시 Google Flow를 사용하여 다시 생성합니다.

3.2 Google Flow 최소 지속 시간으로 크레딧 절약 + 정밀한 Asset Chips 제어

  • S3 엔딩 3D 턴테이블 360° 회전 쇼케이스 (필수 Google Flow 사용):
    • 정품 이미지를 업로드한 후, 입력 필드 아래의 '프롬프트 입력란에 소재 추가'를 클릭하고 정품 이미지를 조건부 태그(Asset Chips)로 선택해야 합니다.
    • 크레딧 소모를 줄이기 위해 최소 지속 시간(5초)을 설정하고, 후반 작업에서 FFmpeg setpts를 통해 부드러운 슬로우 모션으로 나레이션에 필요한 길이로 늘립니다.
  • Gemini 크레딧이 소진되었거나 정밀한 클로즈업이 필요한 경우 원활한 핸드오프:
    • Gemini가 라운드당 3회 한도(5시간 쿨다운)에 도달하면, S1 / S2는 즉시 Google Flow에서 생성하므로 기다릴 필요가 없습니다.

4. 3단계: 차분한 남성 성우 나레이션 및 FFmpeg '제로 컷, 제로 프리즈 프레임' 이중 버전 렌더링

표준 자동화 렌더링 스크립트: scripts/render_video_template.py

  1. 나레이션 표준 (음성 제로 컷):
    • edge-tts를 사용하여 공식 차분한 대만 남성 성우 zh-TW-YunJheNeural 를 사용합니다 (rate="-1%", pitch="-2Hz").
    • 24초 하드 리밋이 완전히 해제되었습니다: 세그먼트 길이는 전체 문장 길이에 따라 동적으로 결정됩니다 (target_dur = audio_dur + 0.8s, adelay=350|350 및 문장 끝 여백 포함). atrim을 사용하여 나레이션을 자르는 것은 엄격히 금지됩니다.
  2. 부드러운 비디오 연장 (프리즈 프레임 제로, Zero Freeze Frame):
    • tpad=stop_mode=clone 종료 프레임 고정 사용은 엄격히 금지됩니다!
    • 원본 비디오 길이(예: 5초 또는 8초)가 세그먼트 대상 길이보다 짧은 경우, 항상 setpts=(seg_dur/v_dur)*PTS 부드러운 동적 슬로우 모션 연장을 사용하거나 부드러운 푸시인 줌을 함께 사용하여 전체 샷이 지속적으로 동적인지 확인합니다.
    • 강제 출력 사양: 1080x1920, -r 30 (30.0 fps CFR 일정 프레임률), libx264, yuv420p.
  3. 이중 버전 동시 생성 (멀티 컬러 버전 + 단일 컬러 360° 회전 버전):
    • final.mp4: S1 + S2 + S3 (여러 색상 스타일 전환 그래픽).
    • final_single_color.mp4: S1 + S2 + S3 (단일 메인 컬러 360° 회전 쇼케이스 그래픽).
  4. 완성된 비디오 시각적 스팟 체크:
    • final_check_s1.jpg, final_check_s2.jpg, final_check_s3.jpg를 추출하여 read_file로 직접 눈으로 확인합니다.

5. 4단계: Google Drive 클라우드 7종 화이트리스트 전달

  1. 표준 7종 목록:
    • final.mp4 (멀티 컬러 소개 버전)
    • final_single_color.mp4 (단일 컬러 360° 회전 버전)
    • cover.jpg (1080×1920 고품질 커버 이미지)
    • caption.txt (공식 소셜 미디어 카피 및 해시태그, Shopee 제외)
    • title.txt (SEO 제목)
    • product_url.txt (제품 URL)
    • qa.json (품질 검사 통과 기록)
  2. 화이트리스트 업로드 절차:
    • 7개 파일을 C:\Users\User\AppData\Local\Temp\<Product_ID>\에 복사합니다.
    • Google Drive의 02_휴대폰_게시_대기 폴더에 하위 폴더 (<번호>_<브랜드>_<제품_약칭>)를 만들고 업로드를 완료합니다.

관련 스킬