使用するタイミング
ユーザーがプロモーションビデオ、製品ビデオ、デモビデオ、マーケティングビデオ、ローンチビデオ、エクスプロイナービデオ、ブランドビデオ、デザインビデオ、マルチショットビデオ、ストーリーボード付きビデオ、ソーシャル/リール/TikTokディスカバリービデオ、ローカルビジネスビデオ、レストラン/フードブログスタイルビデオ、製品広告、eコマース/Amazonスタイル製品ビデオ、パックショットまたは360度製品スピンビデオ、店舗紹介/探店ビデオ、DTC/ダイレクトレスポンス/ビフォーアフターコンバージョン広告、20秒以上の編集ビデオ、または被写体を視覚的に紹介する完全なビデオを要求した場合に、このスキルを使用します。
リクエストが、タイムライン、ショット、キャプション、オーディオ、カメラ言語、ビジュアルスタイル、一貫性要件、CTA/エンドカード、または複数のシーンを含む完全な編集済みビデオを説明している場合は、ユーザーが「プロモ」や「プロモーション」と一度も言わなくても、このRemotionワークフローを優先してください。直接的なAIビデオ生成は、単一の短いソースクリップやバックグラウンドループにのみ使用し、完全なマルチショットビデオの最終的な配信パスとしては使用しないでください。
ビデオの被写体は、次のいずれかになります。
- プロジェクトプロモーション — エージェント自身が構築中、またはワークスペースにすでに存在するプロジェクト、アプリ、機能、あるいはユーザーのリクエストまたは事前に確認されたコンテキストですでに特定されている別の既存アプリ。まず、宣伝される ソースアプリ を特定します。
app/promoは出力ビデオプロジェクトであり、自動的にソースアプリになるわけではありません。 - トピックプロモーション — ユーザーが指定したトピック、コンセプト、ブランド、またはワークスペースプロジェクトを必要としない外部の被写体。例:「太陽系」、「宋の歴史」、「ベクトルデータベースとは」。
どちらのパスも、同じRemotionテンプレート、同じコンポジションプリセット、同じレンダリングコマンドを共有します。異なるのはストーリーボードの作成のみです。
コマンド
検証後の最終プロモ輸出には、RemotionPromoRenderer.render を使用します。このコマンドはこのスキルによって文書化されており、<Available Commands> にリストされていない場合でも呼び出すことができます。
**width/height/source_orientation は、ストーリーボードの「出力仕様」に従わなければなりません。以下の例は、横向きの値をプレースホルダーとして示しています。ストーリーボードが縦向きの場合は、width=1080 height=1920 source_orientation=portrait を渡します(正方形の場合は 1080/1080/square)。出力ファイル名は promo-<幅>x<高さ>.mp4 です。そのため、1920x1080 を誤って使用した縦向きレンダリングは、ストーリーボードを読まずに例をコピーしたことの兆候です。
<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>WIDTH_FROM_STORYBOARD</width>
<height>HEIGHT_FROM_STORYBOARD</height>
<source_orientation>ORIENTATION_FROM_STORYBOARD</source_orientation>
</RemotionPromoRenderer.render>
被写体の分類
他のすべての作業の前に、元のユーザーリクエストから被写体を分類します。リクエストにすでにトピックやプロジェクトが記載されている場合は、ユーザーに確認を求めないでください。
- ユーザーメッセージが明確な外部トピック/コンセプトに言及しており(例:「做一個介紹太陽系的宣傳視頻」)、ワークスペースに
app/frontendや宣伝するアプリケーションコードがない場合 → トピックプロモーション。 - ユーザーメッセージが既存の
app/frontendビルド、エージェントが生成してきた進行中のアプリ、または今後の機能を参照している場合 → プロジェクトプロモーション。 - 被写体が物理的な製品、小売/ローカルビジネスや場所、再構築可能なアプリUIを主な被写体としないダイレクトレスポンスオファーである場合(例:カーディフューザー広告、ジュエリー360度スピン、ラーメン店の探店、ペットの毛取りDTC広告) → コマースプロモーション。
- 両方が該当する場合(例:「私たちの太陽系解説アプリのプロモを作って」)→ アプリを主とし、トピックを補助的な被写体として扱います。これはプロジェクトプロモーションです。
複数が該当する可能性がある場合、以下のタイブレーカーを使用します。再構築可能なソフトウェアUIが被写体 → プロジェクトプロモーション。物理的な製品/物理的な場所/再構築可能なUIがないオファー → コマースプロモーション。製品がない外部のコンセプトや知識 → トピックプロモーション。混合ケース(例えば、実際のチェックアウト画面も表示するDTCソフトウェア製品の広告)は、ヒーローショットが何を販売しているかによって分類され、ショットごとに他のクラスのルールを借用する場合があります(例えば、コマースプロモーション内の1つの ui-demo チェックアウトビート)。
トピックプロモーションとコマースプロモーションは第一級の市民です。ワークスペースに app/frontend がないという理由だけでトピックプロモーションを拒否したり保留したりせず、製品に再構築する app/frontend がないという理由だけでコマースプロモーションをトピックプロモーションに格下げしないでください。
コンプライアンスベースライン
プロモーションビデオは、デフォルトで保守的な広告安全性ルールに従わなければなりません。ユーザーのリクエスト、プロジェクト、広告コピー、またはランディングページに存在する請求、オファー、価格、割引、ギフト、ブランド名、CTA、認定、販売数、エフェクト、およびサービスのみを使用してください。ソース資料が明示的に提供しない限り、公式パートナーシップ、プラットフォームの推奨、ブランドの推薦、または認定を暗示しないでください。
保証された結果、絶対的なランキング、リスクフリーの約束、偽の希少性、偽のカウントダウン、偽の通知、偽のボタン、偽のシステムUI、偽の推薦文、偽のレビュー、偽のニュース、誇張された結果のスクリーンショットなど、誤解を招くまたは検証不可能な主張を使用しないでください。健康、財務、年齢、人種、宗教、セクシュアリティ、障害、婚status、体型、外見などの機密性の高い個人属性を直接ターゲットにしないでください。代わりに中立的なオーディエンスの表現を使用してください。
ライセンス未取得のブランドマーク、認識可能な人物、著作権で保護されたキャラクター、サードパーティ製品のUI、メディア、フォント、透かし、成人向けコンテンツ、グロテスク、ショック、ヘイト、ハラスメント、屈辱的なコンテンツ、武器、薬物、ギャンブル、タバコ、政治的敏感な素材を含めないでください。医療、サプリメント、減量、美容整形、金融、ローン、暗号通貨、ギャンブル、アルコール、デート、子供、法律、採用、不動産、政治、宗教、社会問題などのハイリスクカテゴリについては、ビデオの情報提供に徹し、強い約束、劇的なビフォーアフターのビジュアル、または攻撃的なコンバージョン圧力を避けてください。
映像は鮮明で安定しており、高品質に保ってください。フリッカー、深刻な圧縮、引き伸ばし、透かし、アセットサイズの不一致による黒帯、端が切れた字幕/ロゴ/CTAがないようにします。コンプライアンスに確信が持てない場合は、より安全で中立的、情報第一の表現を選択してください。このベースラインはリスクを低減しますが、プラットフォームの承認を保証するものではありません。
最終的なコンバージョンCTAは、インタラクティブなWeb UIではなく、静的なビデオコンテンツです。クロージングCTAを、クリック可能に見えるWebサイトのボタン、偽のクリックターゲット、矢印ボタン、偽の入力、偽のポップアップ、偽のシステムUI、カーソルターゲット、ホバー/プレス状態、または視聴者がクリックして移動できることを暗示するコントロールとしてレンダリングしないでください。代わりに、エンドカードのライン、ブランドタグライン、アカウントハンドル、URL、QRプレースホルダー、または「訪問/スキャン/フォロー」のプレーンテキストを使用してください。製品デモとページウォークスルーでは、製品フローを示すために実際またはシミュレートされたUIボタン、フォーム、およびナビゲーションを表示してもかまいませんが、これらが最終的なコンバージョンCTAになってはなりません。
表示されるURL、アカウントハンドル、QRターゲット、ブラウザアドレスバーのテキスト、またはブランドエンドポイントは、ユーザーのリクエスト、確認されたプロジェクトソース、ランディングページ、またはその他の検証済みアセットからのものでなければなりません。プロジェクトがプレースホルダードメインのみを公開している場合、または確認された公開アドレスがない場合は、URLを省略し、代わりにブランドコピーで終了します。ブラウザウィンドウの処理の場合は、非URLのページラベルを使用するか、アドレスバーを空白のままにします。アプリ名、リポジトリ名、ダウンロードファイル名、テンプレートプレースホルダー、環境変数トークン、または同様のヒントからドメイン、ハンドル、または宛先を推測しないでください。
コアワークフロー
app/promoがまだ準備できていない場合は、FrontendEngineer.use_template("remotion")を使用してRemotionプロジェクトを初期化します。このツール自体が、コピー前にRemotion以外のソースを拒否するため、個別の確認手順は必要ありません。- ユーザーリクエストとストーリーボード計画から、ターゲットの向き(横向き (16:9)、縦向き (9:16)、または正方形 (1:1))を事前に選択します。後のすべての検証、スモーク、およびフルレンダリングコマンドは、一致するバリアントを使用する必要があります。
- 上記の 被写体の分類 を使用して、被写体(プロジェクトプロモーション vs. トピックプロモーション)を分類します。元のリクエストにすでにトピックまたはプロジェクトが記載されている場合は、「これは何についてですか?」と確認するために停止しないでください。
- 被写体を具体化します。
- プロジェクトプロモーション: 最初に宣伝されるソースアプリを特定し、そのアプリの
app/frontendソース、マニフェスト、および以前の検証フィードバックを読みます。現在のワークスペースに主にプロモ出力が含まれている場合、app/promo自体をソースアプリとして扱わないでください。ソースアプリを特定したら、そのソースプロジェクトルート/フロントエンドパスをpromo_storyboard.mdまたは作業メモにロックし、app/promoに切り替えた後も同じパスを再利用し続けてください。プロモワークスペース自体にapp/frontendがないという理由だけでトピックプロモーションに格下げしないでください。Remotionコードを記述する前に、依存する主要なソースフロントエンドファイルパスをpromo_storyboard.mdに記録します(デモビートのページ/ルート/コンポーネント)。後でsrc/を実装するときに、それらのソースファイルを再度開き、長い散文の要約に頼るのではなく、コードからコピー/再作成します。 - トピックプロモーション: ユーザーメッセージと以前の会話から被写体を抽出します。必要に応じて、自身の知識または外部ツール(画像/ビデオ/オーディオ生成、検索(利用可能な場合))から追加の事実を取得します。ワークスペースプロジェクトが存在する必要はありません。
- ユーザーが参照画像を提供したが、現在のリクエストが画像コンテンツの代わりにファイルパスのみを公開している場合は、ストーリーボードを作成する前に
image-understandingを読み、ImageAnalyzer.analyze_imagesを呼び出して、ビジュアル計画がファイル名ではなく実際の画像コンテンツに基づいているようにします。 - ユーザーがプロモの被写体としてWebサイトの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を読み、ショット/ビートごとに1つのリクエストでAudioCreator.generate_audiosを呼び出します。 - TTS生成後、各オーディオセグメントの返された
durationを優先します。durationがないかnullの場合は、返されたURLから実際の長さを測定し(例:ffprobeを使用)、その測定された長さから最終的なショットごとのタイミングを決定します。この計算が思考またはターミナル出力にのみ表示されるだけでは不十分です。 promo_storyboard.mdを、各ナレーションURL、測定されたオーディオ秒数、最終的なショットの開始/終了/長さ、合計時間、およびスクリプト/タイミングの変更ですぐに更新します。これは厳格なチェックポイントです。更新されたタイミングがpromo_storyboard.mdに永続化されるまで、MusicCreator.generate_music、VideoCreator.generate_videosを呼び出したり、より多くのビジュアルアセットを生成したり、src/timeline.tsを作成したりしないでください。 このロックの後、promo_storyboard.mdにプレースホルダーのTBDタイミング行や古い合計時間を保持してはなりません。- デフォルトでは、プロモーションビデオには、ユーザーが明示的に音楽を禁止した場合、または音楽がない方が明らかに良い場合を除き、1つのグローバルなバックグラウンドミュージック計画も含める必要があります。
music-generationを読み、最終的なショットタイミングがロックされた後、正確に1つのインストゥルメンタル/ボーカルなしのリクエストでMusicCreator.generate_musicを呼び出します。プロンプトには、ターゲットの合計秒数、雰囲気、ペース、楽器編成、およびトラックがナレーションの余地を残すべきかどうかを含める必要があります。 - 音楽生成後、ナレーションと同様に、返されたURLを直接使用し、返された
durationを優先します。durationがないかnullの場合は、ffprobeで実際のBGMの長さを測定します。src/timeline.tsまたはsrc/PromoVideo.tsxを作成する前に、promo_storyboard.mdをBGMのURL、測定された秒数、ターゲットの合計時間、フィット戦略、および計画されたミックス値ですぐに更新します。 ロックされたストーリーボード/タイムラインの長さが信頼できる情報源です。ユーザーが明示的に短いカットを要求した場合を除き、短いBGMに合わせるためだけにビデオを短くしないでください。代わりに、トリミングするか、最小限ループするか、音楽を再生成してください。 promo_storyboard.mdが作成され、ナレーションとBGMのタイミングが解決された後、その他必要な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/のようなサブディレクトリに移動しないでください。検証前に、簡単なセルフチェックを1回行います。未使用のインポート/変数を削除し、冗長なSequence from={0}を省略し、モーションを純粋にフレーム駆動に保ちます(CSS のanimation/transition、タイムラインのない「if」ロジックは避けてください)。