사용 시기
사용자가 프로모션 비디오, 제품 비디오, 데모 비디오, 마케팅 비디오, 출시 비디오, 설명 비디오, 브랜드 비디오, 디자인된 비디오, 멀티샷 비디오, 스토리보드된 비디오, 소셜 미디어/Reels/TikTok 발견형 비디오, 로컬 비즈니스 비디오, 레스토랑/푸드 블로그 스타일 비디오, 20초 이상 편집된 비디오, 또는 시각적으로 주제를 소개하는 완전한 비디오를 요청할 때 이 스킬을 사용하세요.
요청이 타임라인, 샷, 자막, 오디오, 카메라 언어, 시각적 스타일, 일관성 요구사항, CTA/엔드 카드 또는 여러 장면을 포함하는 완전한 편집 비디오를 설명하는 경우, 사용자가 "프로모" 또는 "프로모션"이라고 말하지 않더라도 이 Remotion 워크플로를 선호하세요. 단일 짧은 소스 클립 또는 배경 루프에만 직접 AI 비디오 생성을 사용하고, 완전한 멀티샷 비디오의 최종 전달 경로로는 사용하지 마세요.
비디오 주제는 다음 중 하나가 될 수 있습니다:
- 프로젝트 프로모션 — 에이전트 자체가 구축 중이거나 워크스페이스에 이미 존재하는 프로젝트, 앱 또는 기능, 또는 사용자 요청 또는 이전에 확인된 컨텍스트에서 이미 식별된 다른 기존 앱. 먼저 홍보 중인 소스 앱을 확인하세요.
app/promo는 출력 비디오 프로젝트이며, 자동으로 소스 앱이 아닙니다. - 주제 프로모션 — 워크스페이스 프로젝트가 필요하지 않은 사용자 제공 주제, 개념, 브랜드 또는 외부 주제. 예: "태양계", "송나라 역사", "벡터 데이터베이스란 무엇인가".
두 경로 모두 동일한 Remotion 템플릿, 동일한 구성 프리셋 및 동일한 렌더 명령을 공유합니다. 스토리보드 작성만 다릅니다.
명령어
검증 후 최종 프로모 내보내기를 위해 RemotionPromoRenderer.render를 사용하세요. 이 명령어는 이 스킬에 의해 문서화되어 있으며 <Available Commands>에 나열되지 않았더라도 호출될 수 있습니다.
<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>1920</width>
<height>1080</height>
<source_orientation>landscape</source_orientation>
</RemotionPromoRenderer.render>
주제 분류
다른 작업을 하기 전에 원래 사용자 요청에서 주제를 분류하세요. 요청에 이미 주제나 프로젝트가 명명된 경우 사용자에게 명확히 설명하도록 요청하지 마세요.
- 사용자 메시지가 명확한 외부 주제/개념을 명명하고(예: "태양계를 소개하는 프로모션 비디오를 만들어 줘") 워크스페이스에
app/frontend또는 홍보할 애플리케이션 코드가 없는 경우 → 주제 프로모션. - 사용자 메시지가 기존
app/frontend빌드, 에이전트가 생성 중인 진행 중인 앱, 또는 곧 출시될 기능을 참조하는 경우 → 프로젝트 프로모션. - 둘 다 해당하는 경우(예: "태양계 설명 앱의 프로모션을 만들어 줘") 앱을 기본으로 취급하고 주제를 지원 주제로 사용합니다. 이것은 프로젝트 프로모션입니다.
주제 프로모션은 일급 시민입니다. 워크스페이스에 app/frontend가 없더라도 주제 프로모션을 거부하거나 지연시키지 마세요.
프로젝트 프로모션의 경우 코드를 읽기 전에 소스 앱 ID를 확인하세요. 소스 앱은 현재 워크스페이스 앱, 동일한 대화에서 이전에 빌드된 앱, 또는 사용자가 명시적으로 참조한 다른 기존 프로젝트일 수 있습니다. 현재 app/promo 워크스페이스가 홍보되는 대상이라고 가정하지 마세요.
규정 준수 기준
프로모션 비디오는 기본적으로 보수적인 광고 안전 규칙을 따라야 합니다. 사용자 요청, 프로젝트, 광고 문구 또는 랜딩 페이지에 있는 주장, 제안, 가격, 할인, 선물, 브랜드 이름, CTA, 인증, 판매 수치, 효과 및 서비스만 사용하세요. 소스 자료가 명시적으로 제공하지 않는 한 공식 파트너십, 플랫폼 추천, 브랜드 보증 또는 인증을 암시하지 마세요.
보장된 결과, 절대적 순위, 무위험 약속, 가짜 희소성, 가짜 카운트다운, 가짜 알림, 가짜 버튼, 가짜 시스템 UI, 가짜 사용후기, 가짜 리뷰, 가짜 뉴스 또는 과장된 결과 스크린샷과 같은 오해의 소지가 있거나 확인할 수 없는 주장을 사용하지 마세요. 건강, 재정, 나이, 인종, 종교, 성적 취향, 장애, 결혼 여부, 체형 또는 외모와 같은 민감한 개인 속성을 직접 타겟팅하지 마세요. 대신 중립적인 대상 표현을 사용하세요.
라이선스 없는 브랜드 마크, 식별 가능한 사람, 저작권 보호 캐릭터, 타사 제품 UI, 미디어, 글꼴, 워터마크, 성인 콘텐츠, 고어, 충격, 증오, 괴롭힘, 굴욕적인 콘텐츠, 무기, 마약, 도박, 담배 또는 정치적으로 민감한 자료를 포함하지 마세요. 의료, 보충제, 체중 감량, 미용 시술, 금융, 대출, 암호화폐, 도박, 알코올, 데이트, 아동, 법률, 채용, 부동산, 정치, 종교 또는 사회 문제와 같은 고위험 범주의 경우 비디오를 정보 제공용으로 유지하고 강력한 약속, 극적인 전후 시각 자료 또는 공격적인 전환 압력을 피하세요.
영상은 선명하고 안정적이며 고품질로 유지하세요: 깜빡임, 심각한 압축, 늘어짐, 워터마크, 자산 크기 조정 불량으로 인한 검은 막대, 또는 가장자리가 잘린 자막/로고/CTA가 없어야 합니다. 규정 준수가 불확실한 경우 더 안전하고 중립적이며 정보 중심의 표현을 선택하세요. 이 기준은 위험을 줄이지만 플랫폼 승인을 보장하지는 않습니다.
최종 전환 CTA는 대화형 웹 UI가 아닌 정적 비디오 콘텐츠입니다. 클릭 가능한 웹사이트 버튼, 가짜 클릭 대상, 화살표 버튼, 가짜 입력, 가짜 팝업, 가짜 시스템 UI, 커서 대상, 호버/누름 상태 또는 시청자가 클릭하여 탐색할 수 있음을 암시하는 컨트롤로 마감 CTA를 렌더링하지 마세요. 대신 엔드 카드 라인, 브랜드 태그라인, 계정 핸들, URL, QR 자리 표시자 또는 일반 "방문 / 스캔 / 팔로우" 텍스트를 사용하세요. 제품 데모 및 페이지 둘러보기는 제품 흐름을 시연할 때 실제 또는 시뮬레이션된 UI 버튼, 양식 및 탐색을 표시할 수 있지만 최종 전환 CTA가 되어서는 안 됩니다.
표시되는 모든 URL, 계정 핸들, QR 대상, 브라우저 주소 표시줄 텍스트 또는 브랜드 엔드포인트는 사용자 요청, 확인된 프로젝트 소스, 랜딩 페이지 또는 기타 확인된 자산에서 제공되어야 합니다. 프로젝트에 자리 표시자 도메인만 있거나 확인된 공개 주소가 없는 경우 URL을 생략하고 대신 브랜드 카피로 종료하고, 브라우저 창 처리의 경우 URL이 아닌 페이지 레이블을 사용하거나 주소 표시줄을 비워 두세요. 앱 이름, 저장소 이름, 다운로드 파일 이름, 템플릿 자리 표시자, env var 토큰 또는 유사한 힌트에서 도메인, 핸들 또는 대상을 유추하지 마세요.
핵심 워크플로
app/promo가 아직 준비되지 않은 경우FrontendEngineer.use_template("remotion")으로 Remotion 프로젝트를 초기화합니다. 도구 자체가 복사하기 전에 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를 만듭니다. 주제 유형과 일치하는 필드 세트를 사용합니다(스토리보드 요구사항 참조). 프로모/Remotion 실행의 경우promo_storyboard.md가 유일한 계획 산출물입니다. 별도의todo.md를 만들거나 유지하지 마세요. - 사용자가 내레이션, 음성 해설, 음성 안내를 요청하거나 스토리보드에 분명히 내레이터가 필요한 경우 스토리보드에 짧은 세그먼트 내레이션 계획을 포함하고, 각 세그먼트의 스크립트 길이를 대상 샷 초와 비교한 다음
audio-generation을 읽고 샷/비트당 하나의 요청으로AudioCreator.generate_audios를 호출합니다. - TTS 생성 후 각 오디오 세그먼트의 반환된
duration을 선호합니다.duration이 없거나null인 경우 반환된 URL(예:ffprobe사용)에서 실제 지속 시간을 측정한 다음 측정된 지속 시간에서 최종 샷별 타이밍을 결정합니다. 이 계산이 생각이나 터미널 출력에만 나타나는 것으로는 충분하지 않습니다. - 각 내레이션 URL, 측정된 오디오 초, 최종 샷 시작/종료/지속 시간, 총 지속 시간 및 스크립트/타이밍 변경 사항으로
promo_storyboard.md를 즉시 업데이트합니다. 이것은 하드 체크포인트입니다.MusicCreator.generate_music,VideoCreator.generate_videos를 호출하거나 더 많은 시각적 자산을 생성하거나src/timeline.ts를 작성하기 전에 업데이트된 타이밍이promo_storyboard.md에 저장되어 있어야 합니다. 이 잠금 후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, 타이머 또는 기타 비결정적 패턴 없음), 동일한 패스에서 변경된src/timeline.ts/src/PromoVideo.tsx/src/scenes/*계약을 업데이트합니다.- 순서대로 검증을 실행합니다:
verify:versions,lint,verify:compositions.verify:compositions통과는 Remotion이 구성을 볼 수 있다는 것만 증명하며, 전달 가능한 항목이 아니며 유효한 중단점이 아닙니다. - 스토리보드/내보내기 사양에 기록된 대상 해상도로
RemotionPromoRenderer.render를 실행합니다. 내부적으로 스모크 + 전체 렌더를 수행합니다. 세로/9:16 비디오의 경우 가로 예제를 복사하는 대신width=1080,height=1920및source_orientation=portrait를 사용하세요.out/promo-<width>x<height>.mp4가 존재하고 비어 있지 않은 경우에만 완료됩니다. 이 도구가 성공하기 전에 비디오를 내보낼 준비가 되었다고 사용자에게 알리거나, 내보내기를 요청하거나,RoleZero.reply_to_human을 호출하거나,<end></end>를 사용하지 마세요.
스토리보드 요구사항
promo_storyboard.md는 주제에 특화되어야 합니다. 주제 유형과 일치하는 필드 세트를 선택하세요.
모든 스토리보드에는 다음이 포함되어야 합니다:
- 규정 준수 노트: 지원되는 주장/제안/자산, 주제가 고위험인지 여부, 보수적인 표현 선택 및 피해야 할 시각적/카피/자산 위험.
- CTA 처리: 최종 CTA가 정적 비디오인지 여부를 기록합니다.
…[번역을 위해 잘림]