사용 시기
사용자가 프로모션 비디오, 제품 비디오, 데모 비디오, 마케팅 비디오, 론칭 비디오, 설명 비디오, 브랜드 비디오, 디자인된 비디오, 멀티샷 비디오, 스토리보드 기반 비디오, 소셜 미디어/Reels/TikTok 발견 비디오, 지역 비즈니스 비디오, 레스토랑/푸드 블로그 스타일 비디오, 제품 광고, 전자상거래 / 아마존 스타일 제품 비디오, 팩샷 또는 360도 제품 회전 비디오, 상점 / 탐방 비디오, DTC / 다이렉트 리스폰스 / 사후 비교 전환 광고, 20초 이상 편집 비디오, 또는 시각적으로 주제를 소개하는 완전한 비디오를 요청할 때 이 스킬을 사용하세요.
요청이 타임라인, 샷, 자막, 오디오, 카메라 언어, 시각적 스타일, 일관성 요구 사항, CTA/엔드 카드 또는 여러 장면이 포함된 완전한 편집 비디오를 설명하는 경우(사용자가 "프로모" 또는 "프로모션"이라고 말하지 않더라도) 이 리모션 워크플로우를 선호하세요. 직접 AI 비디오 생성은 단일 짧은 소스 클립 또는 배경 루프에만 사용하고, 완전한 멀티샷 비디오의 최종 전달 경로로는 사용하지 마세요.
비디오 주제는 다음 중 하나일 수 있습니다:
- 프로젝트 프로모션 — 에이전트 자체가 구축 중이거나 작업 공간에 이미 존재하는 프로젝트, 앱 또는 기능, 또는 사용자 요청 또는 이전에 확인된 컨텍스트에서 이미 식별된 다른 기존 앱입니다. 먼저 프로모션되는 소스 앱을 확인하세요.
app/promo는 출력 비디오 프로젝트이며, 자동으로 소스 앱이 아닙니다. - 주제 프로모션 — 작업 공간 프로젝트가 필요하지 않은 사용자 제공 주제, 개념, 브랜드 또는 외부 주제입니다. 예: "태양계", "송나라 역사", "벡터 데이터베이스란 무엇인가".
두 경로 모두 동일한 리모션 템플릿, 동일한 컴포지션 사전 설정 및 동일한 렌더 명령어를 공유합니다. 스토리보드 작성만 다릅니다.
명령어
최종 프로모션 내보내기에는 RemotionPromoRenderer.render를 사용하세요. 이 명령어는 이 스킬에 의해 문서화되어 있으며 <사용 가능한 명령어>에 나열되지 않았더라도 호출될 수 있습니다.
width/height/source_orientation은 반드시 스토리보드의 내보내기 사양에서 가져와야 하며, 이 예시에서 가져오지 마세요. 아래 예시는 자리 표시자로 가로 값을 보여줍니다. 스토리보드가 세로인 경우 width=1080 height=1920 source_orientation=portrait를 전달하고(정사각형인 경우 → 1080/1080/square) 전달하세요. 출력 파일 이름은 promo-<width>x<height>.mp4이므로, 1920x1080을 잘못 사용한 세로 렌더링은 스토리보드를 읽지 않고 예시를 복사했다는 신호입니다.
<RemotionPromoRenderer.render>
<promo_dir>/절대/경로/to/app/promo</promo_dir>
<width>스토리보드_너비</width>
<height>스토리보드_높이</height>
<source_orientation>스토리보드_방향</source_orientation>
</RemotionPromoRenderer.render>
주제 분류
다른 모든 작업을 수행하기 전에 원래 사용자 요청에서 주제를 분류하세요. 요청에 이미 주제나 프로젝트가 명명된 경우 사용자에게 명확히 설명을 요청하지 마세요.
- 사용자 메시지가 명확한 외부 주제/개념(예: "태양계를 소개하는 홍보 영상을 만들어 줘")을 지정하고 작업 공간에
app/frontend또는 프로모션할 애플리케이션 코드가 없는 경우 → 주제 프로모션. - 사용자 메시지가 기존
app/frontend빌드, 에이전트가 생성 중인 진행 중인 앱, 또는 곧 출시될 기능을 참조하는 경우 → 프로젝트 프로모션. - 주제가 물리적 제품, 소매/지역 비즈니스 또는 장소, 또는 재구축 가능한 앱 UI가 주요 주제로 없는 다이렉트 리스폰스 제안(예: 자동차 방향제 광고, 주얼리 360도 회전, 라멘 가게 탐방, 반려동물 털 제거기 DTC 광고)인 경우 → 상업 프로모션.
- 두 가지 모두에 해당하는 경우(예: "태양계 설명 앱 홍보 영상 만들어 줘") 앱을 기본으로 취급하고 주제를 보조 주제로 사용합니다. 이것은 프로젝트 프로모션입니다.
하나 이상의 분류가 적용될 수 있는 경우 다음 결정 보조 기준을 사용하세요: 재구축 가능한 소프트웨어 UI가 주제인 경우 → 프로젝트 프로모션; 물리적 제품/물리적 장소/재구축 가능한 UI가 없는 제안인 경우 → 상업 프로모션; 제품이 없는 외부 개념 또는 지식인 경우 → 주제 프로모션. 혼합 사례(예: 실제 결제 화면도 보여주는 DTC 소프트웨어 제품 광고)는 히어로 샷이 판매하는 대상에 따라 분류되며, 샷별로 다른 클래스의 규칙을 차용할 수 있습니다(예: 상업 프로모션 내의 하나의 ui-demo 결제 비트).
주제 프로모션과 상업 프로모션은 일급 시민입니다. 작업 공간에 app/frontend가 없다고 해서 주제 프로모션을 거부하거나 지연시키지 말고, 제품에 재구축할 app/frontend가 없다고 해서 상업 프로모션을 주제 프로모션으로 강등시키지 마세요.
컴플라이언스 기준
프로모션 비디오는 기본적으로 보수적인 광고 안전 규칙을 따라야 합니다. 사용자의 요청, 프로젝트, 광고 카피 또는 랜딩 페이지에 있는 주장, 제안, 가격, 할인, 선물, 브랜드 이름, CTA, 인증, 판매 수치, 효과 및 서비스만 사용하세요. 소스 자료가 명시적으로 제공하지 않는 한 공식 파트너십, 플랫폼 추천, 브랜드 보증 또는 인증을 암시하지 마세요.
보장된 결과, 절대적인 순위, 무위험 약속, 가짜 희소성, 가짜 카운트다운, 가짜 알림, 가짜 버튼, 가짜 시스템 UI, 가짜 사용후기, 가짜 리뷰, 가짜 뉴스 또는 과장된 결과 스크린샷과 같은 오해의 소지가 있거나 확인할 수 없는 주장을 사용하지 마세요. 건강, 재정, 연령, 인종, 종교, 성적 지향성, 장애, 결혼 여부, 신체 형태 또는 외모와 같은 민감한 개인 속성을 직접 타겟팅하지 말고 중립적인 잠재고객 표현을 사용하세요.
라이선스가 없는 브랜드 마크, 식별 가능한 인물, 저작권이 있는 캐릭터, 타사 제품 UI, 미디어, 폰트, 워터마크, 성인 콘텐츠, 고어, 충격, 증오, 괴롭힘, 굴욕적인 콘텐츠, 무기, 마약, 도박, 담배 또는 정치적으로 민감한 자료를 포함하지 마세요. 의료, 보충제, 체중 감량, 미용 시술, 금융, 대출, 암호화폐, 도박, 알코올, 데이트, 아동, 법률, 채용, 부동산, 정치, 종교 또는 사회 문제와 같은 고위험 범주의 경우 비디오를 정보 제공 수준으로 유지하고 강력한 약속, 극적인 사후 비교 시각 자료 또는 공격적인 전환 압력을 피하세요.
푸티지는 선명하고 안정적이며 고품질로 유지하세요: 깜빡임, 심한 압축, 늘어남, 자산 크기 조정 불량으로 인한 검은 막대, 가장자리 잘린 자막/로고/CTA가 없어야 합니다. 컴플라이언스가 확실하지 않은 경우 더 안전하고 중립적이며 정보를 먼저 전달하는 표현을 선택하세요. 이 기준은 위험을 줄이지만 플랫폼 승인을 보장하지는 않습니다.
최종 전환 CTA는 정적 비디오 콘텐츠이며 대화형 웹 UI가 아닙니다. 클릭 가능한 웹사이트 버튼, 가짜 클릭 대상, 화살표 버튼, 가짜 입력, 가짜 팝업, 가짜 시스템 UI, 커서 대상, 호버/누름 상태 또는 시청자가 클릭하여 탐색할 수 있다는 것을 암시하는 컨트롤로 닫는 CTA를 렌더링하지 마세요. 대신 엔드 카드 라인, 브랜드 태그라인, 계정 핸들, URL, QR 자리 표시자 또는 일반 "방문 / 스캔 / 팔로우" 텍스트를 사용하세요. 제품 데모 및 페이지 워크스루는 제품 흐름을 보여줄 때 실제 또는 시뮬레이션된 UI 버튼, 양식 및 탐색을 표시할 수 있지만 최종 전환 CTA가 되어서는 안 됩니다.
표시되는 URL, 계정 핸들, QR 대상, 브라우저 주소 표시줄 텍스트 또는 브랜드 엔드포인트는 사용자의 요청, 확인된 프로젝트 소스, 랜딩 페이지 또는 기타 확인된 자산에서 가져와야 합니다. 프로젝트가 자리 표시자 도메인 또는 확인된 공개 주소만 노출하는 경우 URL을 생략하고 대신 브랜드 카피로 끝내세요. 브라우저 창 처리를 위해 URL이 아닌 페이지 레이블을 사용하거나 주소 표시줄을 비워 두세요. 앱 이름, 저장소 이름, 다운로드 파일 이름, 템플릿 자리 표시자, env var 토큰 또는 유사한 힌트에서 도메인, 핸들 또는 대상을 유추하지 마세요.
핵심 워크플로우
app/promo가 아직 준비되지 않은 경우FrontendEngineer.use_template("remotion")으로 리모션 프로젝트를 초기화하세요. 도구 자체가 복사하기 전에 리모션이 아닌 소스를 거부하므로 별도의 확인 단계가 필요하지 않습니다.- 사용자 요청 및 스토리보드 계획에서 대상 방향을 미리 선택하세요: 가로(16:9), 세로(9:16) 또는 정사각형(1:1). 이후의 모든 검증, 스모크 및 전체 렌더 명령어는 일치하는 변형을 사용해야 합니다.
- 위의 주제 분류를 사용하여 주제(프로젝트 프로모션 대 주제 프로모션)를 분류하세요. 원래 요청에 이미 주제 또는 프로젝트가 명명된 경우 "이것이 무엇에 관한 것인가요?"라고 묻지 마세요.
- 주제를 구체화하세요:
- 프로젝트 프로모션: 먼저 프로모션되는 소스 앱을 확인한 다음 해당 앱의
app/frontend소스, 매니페스트 및 이전 검증 피드백을 읽으세요. 현재 작업 공간에 주로 프로모 출력이 포함된 경우app/promo자체를 소스 앱으로 취급하지 마세요. 소스 앱을 식별하면promo_storyboard.md또는 작업 노트에 해당 소스 프로젝트 루트/프론트엔드 경로를 잠그고app/promo로 전환한 후에도 동일한 경로를 계속 재사용하세요. 프로모 작업 공간 자체에app/frontend가 없다고 해서 주제 프로모션으로 강등시키지 마세요. Remotion 코드를 작성하기 전에 의존할 주요 소스 프론트엔드 파일 경로를promo_storyboard.md에 기록하세요(데모 비트를 위한 페이지/경로/컴포넌트). 나중에src/를 구현할 때 해당 소스 파일을 다시 열고 긴 산문 요약에 의존하는 대신 코드에서 복사/재생성하세요. - 주제 프로모션: 사용자 메시지와 이전 대화에서 주제를 추출하고, 자신의 지식이나 외부 도구(이미지/비디오/오디오 생성, 검색 가능한 경우)에서 추가 사실을 가져오세요. 작업 공간 프로젝트가 존재할 필요는 없습니다.
- 사용자가 참조 이미지를 제공했지만 현재 요청이 이미지 콘텐츠 대신 파일 경로만 노출하는 경우,
image-understanding을 읽고 스토리보드 작성 전에ImageAnalyzer.analyze_images를 호출하여 시각적 계획이 파일 이름이 아닌 실제 이미지 콘텐츠에 기반하도록 하세요. - 사용자가 프로모션 주제로 웹사이트 URL을 제공한 경우
Browser.goto를 사용하여 페이지를 방문한 다음Browser.take_screenshot을 사용하여 시각적 요소를 캡처하고, 스토리보드 작성 전에ImageAnalyzer.analyze_images를 호출하여 시각적 계획이 URL 자체가 아닌 실제 페이지 콘텐츠에 기반하도록 하세요.
- 프로젝트 프로모션: 먼저 프로모션되는 소스 앱을 확인한 다음 해당 앱의
- 컴플라이언스 기준을 적용하세요: 어떤 사실, 주장, 제안 및 자산이 요청, 제품, 광고 카피 또는 랜딩 페이지에 의해 실제로 지원되는지 확인하세요. 지원되지 않는 제안, 인증, 판매 수치, 효과, 공식 파트너십, 플랫폼 보증 또는 브랜드 지원을 만들지 마세요. 확실하지 않은 경우 보수적인 정보 우선 표현과 시각 자료를 선택하세요.
promo_storyboard.md를 작성하기 전에 새로 생성된 프로모션 콘텐츠의 기본 언어를 결정하세요. 사용자가 출력 언어를 명시적으로 지정한 경우 해당 언어를 사용하세요. 그렇지 않으면 기본적으로 영어를 사용하세요. 중국어/일본어 등으로 작성된 사용자 메시지, 주변 채팅 언어 또는 시스템 프롬프트 언어는 명시적인 언어 요청이 아닙니다. 결정 사항을 샷, 카피, 내레이션 또는 생성 프롬프트를 초안 작성하기 전에Language: English (default)또는Language: Chinese (user specified)와 같이 스토리보드에 직접 기록하세요.- 비디오 코드를 작성하거나 자산을 생성하기 전에
promo_storyboard.md를 생성하세요. 주제 유형과 일치하는 필드 세트를 사용하세요(스토리보드 요구 사항 참조). 프로모/리모션 실행의 경우promo_storyboard.md가 유일한 계획 산출물입니다. 별도의todo.md를 생성하거나 유지 관리하지 마세요. - 사용자가 내레이션, 음성 해설, 음성 워크스루를 요청하거나 스토리보드에 명확하게 내레이터가 필요한 경우 스토리보드에 단기 세그먼트 내레이션 계획을 포함하고 각 세그먼트의 스크립트 길이를 대상 샷 시간(초)과 비교한 다음
audio-generation을 읽고 샷/비트당 하나의 요청으로AudioCreator.generate_audios를 호출하세요. - TTS 생성 후 각 오디오 세그먼트의 반환된
duration을 선호하세요.duration이 없거나null인 경우 반환된 URL에서 실제 길이를 측정하고(예:ffprobe사용), 측정된 길이에서 최종 샷별 타이밍을 결정하세요. 이 계산은 생각 또는 터미널 출력에만 나타나는 것으로는 충분하지 않습니다. - 각 내레이션 URL, 측정된 오디오 시간(초), 최종 샷 시작/종료/길이, 총 길이 및 스크립트/타이밍 변경 사항으로
promo_storyboard.md를 즉시 업데이트하세요. 이것은 하드 체크포인트입니다: 업데이트된 타이밍이promo_storyboard.md에 저장될 때까지MusicCreator.generate_music,VideoCreator.generate_videos를 호출하거나 더 많은 시각적 자산을 생성하거나src/timeline.ts를 작성하지 마세요. 이 잠금 후에promo_storyboard.md는 더 이상 자리 표시자TBD타이밍 행 또는 오래된 총 길이를 유지해서는 안 됩니다. - 기본적으로 프로모션 비디오에는 사용자가 명시적으로 음악을 원하지 않거나 비디오가 음악 없이 더 낫다고 명백히 판단되지 않는 한 하나의 글로벌 배경 음악 계획도 포함되어야 합니다.
music-generation을 읽고 최종 샷 타이밍이 잠긴 후 정확히 하나의 기악 / 보컬 없음 요청으로MusicCreator.generate_music을 호출하세요. 프롬프트에는 대상 총 시간(초), 분위기, 페이싱, 악기 구성 및 트랙이 내레이션을 위한 공간을 남겨야 하는지 여부가 포함되어야 합니다. - 음악 생성 후 내레이션과 마찬가지로 반환된 URL을 직접 사용하고 반환된
duration을 선호하세요.duration이 없거나null인 경우ffprobe를 사용하여 실제 BGM 길이를 측정하세요.src/timeline.ts또는src/PromoVideo.tsx를 작성하기 전에 BGM URL, 측정된 시간(초), 대상 총 길이, 맞춤 전략 및 계획된 믹스 값으로promo_storyboard.md를 즉시 업데이트하세요. 잠긴 스토리보드/타임라인 길이가 진실의 원천입니다. 짧은 BGM에 맞추기 위해 비디오를 절대 줄이지 마세요. 사용자가 명시적으로 더 짧은 컷을 요청하지 않는 한 BGM을 트리밍, 최소한으로 반복 또는 재생성하세요. - 스토리보드가 작성되고 내레이션 + BGM 타이밍이
promo_storyboard.md에 확정된 후 다른 필요한 AI 이미지/비디오/오디오 자산을 생성하세요. remotion-best-practices를 읽고 스토리보드와 관련된 섹션에 집중하세요.app/promo아래에서 Remotion 구현을 제자리에서 편집하세요 — 템플릿의 평면src/레이아웃(src/Root.tsx,src/PromoVideo.tsx,src/timeline.ts,src/components/,src/scenes/,src/app-demo/)을 유지하세요. 소스를src/remotion/과 같은 하위 디렉토리로 이동하지 마세요. 검증 전에 빠른 자체 점검을 한 번 수행하세요: 사용되지 않는 import/var를 제거하고, 중복된Sequence from={0}를 생략하고, 모션을 순전히 프레임 기반으로 유지하고(CSSanimation/transition, 시간…
…[번역을 위해 잘림]