使用するタイミング
ユーザーがプロモーションビデオ、製品ビデオ、デモビデオ、マーケティングビデオ、ローンチビデオ、説明ビデオ、ブランドビデオ、デザインビデオ、複数ショットのビデオ、ストーリーボード付きビデオ、ソーシャル/リール/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は、インタラクティブなWeb UIではなく、静的なビデオコンテンツです。クリック可能に見えるWebサイトボタン、偽のクリックターゲット、矢印ボタン、偽の入力、偽のポップアップ、偽のシステムUI、カーソルターゲット、ホバー/プレス状態、または視聴者がクリックして移動できることを示唆するコントロールとして、クロージングCTAをレンダリングしないでください。代わりに、エンドカードライン、ブランドタグライン、アカウントハンドル、URL、QRプレースホルダー、または「visit / scan / follow」などのプレーンテキストを使用してください。製品デモとページウォークスルーでは、製品フローを実証するために実際のまたはシミュレートされたUIボタン、フォーム、およびナビゲーションを表示してもかまいませんが、最終的なコンバージョンCTAになってはなりません。
表示されるURL、アカウントハンドル、QRターゲット、ブラウザのアドレスバーテキスト、またはブランドエンドポイントは、ユーザーのリクエスト、確認されたプロジェクトソース、ランディングページ、またはその他の検証済みアセットから取得する必要があります。プロジェクトがプレースホルダードメインのみを公開しているか、確認されたパブリックアドレスがない場合は、URLを省略し、代わりにブランドコピーで終了します。ブラウザウィンドウの表現の場合は、URL以外のページラベルを使用するか、アドレスバーを空白のままにします。アプリ名、リポジトリ名、ダウンロードファイル名、テンプレートプレースホルダー、env varトークン、または類似のヒントからドメイン、ハンドル、または宛先を推測しないでください。
コアワークフロー
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を使用)、それらの測定された期間から最終的なショットごとのタイミングを決定します。この計算は、思考またはターミナル出力にのみ表示されるだけでは十分ではありません。 - 各ナレーションURL、測定されたオーディオ秒数、最終的なショットの開始/終了/期間、合計期間、およびスクリプト/タイミングの変更を
promo_storyboard.mdに直ちに更新します。これはハードチェックポイントです:更新されたタイミングがpromo_storyboard.mdに永続化されるまで、MusicCreator.generate_music、VideoCreator.generate_videos、より多くのビジュアルアセットの生成、またはsrc/timeline.tsの作成を呼び出さないでください。 このロックの後、promo_storyboard.mdにはプレースホルダーのTBDタイミング行や古い合計期間を保持してはなりません。 - デフォルトでは、プロモビデオには、ユーザーが明示的に音楽を不要と言った場合、または作品が明らかに音楽なしの方が良い場合を除き、1つのグローバルなバックグラウンドミュージック計画も含める必要があります。
music-generationを読み、最終的なショットタイミングがロックされた後、MusicCreator.generate_musicを正確に1つのインストゥルメンタル/ボーカルなしのリクエストで呼び出します。プロンプトには、ターゲットの合計秒数、ムード、ペーシング、楽器編成、およびトラックがナレーションの余地を残すべきかどうかを含める必要があります。 - 音楽生成後、返されたURLを直接使用し、ナレーションと同様に返された
durationを優先します。durationがないかnullの場合は、ffprobeで実際のBGM期間を測定します。src/timeline.tsまたはsrc/PromoVideo.tsxを書く前に、BGM URL、測定秒数、ターゲット合計期間、フィット戦略、および計画されたミックス値をpromo_storyboard.mdに直ちに更新します。 ロックされたストーリーボード/タイムラインの期間が信頼できる情報源です。短い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/のようなサブディレクトリに移動しないでください。検証の前に、簡単な自己チェックを1回行います:未使用のインポート/変数を削除し、冗長な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が静的ビデオであるかどうかを記録します
…