使用時機
當使用者要求製作宣傳影片、產品影片、展示影片、行銷影片、上市影片、解說影片、品牌影片、設計影片、多鏡頭影片、分鏡腳本影片、社群/Reels/TikTok 探索影片、本地商家影片、餐廳/美食 vlog 風格影片、20 秒以上編輯影片,或任何以視覺方式介紹主題的完整影片時,請使用此技能。
只要請求描述的是包含時間軸、鏡頭、字幕、音訊、鏡頭語言、視覺風格、一致性要求、CTA/結束卡或多個場景的完整編輯影片,即使使用者從未說出「宣傳」或「promotional」,也應優先選擇此 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,也不應拒絕或拖延主題宣傳。
對於專案宣傳,請在閱讀程式碼之前先釐清來源應用程式的身份。來源應用程式可能是當前工作區的應用程式、在同一對話中較早建立的應用程式,或使用者明確引用的其他現有專案。請勿假設當前的 app/promo 工作區就是要宣傳的對象。
合規基準
宣傳影片預設必須遵守保守的廣告安全規則。僅使用存在於使用者請求、專案、廣告文案或登入頁面中的聲明、優惠、價格、折扣、贈品、品牌名稱、CTA、認證、銷售數據、效果和服務。除非來源材料明確提供,否則不得暗示官方合作關係、平台推薦、品牌背書或認證。
請勿使用誤導性或無法驗證的聲明,例如保證的結果、絕對排名、無風險承諾、虛假稀缺、虛假倒數、虛假通知、虛假按鈕、虛假系統 UI、虛假推薦、虛假評論、虛假新聞或誇大的結果螢幕截圖。請勿直接針對敏感個人屬性,例如健康、財務、年齡、種族、宗教、性取向、殘疾、婚姻狀況、體型或外貌;請改用中性受眾措辭。
請勿包含未經授權的品牌標誌、可識別的人物、受版權保護的角色、第三方產品 UI、媒體、字型、浮水印、成人內容、血腥、震驚、仇恨、騷擾、羞辱性內容、武器、毒品、賭博、菸草或政治敏感材料。對於高風險類別,例如醫療、保健食品、減肥、美容整形、金融、貸款、加密貨幣、賭博、酒精、約會、兒童、法律、招募、房地產、政治、宗教或社會議題,請保持影片的資訊性,避免強烈的承諾、戲劇性的前後對比視覺效果或激進的轉換壓力。
保持素材清晰、穩定且高品質:無閃爍、嚴重壓縮、拉伸、浮水印、因資產尺寸不當造成的黑邊,或邊緣被裁切的字幕/標誌/CTA。如果對合規性不確定,請選擇更安全、更中性、資訊優先的表達方式。此基準可降低風險,但並非平台核准的保證。
最終的轉換 CTA 是靜態影片內容,而非互動式網頁 UI。請勿將結尾 CTA 渲染為看起來可點擊的網站按鈕、虛假點擊目標、箭頭按鈕、虛假輸入框、虛假彈出視窗、虛假系統 UI、游標目標、懸停/按下狀態,或任何暗示觀看者可以點擊導航的控制項。請改用結束卡行、品牌標語、帳號、URL、QR 碼佔位符,或純文字的「造訪 / 掃描 / 追蹤」文字。產品展示和頁面導覽可以顯示真實或模擬的 UI 按鈕、表單和導航,以展示產品流程,但不得成為最終的轉換 CTA。
任何可見的 URL、帳號 ID、QR 碼目標、瀏覽器網址列文字或品牌端點,都必須來自使用者的請求、已確認的專案來源、登入頁面或其他經過驗證的資產。如果專案僅提供佔位符網域或沒有已確認的公開地址,請省略 URL,改為使用品牌文案結尾;對於瀏覽器視窗處理,請使用非 URL 頁面標籤或將網址列留空。請勿從應用程式名稱、儲存庫名稱、下載檔案名稱、範本佔位符、環境變數 Token 或類似提示推斷網域、ID 或目的地。
核心工作流程
- 如果
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,以便視覺計畫基於實際的圖片內容而非檔案名稱。 - 如果使用者提供了網站 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。這是一個硬性檢查點:在更新的時間持久化到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 時間已在
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}、保持 Motion 純粹由影格驅動(無 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-<寬度>x<高度>.mp4存在且非空時,任務才算完成。在此工具成功之前,請勿告訴使用者影片已準備好導出、要求他們導出、呼叫RoleZero.reply_to_human或使用<end></end>。
分鏡腳本要求
promo_storyboard.md 必須特定於該主題。選擇與主題類型匹配的欄位集:
每個分鏡腳本都必須包含:
- 合規性說明:支援的聲明/優惠/資產、主題是否屬於高風險、選擇的保守措辭,以及要避免的視覺/文案/資產風險。
- CTA 處理:記錄最終 CTA 是否是靜態影片