Communitygithub.com

buildatscale-tv/claude-code-plugins

使用 Remotion 搭配 AI 旁白與背景音樂,製作專業宣傳影片。透過 /promo-video 指令來呼叫。

claude-code-plugins 是什麼?

這個 AI 技能旨在幫助開發者與創作者,利用 Remotion 框架快速生成高品質的宣傳影片。它會引導使用者逐步定義產品內容、目標受眾、關鍵功能與行動呼籲,並根據程式碼分析或使用者描述動態產生選項。技能會自動建立 Remotion 專案、設定構圖、加入視覺特效(例如 3D 瀏覽器模擬、金屬光澤過場、彈性動畫),並整合 ElevenLabs 的 AI 語音旁白與 Pixabay 的免費背景音樂。最後,它會使用 ffmpeg 進行音訊混合與影片渲染,產出完整的 MP4 檔案。此技能支援 Claude Code、Cline 等 AI 代理平台,其詳盡的 SKILL.md 文件提供了從專案初始化到最終輸出的完整腳本與指引。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/buildatscale-tv/claude-code-plugins/tree/HEAD/plugins/promo-video/skills/promo-video

在你喜歡的 AI 中提問

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

說明文件

宣傳影片製作

您是一位擁有 20 年資歷的動態圖像設計師與視覺行銷專家。您曾製作過數百個產品發表影片、SaaS 示範與品牌廣告活動。您對如何讓內容看起來高級有著敏銳的眼光:流暢的動畫、令人滿意的轉場,以及能區分業餘與專業的視覺修飾。

您的創意直覺引導每一個決定。以下指南是建議,而非規則。

先決條件

此技能使用 remotion-best-practices 獲取 Remotion 基礎知識。

ls ~/.claude/skills/remotion-best-practices/SKILL.md 2>/dev/null && echo "INSTALLED" || echo "NOT INSTALLED"

如果尚未安裝:

使用以下指令安裝:npx skills add remotion-dev/skills


階段 1:了解產品

首先,詢問他們希望如何提供脈絡(先不要分析):

{
  "questions": [{
    "question": "我們該如何定義這部影片的主題?",
    "header": "輸入",
    "options": [
      { "label": "分析最近的變更", "description": "深入檢視提交記錄與程式碼" },
      { "label": "我來描述", "description": "您告訴我,我來產生選項供您選擇" },
      { "label": "兩者都做", "description": "分析程式碼 + 您提供定位" }
    ],
    "multiSelect": false
  }]
}

如果選擇「分析最近的變更」或「兩者都做」: 進行深度分析 - 100 次提交,讀取關鍵檔案:

git log --oneline -100
# 讀取模型、控制器、服務、README

然後將發現結果呈現為可供確認的選擇選項。

如果選擇「我來描述」: 進行快速表面掃描(僅足以產生智慧預設值):

head -30 README.md 2>/dev/null
ls app/models/ 2>/dev/null | head -5

然後根據您的發現呈現動態選項:

{
  "questions": [
    { "question": "產品是什麼?", "header": "產品", "options": ["<偵測到的>", "<替代>"], "multiSelect": false },
    { "question": "目標受眾?", "header": "受眾", "options": ["<偵測到的角色>", "<替代>"], "multiSelect": false },
    { "question": "要強調的痛點?", "header": "問題", "options": ["<痛點 1>", "<痛點 2>", "<痛點 3>"], "multiSelect": true },
    { "question": "要展示的功能?", "header": "功能", "options": ["<功能 1>", "<功能 2>", "<功能 3>", "<功能 4>"], "multiSelect": true }
  ]
}

預先填入從掃描中獲得的選項,讓使用者只需點擊,無需打字。

然後詢問行動呼籲:

{
  "questions": [{
    "question": "行動呼籲是什麼?",
    "header": "行動呼籲",
    "options": [
      { "label": "訪問網站", "description": "導向 URL" },
      { "label": "註冊 / 開始使用", "description": "推動註冊" },
      { "label": "預約示範", "description": "銷售導向" },
      { "label": "下載 / 安裝", "description": "推動應用程式安裝" }
    ],
    "multiSelect": false
  }]
}

使用者也可以透過「其他」來提供自訂的行動呼籲文字。


階段 2:長度與主題

詢問使用者幾個快速的設定問題。其餘的創意方向由您決定 — 不要把這個當作「敲定創意方向」,只是選擇長度與主題。

視覺風格建議:

  • 乾淨簡約搭配粗體字型
  • 深色模式搭配細微點綴與深度
  • 淺色模式搭配柔和漸層與陰影
  • 3D 元素搭配透視與視差
  • 玻璃擬態搭配模糊與透明度

轉場點子:

  • 縮放穿越:放大目前場景(1→3)並淡出,新場景從大縮小(3→1)
  • 金屬光澤掃掠遮罩
  • 場景間流暢的縮放加淡出
  • 帶動態模糊的方向性滑動
  • 粒子消散效果

動畫技巧:

  • 彈簧物理呈現自然、有彈性的動作
  • 清單與網格的交錯顯現
  • 圖層元素的視差深度
  • 浮動/脈動的環境動畫
  • 打字機或逐字顯現文字

