使用時機
當使用者要求製作宣傳影片、產品影片、展示影片、行銷影片、上市影片、解說影片、品牌影片、設計影片、多鏡頭影片、分鏡影片、社交媒體/Reels/TikTok探索影片、在地商家影片、餐廳/美食部落格風格影片、產品廣告、電商/亞馬遜風格產品影片、包裝展示或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-<width>x<height>.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軟體產品,其廣告也顯示真實結帳畫面)由英雄鏡頭銷售的內容分類,並可能逐鏡頭借用其他類別的規則(例如商業宣傳中的一個ui-demo結帳節拍)。
主題宣傳和商業宣傳是一級分類。請勿僅僅因為工作區中沒有app/frontend而拒絕或拖延主題宣傳,也請勿僅僅因為產品沒有可重建的app/frontend而將商業宣傳降級為主題宣傳。
合規基準
宣傳影片預設必須遵守保守的廣告安全規則。僅使用使用者請求、專案、廣告文案或登陸頁面中存在的聲明、優惠、價格、折扣、禮物、品牌名稱、CTA、認證、銷售數據、效果和服務。除非來源資料明確提供,否則請勿暗示官方合作關係、平台推薦、品牌背書或認證。
請勿使用誤導性或無法驗證的聲明,例如保證結果、絕對排名、無風險承諾、虛假稀缺性、虛假倒數計時、虛假通知、虛假按鈕、虛假系統UI、虛假推薦、虛假評論、虛假新聞或誇大的結果截圖。請勿直接針對敏感個人屬性,例如健康、財務、年齡、種族、宗教、性取向、殘疾、婚姻狀況、體型或外表;請使用中性受眾措辭。
請勿包含未經許可的品牌標誌、可識別的人物、受版權保護的角色、第三方產品UI、媒體、字體、浮水印、成人內容、血腥、震驚、仇恨、騷擾、羞辱內容、武器、毒品、賭博、菸草或政治敏感素材。對於高風險類別,如醫療、保健食品、減肥、美容手術、金融、貸款、加密貨幣、賭博、酒精、交友、兒童、法律、招聘、房地產、政治、宗教或社會議題,請保持資訊性,避免強烈承諾、戲劇性的前後對比視覺或激進的轉換壓力。
保持畫面清晰、穩定和高品質:無閃爍、嚴重壓縮、拉伸、浮水印、由不良資產尺寸引起的黑邊,或邊緣裁剪的字幕/標誌/CTA。如果合規性不確定,請選擇更安全、更中性、資訊優先的表達方式。此基準可降低風險,但不能保證平台核准。
最終轉換CTA是靜態影片內容,而非互動式網頁UI。請勿將結尾CTA渲染為看起來可點擊的網站按鈕、虛假點擊目標、箭頭按鈕、虛假輸入框、虛假彈出視窗、虛假系統UI、游標目標、懸浮/按下狀態,或任何暗示觀眾可以點擊導航的控制項。請使用結尾卡行、品牌標語、帳號名稱、網址、QR碼佔位符,或純文字「造訪/掃描/追蹤」代替。產品展示和頁面導覽可以顯示真實或模擬的UI按鈕、表單和導航,以展示產品流程,但它們不得成為最終轉換CTA。
任何可見的網址、帳號名稱、QR碼目標、瀏覽器地址欄文字或品牌端點必須來自使用者的請求、確認的專案來源、登陸頁面或其他已驗證的資產。如果專案僅顯示佔位符網域或沒有確認的公開地址,請省略網址,並以品牌文案結尾;對於瀏覽器視窗處理,請使用非網址頁面標籤或保留地址欄為空白。請勿從應用程式名稱、儲存庫名稱、下載檔案名稱、範本佔位符、環境變數令牌或類似提示中推斷網域、帳號名稱或目的地。
核心工作流程
- 如果
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,以便視覺計畫基於實際圖片內容而非檔案名稱。 - 如果使用者提供了網站網址作為宣傳主題,請使用
Browser.goto造訪該頁面,然後使用Browser.take_screenshot擷取視覺畫面,然後在分鏡前對截圖呼叫ImageAnalyzer.analyze_images,以便視覺計畫基於實際頁面內容而非僅是網址。
- 專案宣傳:首先釐清被宣傳的來源應用程式,然後讀取該應用程式的
- 套用合規基準:確認哪些事實、聲明、優惠和資產實際受到請求、產品、廣告文案或登陸頁面的支援。請勿發明不支援的優惠、認證、銷售數據、效果、官方合作關係、平台背書或品牌支援;在不確定時,選擇保守的資訊優先措辭和視覺效果。
- 在撰寫
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,則從返回的網址測量實際持續時間(例如使用ffprobe),然後根據這些測量的持續時間決定最終每個鏡頭的時長。此計算如果僅出現在思考過程或終端輸出中是不夠的。 - 立即使用每個旁白網址、測量的音訊秒數、最終鏡頭開始/結束/持續時間、總持續時間以及任何腳本/時長變更來更新
promo_storyboard.md。這是一個硬性檢查點:在更新的時長資訊持久化到promo_storyboard.md之前,請勿呼叫MusicCreator.generate_music、VideoCreator.generate_videos、生成更多視覺資產或編寫src/timeline.ts。 在此鎖定之後,promo_storyboard.md不得再保留佔位符TBD時間行或過時的總持續時間。 - 預設情況下,宣傳影片也應包含一個全局背景音樂計畫,除非使用者明確表示不要音樂,或該作品明顯更適合無音樂。閱讀
music-generation並在最終鏡頭時長鎖定後,使用一個純器樂/無人聲請求呼叫MusicCreator.generate_music。提示必須包括目標總秒數、情緒、節奏、樂器編制,以及該曲目是否應為旁白留出空間。 - 音樂生成後,像旁白一樣直接使用返回的網址,並優先使用返回的
duration。如果duration缺失或null,使用ffprobe測量實際BGM持續時間。在編寫src/timeline.ts或src/PromoVideo.tsx之前,立即使用BGM網址、測量的秒數、目標總持續時間、配合策略和計劃的混音值來更新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/等子目錄中。在驗證之前,進行一次快速自我檢查:移除未使用的導入/變數、省略冗餘的Sequence from={0},保持動畫純粹由影格驅動(沒有CSSanimation/transition)。