Communitygithub.com

reels-templates

一次產出 9:16 的 Reels / TikTok 廣告,從素材、照片或簡報出發,使用本技能內建的十五個 Remotion 範本。

reels-templates 是什麼?

此技能專為自主代理程式設計,可根據素材、照片或簡報,一鍵產出 9:16 的 Reels / TikTok 廣告。它內建十五個由 Remotion 驅動的資料驅動範本,涵蓋「社交原生」格式(如文字訊息故事、筆記應用列表、搜尋列、鎖定螢幕通知、拍立得照片牆、盲測排名、投票貼紙)與「廣告格式」(如節拍剪輯、UGC 逐字字幕、清單文、前後對比、產品輪播、見證、留言回覆、促銷)。代理程式只需選擇範本、填入屬性並執行渲染,無需手動編寫 React。該技能支援多語言渲染,並會自動處理素材管理、安全區域檢查與渲染後的清理作業,確保每次工作都能在無需人工介入的情況下順利完成。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/du-nguyen-IT007/remotion-reels-skills/tree/HEAD/skills/reels-templates

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Reels 範本

本技能內建十五個資料驅動的 Remotion 範本(1080x1920,60 fps),位於 assets/reels-kit/。一個影片即是一個 JSON 工作檔案:選擇範本、填入屬性、渲染。一般工作無需撰寫 React。

下列以 reels/ 開頭的路徑是指工作目錄,而非此技能目錄。切勿為了工作而編輯技能資料夾內的檔案。

可無人值守執行。 此技能專為自主代理程式設計。請求者 是發起工作的人:協調代理程式、管道或真人。根據此檔案中的規則做出所有決定,切勿為了請求步驟核准而停下。僅在遇到無法解決的障礙時(缺少工具、缺少或無法讀取的媒體、持續失敗的渲染)才停下並回報。每個工作皆以報告結尾(第 4 節)。

0. 設定工作區

每個專案僅需執行一次,於第一個工作開始之前。

  1. 檢查工具:Node.js 18 或更新版本(node -v),以及 ffmpeg 和 ffprobe 是否在 PATH 中。若缺少任一項,則停下並回報為障礙。請勿自行安裝系統軟體。
  2. 若工作目錄中已有 reels/render.mjs,則使用該工作區並跳至第 1 節。
  3. 否則,將此技能的 assets/reels-kit/ 資料夾複製到工作目錄的 reels/ 中(例如 cp -R <skill-dir>/assets/reels-kit reels),然後在 reels/ 內執行 npm install。
  4. 建立資料夾 reels/public/(媒體)和 reels/jobs/_local/(暫存工作)。若工作目錄是 git 儲存庫,則將 reels/node_modules/、reels/public/、reels/out/、reels/exports/ 和 reels/jobs/_local/ 加入其 .gitignore 檔案。

工作區包含 render.mjs(渲染工作)、clean.mjs(釋放磁碟空間,請參閱第 6 節)、src/(範本與共用套件)、jobs/examples/(每個範本各一個範例工作)、public/<name>/(每個工作的輸入媒體)、out/stills/(品質檢查靜態圖)和 exports/<name>/(每個工作的完成影片)。

偏好

此儲存庫不帶任何人的品味。文字樣式、字型、強調色、文案語氣、語言、音樂以及要優先使用的格式,皆來自請求者的簡報以及你對該品牌已知的資訊,絕非來自寫入範本或此檔案中的數值。當簡報中指定偏好時,請將其套用至工作檔案。若未指定,則使用範本預設值,並在報告中列出。請勿將個人或品牌的偏好寫入範本、範例工作或此技能中。

1. 選擇範本

當影片應感覺像是某人發布的內容時,請以社交原生範本為起點。當素材本身即為影片主體時,則使用廣告範本。

社交原生(觀看者熟悉的介面即為鉤子)