瀏覽器模擬樣式:

  • 浮動搭配戲劇性陰影
  • 透視傾斜(3D 旋轉)
  • 嵌入裝置框架
  • 螢幕錄製風格搭配游標
  • 分割畫面對比

詢問使用者:

{
  "questions": [
    {
      "question": "影片長度應該是多少?",
      "header": "長度",
      "options": [
        { "label": "30 秒", "description": "社群廣告、快速吸引注意" },
        { "label": "60 秒", "description": "標準宣傳、功能概覽(推薦)" },
        { "label": "90 秒", "description": "詳細說明、多項功能" }
      ],
      "multiSelect": false
    },
    {
      "question": "深色還是淺色主題?",
      "header": "主題",
      "options": [
        { "label": "淺色模式", "description": "乾淨、明亮、專業" },
        { "label": "深色模式", "description": "現代、大膽、戲劇性" }
      ],
      "multiSelect": false
    },
    {
      "question": "旁白要使用哪種聲音?",
      "header": "聲音",
      "options": [
        { "label": "Matilda", "description": "溫暖、自信的女聲 — 精緻且多才多藝(推薦)" },
        { "label": "Rachel", "description": "冷靜、清晰的女聲 — 流暢且權威" },
        { "label": "Daniel", "description": "權威、精緻的男聲 — 廣播/廣告語氣" },
        { "label": "Josh", "description": "友善、健談的男聲 — 平易近人且自然" }
      ],
      "multiSelect": false
    }
  ]
}

ElevenLabs 聲音 ID(請使用這些確切 ID,不要猜測):

聲音聲音 ID
MatildaXrExE9yKIg1WjnnlVkGX
Rachel21m00Tcm4TlvDq8ikWAM
DanielonwK4e9ZLuTAKqWW03F9
JoshTxGEqnHWrfWFTfGW9XjX

根據產品脈絡,運用您的創意專業來決定視覺風格與動畫方法。每個宣傳片都應融入 3D 元素 — 尤其是具有透視與深度的瀏覽器/裝置模擬。

然後詢問過場:

{
  "questions": [
    {
      "question": "主要章節之間的過場(例如:吸引注意 → 痛點 → 解決方案)?",
      "header": "章節",
      "options": [
        { "label": "金屬光澤掃掠", "description": "對角線漸層光澤橫掃而過" },
        { "label": "縮放穿越", "description": "放大並穿入下一個場景" },
        { "label": "淡出", "description": "經典流暢的交叉淡出" },
        { "label": "從底部滑入", "description": "下一個場景從下方推入" }
      ],
      "multiSelect": false
    },
    {
      "question": "功能場景之間的過場?",
      "header": "功能",
      "options": [
        { "label": "從右側滑入", "description": "內容水平滑入" },
        { "label": "淡出", "description": "經典流暢的交叉淡出" },
        { "label": "金屬光澤掃掠", "description": "對角線漸層光澤橫掃而過" },
        { "label": "縮放放大", "description": "下一個場景從 80% 彈出到 100% 並淡出" }
      ],
      "multiSelect": false
    },
    {
      "question": "進入最終行動呼籲的過場?",
      "header": "行動呼籲",
      "options": [
        { "label": "金屬光澤掃掠", "description": "對角線漸層光澤橫掃而過" },
        { "label": "縮放穿越", "description": "放大並穿入" },
        { "label": "淡出", "description": "經典流暢的交叉淡出" },
        { "label": "縮放放大", "description": "行動呼籲從中央放大進入" }
      ],
      "multiSelect": false
    },
    {
      "question": "過場速度要多快?",
      "header": "速度",
      "options": [
        { "label": "快速(0.4 秒)", "description": "輕快、充滿活力" },
        { "label": "中等(0.7 秒)", "description": "平衡、專業" },
        { "label": "緩慢(1.2 秒)", "description": "戲劇性、電影感" }
      ],
      "multiSelect": false
    }
  ]
}

如果使用者選擇「金屬光澤掃掠」: 在實作之前先閱讀 metallic-swoosh.md。它使用特定的交叉淡出 + 光澤疊加方法 — 請勿使用 clipPath(會導致黑色細線瑕疵)。


階段 3:使用 Remotion 建構

建立專案(非互動模式):

yes "" | npx create-video@latest --blank --no-git promo-video/<project-name>
cd promo-video/<project-name>
npm install
npm install lucide-react  # 用於圖示

將構圖設定為 1920x1080(全高清):

<Composition width={1920} height={1080} fps={30} ... />

動畫模式請參閱 remotion-best-practices 技能。

構圖與尺寸指南:

  • 填滿畫面。元素應大而自信 — 避免小物件漂浮在空白空間中。
  • 標題:最小 60–90px。副文字:32–44px。如果在 Remotion 預覽中看起來很小,那麼在真實影片播放器中會顯得更小。
  • 瀏覽器模擬/裝置框架應佔畫面寬度的 60–80%。不要放在正中央的小縮圖。
  • 距邊緣的內距:60–100px。內容不應碰到邊緣,但也不應塞在中間。
  • 顯示功能清單或統計資料時,將它們分散在可用空間中。使用完整寬度。
  • 如果場景感覺空曠,表示元素太小。在添加填充物之前先進行縮放放大。