範本使用時機需要素材
ChatStory以文字訊息對話講述故事,然後揭露產品訊息(+ 一張產品照片以傳送)、回饋片段
NotesList筆記應用列表自動打字:「送禮地雷 vs 她留下的那個」標題 + 1 至 7 行、回饋片段
SearchHook顧客的問題輸入搜尋列,由素材回答查詢(+ 建議)、1 個以上片段
NotificationStack鎖定螢幕充滿訂單、訊息、評論:社會證明與錯失恐懼症1 至 6 則通知、背景、回饋片段
PolaroidDump剪貼簿照片牆搭配手寫標題2 至 8 張照片
Ranking盲測排名:項目掉入編號列表,#1 最後2 至 6 個片段、每個項目一個標籤與排名
PollSticker素材上的限時動態投票:兩個選項、點擊、結果一個問題、兩個選項與百分比、片段

廣告格式(素材優先,文字疊加其上)

範本使用時機需要素材
BeatCutAd從素材剪輯產品廣告的預設選項:多個鏡頭、鉤子、CTA1 個以上影片片段
UgcCaptions有人對著攝影機說話;逐字字幕1 個含語音 + 逐字時間戳記的片段
Listicle「三個理由為什麼」、祕訣、功能、步驟2 至 7 個片段,每個對應一個要點
BeforeAfter轉變或對比(mode:wipe 或 split)2 個片段或照片
ProductSlideshow僅有產品照片存在,或快速型錄;可選價格標籤2 張以上照片或片段
Testimonial社會證明:含星級的評論卡片1 個背景片段 + 評論文字
CommentReply回答異議或常見問題;評論泡泡是鉤子1 個以上片段 + 評論
OfferPromo促銷、折扣碼、截止日期1 個以上片段 + 優惠

若簡報不適合任何範本,請參閱第 7 節。請勿將範本扭曲成它原本不是的樣子。

官方 Remotion 技能(remotion-best-practices,可使用 npx skills add remotion-dev/skills --skill remotion-best-practices 個別安裝)是撰寫 Remotion 程式碼的參考。若尚未安裝,請改用 Remotion 文件 https://www.remotion.dev/docs。對於在此儲存庫中製作影片,此技能在兩者有所差異時優先適用:建立工作檔案而非新專案或合成、檢查靜態圖而非開啟 Studio,以及在靜態圖通過後使用 render.mjs 進行渲染,無需等待指示。

2. 建立工作

  1. 選擇工作名稱(小寫、數字和 -,例如 xmas-ornament)。它將作為工作檔案的 name、輸入資料夾 reels/public/<name>/ 和輸出資料夾 reels/exports/<name>/。僅將此工作會用到的檔案複製到 reels/public/<name>/ 中,並將原始檔案留在原位。在報告中註明每個輸入的來源,以及 public/ 中的副本是否為唯一一份(下載或產生的檔案)。將每個 src 寫為 <name>/<file>。對每個檔案執行 ffprobe 以取得其長度。媒體永不提交:public/ 已被 git 忽略,因此範例工作中的路徑(footage.mp4、music.m4a、demo/…)在你放入自己的檔案之前僅是佔位符。
  2. 在擺放文字前先查看素材:為每個鏡頭擷取一個影格(ffmpeg -ss <t> -i <file> -frames:v 1),並注意產品所在位置。
  3. 讀取 reels/jobs/examples/<Template>.json。它列出了該範本接受的每個屬性。將其複製到 reels/jobs/<job>.json 並編輯。對於不應進入 git 的工作,請使用 reels/jobs/_local/。

工作檔案:

{ "template": "BeatCutAd", "name": "xmas-ornament", "lang": "en",
  "props": { },
  "i18n": { "ja": { "hook": { "lines": ["…", "…"] }, "cta": { "lines": ["…"], "button": "…" } } } }

i18n.<lang> 會合併到 props 之上,因此它僅包含已翻譯的字串。物件陣列會逐項合併(null 則保留基礎項目);字串陣列則會取代。

每個範本共用的屬性:

  • hook:{ lines (1-3)、band、size、duration }。從 0 秒開始顯示,預設 2.2 秒。
  • cta:{ lines、button、band、size、duration }。在最後 duration 秒顯示,預設 2.5。其他字幕在其開始時結束。
  • music:{ src、volume }。結束時淡出。在語音下方使用約 0.15 的音量。
  • brand:{ accent(十六進位)、font:poppins | montserrat | anton、textStyle:outline | box | caption }。outline(預設)和 box 是華麗的廣告風格。caption 是原生應用程式字幕外觀:白色句子大小寫文字,位於一個深色圓角矩形內,在其帶狀區域頂部淡入;將其寫成第一人稱故事行,最多兩行,每行最多 30 個字元。
  • 一個片段:{ src、start(進入來源的秒數)、duration(在畫面上的秒數)、speed、focus(center | top | bottom | "50% 30%")、transition(cut | flash | zoom | whip | focus) }。transition 定義該片段如何進入。

片段也接受模擬攝影機:zoom(1-2.5,推進同時保持 focus 點的位置)、tilt(度數,-15 到 15,荷蘭角度)和 push(0-0.6,攝影機在片段進入時伴隨短暫模糊向前猛衝,然後穩定)。

工作檔案中省略的屬性即為關閉:沒有 hook 的工作就沒有鉤子,無論範例顯示為何。

src 是 public/ 內的路徑或 https URL。.jpg/.png/.webp 檔案會獲得緩慢推進效果,而非直接播放。

3. 規則

  • 安全區域。 所有文字應位於 x 140-940、y 288-1248 範圍內。範本透過三個帶狀區域強制執行此規則:top(y 288-600)、middle(600-930)、lower(930-1248)。你只需選擇帶狀區域。
  • 讓文字避開產品,除非簡報希望文字放在產品上。根據你擷取的影格選擇每個帶狀區域。若在一個鏡頭中,每個帶狀區域都覆蓋了產品,則縮短文字的 duration 或更換鏡頭。
  • 簡短行。 文字會縮小以適合 800 像素,因此長行會變小。目標為每行 22 個拉丁字元或 12 個日文字元。用 *星號* 包圍一個單詞,以使用強調色為其著色。
  • 片段長度。 start + duration * speed 不得超過來源的結尾。影片的總長度為所有片段持續時間的總和(BeforeAfter 使用 duration;Testimonial 為評論加上 CTA 的長度)。
  • 配合節拍剪輯 當有音樂時:讓片段持續時間加總起來符合節拍位置。
  • 字型。 支援拉丁文、越南文(montserrat 或 anton,以及所有介面卡片)和日文。韓文、泰文、阿拉伯文和其他語言需要先在 reels/src/lib/kit.tsx 中新增字型。

少量靜態片段,多種角度。 當素材是一兩個固定鏡頭,而簡報要求快速多角度剪輯(展示間導覽或趨勢舞蹈剪輯)時,請使用 BeatCutAd,並以不同的 focus、zoom、tilt 和 push 多次重複使用每個來源:以廣角鏡頭開場(zoom 約 1.02),然後每個節拍一個細節(文字、角色、姓名、手部、下擺),交替更改 tilt 的正負號,在 768 像素來源上將 zoom 保持在 1.7 或以下,最後以廣角結束。使用 cut 過場;push 即是過場效果。這會重新構圖素材;但無法創造真正的全新攝影角度。