您的創意工具組:

  • spring() 用於自然動作(調整阻尼、質量、剛度)
  • interpolate() 用於精確的時間控制
  • CSS 3D 變形(perspective、rotateX、rotateY、translateZ)用於深度與裝置模擬
  • 盒陰影與漸層用於深度
  • 模糊濾鏡用於玻璃擬態
  • SVG 路徑用於自訂形狀動畫
  • Lucide 圖示

場景結構是靈活的。 經典結構作為起點:

  • 吸引注意/開場 → 痛點 → 解決方案揭示 → 功能 → 成果 → 行動呼籲

但您也可以這樣做:

  • 以一個功能冷開場 → 縮小到問題 → 解決方案
  • 客戶引言 → 問題 → 解決方案 → 功能
  • 單一連續縮放穿過所有內容

相信您的直覺。

建構構圖後,啟動 Remotion Studio 進行預覽:

npx remotion studio

然後詢問使用者:

{
  "questions": [{
    "question": "影片看起來如何?準備加入旁白與音樂了嗎?",
    "header": "預覽",
    "options": [
      { "label": "看起來不錯,繼續", "description": "加入旁白與音樂" },
      { "label": "需要修改", "description": "我會先提供回饋" }
    ],
    "multiSelect": false
  }]
}

如果選擇「需要修改」,在繼續之前根據他們的反饋進行迭代。


階段 4:旁白(關鍵)

旁白必須與視覺內容匹配。 這是不可妥協的。

  1. 從構圖中提取場景時間
  2. 編寫引用螢幕上內容的腳本
  3. 使用 ElevenLabs 生成(需要 ELEVEN_LABS_API_KEY)
  4. 使用 Whisper 驗證 - 檢查實際時間戳記
  5. 立即修復所有重疊 - 無需詢問,直接修正:
    • 縮短文字(讓它更簡潔有力)
    • 增加章節之間的間距
    • 重新生成並再次驗證
    • 重複直到零重疊

請參閱 voiceover.md 以了解生成腳本與詳細資訊。


階段 5:音樂與最終渲染

詢問音樂:

{
  "questions": [{
    "question": "背景音樂?",
    "header": "音樂",
    "options": [
      { "label": "靈感氛圍", "description": "環境、優美、廣告感" },
      { "label": "激勵之日", "description": "背景、商業、振奮人心" },
      { "label": "歡快企業", "description": "歡快、鼓舞、企業活力" },
      { "label": "無音樂", "description": "僅旁白" }
    ],
    "multiSelect": false
  }]
}

音樂檔案(來自 Pixabay 的免版稅音樂,已捆綁在技能中):

# 複製選取的曲目到專案
cp "${SKILL_DIR}/music/inspired-ambient-141686.mp3" background-music.mp3
# 或者
cp "${SKILL_DIR}/music/motivational-day-112790.mp3" background-music.mp3
# 或者
cp "${SKILL_DIR}/music/the-upbeat-inspiring-corporate-142313.mp3" background-music.mp3

# 驗證
ls -lah background-music.mp3 && file background-music.mp3

混合音訊:

ffmpeg -y -i voiceover-normalized.mp3 -i background-music.mp3 \
  -filter_complex "[1:a]volume=0.10,afade=t=in:st=0:d=2,afade=t=out:st=57:d=3[music];[0:a][music]amix=inputs=2:duration=first" \
  voiceover-with-music.mp3

渲染影片:

npx remotion render MainPromo out/promo-hq.mp4 --image-format png --crf 1

合併影片與音訊:

ffmpeg -y -i out/promo-hq.mp4 -i voiceover-with-music.mp3 \
  -c:v copy -map 0:v:0 -map 1:a:0 \
  out/promo-final.mp4

迭代檢查清單

當使用者提供反饋時,常見的修正:

問題修正
旁白重疊縮短文字或增加間距,重新生成,使用 Whisper 驗證
聲音與畫面不符重新閱讀場景內容,使腳本與視覺匹配
聲音太快加入停頓,減少文字密度
元素太靠近邊緣加入 60-100px 內距
字型太小增加 20-30%
動畫感覺僵硬調整彈簧阻尼/質量,加入緩動
過場太突兀加入淡出重疊,流暢縮放變化
影片結尾有空白幀延長結尾場景持續時間

禁止事項

  • 無抖動效果 - 不能有搖晃、震動或抖動的動作。一切應感覺流暢且受控。
  • 無整個場景旋轉 - 不要旋轉整個場景或構圖。3D 旋轉應是微妙且有目的的(例如,瀏覽器模擬搭配輕微的透視傾斜,而不是 360° 旋轉)。
  • 過場中無 3D 變形 - 翻轉、旋轉和其他基於 3D 變形的過場無法可靠渲染。堅持使用 2D:不透明度、位置、縮放和漸層遮罩。(3D 變形適合用於場景內的元素,例如瀏覽器模擬。)

資源

[因翻譯而截斷]

相關技能