範本備註:

  • ChatStory、NotesList、NotificationStack:介面先播放,然後 clips(回饋片段)閃入,CTA 在它們上方顯示。其長度為介面部分加上片段的長度。省略 hook:卡片填滿安全區域。background 是卡片後方變暗的媒體。
  • ChatStory:訊息根據閱讀時間自行調整節奏;僅在需要強制配合節拍時設定 at(秒)。訊息可以攜帶 image(產品照片)代替 text,或與 text 共存。
  • NotesList:check:true 會在一行打出來後打勾,highlight:true 則標記該行。將產品行放在最後。
  • SearchHook:pick 是被選取的建議。將查詢保持在 34 個字元以內。
  • NotificationStack:icon 是一個表情符號,color 是其磚塊顏色。根據語言翻譯 now 和 date。
  • PolaroidDump:接近正方形的照片效果最佳。title 是手寫體;說明文字保持在 20 個字元以內。沒有片段:照片本身就是影片。
  • Ranking:items 按照寫入的順序播放,因此請先寫最低排名,排名 1 最後。標籤保持在 20 個字元以內。
  • PollSticker:percent 值由你設定;當簡報中有真實數字時請使用真實數字,切勿將發明的數字呈現為調查數據。
  • 在這些介面中撰寫文案時,請模仿人們發簡訊和發文的方式:可以使用小寫、短行,以及在一般人會使用表情符號的地方使用表情符號。其中的姓名、訊息和評論僅為說明用途,除非簡報提供了真實內容,因此請勿將其歸因於真實人物。
  • UgcCaptions:words 是 { text、start、end },以輸出時間軸上的秒為單位。從帶有逐字時間戳記的逐字稿中獲取;請勿猜測時間點。keepAudio 預設為 true。一個「單詞」可以是短語,搭配 wordsPerPage:1。
  • CommentReply 和 OfferPromo:省略 hook。泡泡或標題已經使用了頂部帶狀區域。
  • OfferPromo:CTA 預設位於下方帶狀區域。Testimonial:將 CTA 帶狀區域設定為 middle。
  • ProductSlideshow:badge 接受 \n 以分為兩行;使用 badgeBand 放置。

4. 檢查,然後渲染

從 reels/ 執行這些指令。

node render.mjs jobs/<job>.json --still=1,6,12 --guides   # 安全區域帶狀線條繪製在頂部
node render.mjs jobs/<job>.json --still=1,6,12 --lang=en,ja
node render.mjs jobs/<job>.json                           # 所有語言 -> exports/<name>/

靜態圖會以半尺寸輸出到 out/stills/。開啟並檢查:文字避開產品、無內容被裁剪、每種語言都符合。在鉤子、中間字幕和 CTA 中選擇靜態圖的時間點。檔案名包含 _GUIDES 的僅供檢查用;切勿將其作為結果交付。

僅在靜態圖通過後才渲染影片。如果靜態圖失敗,修正工作並再次檢查;經過三輪失敗後,將其回報為障礙。渲染時會為每個檔案輸出一行,包含其路徑和長度。除非簡報要求,否則請勿發布或上傳影片。

每個工作結束時,向請求者提供一份報告。報告應涵蓋:

  • 輸出路徑和長度;
  • 所使用的範本,以及簡報未提及時所使用的預設值;
  • 每個輸入的來源,以及 public/ 中是否為唯一副本;
  • 第 6 節中的清理作業移除了哪些內容,以及釋放的空間量。

5. Instagram 尺寸

渲染出的影片約為 16 Mbps。若要壓縮以利上傳:

ffmpeg -i in.mp4 -c:v libx264 -crf 20 -maxrate 10M -bufsize 20M -c:a aac -ar 48000 -b:a 192k -movflags +faststart out.mp4

6. 媒體與磁碟空間

媒體是佔用磁碟空間的主要元兇。輸入(素材、照片、音樂複製到 public/<name>/)和輸出(exports/<name>/ 中的影片,15 秒約 30 MB per 語言)都屬於同一個工作,使用相同名稱。請保持此結構,因為清理作業是按工作進行的。其他所有項目均為暫存:out/ 中的品質檢查靜態圖,以及 Remotion 寫入作業系統暫存資料夾的臨時套件(每個套件都包含 public/ 的完整副本;render.mjs 會刪除自己的暫存,但崩潰的執行和 Studio 會留下一些)。node_modules/.cache 中的 webpack 快取會增長到數百 MB。node_modules/(約 1.3 GB,包含無頭瀏覽器)是一次性成本。重新渲染工作會以相同名稱覆寫其檔案,因此重複渲染一個工作不會堆積。

如果缺少 reels/clean.mjs(工作區是從較舊的套件建立的),請先將此技能 assets/reels-kit/ 中的 clean.mjs 和 render.mjs 複製到 reels/。

從 reels/ 執行這些指令,且切勿在渲染進行中執行:

node clean.mjs --auto --keep=<…>

[因原始內容截斷而截斷]

相關技能