Communitygithub.com

ktg-one/content-hub

使用 Remotion 搭配 AI 配音與背景音樂,創作出專業等級的行銷宣傳影片。透過 /promo-video 指令啟動。

content-hub 是什麼?

這項技能讓 AI 代理能扮演一位擁有 20 年經驗的動態圖像設計師與視覺行銷專家,專注於使用 Remotion 創作出高品質的產品宣傳影片。它提供了一個結構化的五階段工作流程:首先透過分析程式碼提交記錄或聽取使用者描述來深入理解產品;接著引導使用者選擇影片長度、視覺主題、轉場效果與配音員;然後使用 Remotion 與 React 元件自動建立影片合成,並開啟預覽進行迭代調整;之後,技能會根據場景時間軸精準撰寫配音腳本,並透過 ElevenLabs API 生成專業配音,再使用 Whisper 驗證時間戳記,確保配音與畫面完美同步;最後,技能會整合免版稅背景音樂並輸出最終的 MP4 影片。此技能高度整合了 Claude Code、Cursor 等開發者工具生態系,並依賴 `remotion-best-practices` 技能作為動畫基礎。其核心優勢在於將機械化的排程與 AI 的創意判斷結合,不僅能根據產品脈絡自動決定視覺風格與動畫方式,更強制要求配音與畫面精準對位,解決了自動化影片製作中最常見的影音不同步問題。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ktg-one/content-hub/tree/HEAD/.claude/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


第一階段:了解產品

首先,詢問他們希望如何提供背景資訊(先不分析):

{
  "questions": [{
    "question": "我們該如何定義這支影片的主題?",
    "header": "Input",
    "options": [
      { "label": "分析近期變更", "description": "深入分析程式碼提交記錄與程式碼內容" },
      { "label": "由我描述", "description": "你告訴我,我來產生選項供你選擇" },
      { "label": "兩者並行", "description": "分析程式碼 + 你提供產品定位" }
    ],
    "multiSelect": false
  }]
}

如果選擇「分析近期變更」或「兩者並行」: 進行深度分析 - 查看 100 筆提交記錄,並閱讀關鍵檔案:

git log --oneline -100
# 讀取 models、controllers、services、README

然後將分析結果以可選擇的選項呈現,供使用者確認。

如果選擇「由我描述」: 進行快速的表面掃描(僅足以產生合理的預設值):

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

然後根據掃描結果呈現動態選項:

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

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

接著詢問 Call-to-Action (CTA):

{
  "questions": [{
    "question": "Call-to-Action 應該是什麼?",
    "header": "CTA",
    "options": [
      { "label": "造訪網站", "description": "引導至某個 URL" },
      { "label": "註冊 / 開始使用", "description": "導向註冊流程" },
      { "label": "預約示範", "description": "銷售導向" },
      { "label": "下載 / 安裝", "description": "引導安裝應用程式" }
    ],
    "multiSelect": false
  }]
}

使用者也可以透過「其他」選項提供自訂的 CTA 文字。


第二階段:時間長度與主題

向使用者詢問幾個快速的設定問題。其餘的創意方向由你決定 — 不要把這部分當作「確認創意方向」,它只是挑選時間長度和主題。

視覺風格建議:

  • 簡潔最小風,搭配強而有力的字體
  • 深色模式,帶有細微的重點色與層次感
  • 淺色模式,搭配柔和的漸層與陰影
  • 3D 元素,具備透視與視差效果
  • 玻璃擬態,帶有模糊與透明度

轉場想法:

  • 穿透縮放:放大目前場景 (1→3) 並淡出,新場景從大尺寸縮小 (3→1)
  • 金屬光澤橫掃過畫面
  • 流暢的縮放與淡出轉場
  • 帶有動態模糊的方向性滑動
  • 粒子溶解效果

動畫技巧:

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

瀏覽器 Mockup 風格:

  • 漂浮並帶有強烈陰影
  • 透視傾斜 (3D 旋轉)
  • 嵌入裝置外框內
  • 螢幕錄影風格,附帶游標
  • 分割畫面對比

詢問使用者:

{
  "questions": [
    {
      "question": "影片長度應該是多少?",
      "header": "Duration",
      "options": [
        { "label": "30 秒", "description": "社群廣告、快速吸引注意" },
        { "label": "60 秒", "description": "標準宣傳片、功能概覽(推薦)" },
        { "label": "90 秒", "description": "詳細解說、展示多項功能" }
      ],
      "multiSelect": false
    },
    {
      "question": "深色還是淺色主題?",
      "header": "Theme",
      "options": [
        { "label": "淺色模式", "description": "乾淨、明亮、專業" },
        { "label": "深色模式", "description": "現代、大膽、戲劇化" }
      ],
      "multiSelect": false
    },
    {
      "question": "要為配音選擇哪種聲音?",
      "header": "Voice",
      "options": [
        { "label": "Matilda", "description": "溫暖、自信的女性聲音 — 精緻且多用途(推薦)" },
        { "label": "Rachel", "description": "冷靜、清晰的女性聲音 — 平穩且權威" },
        { "label": "Daniel", "description": "權威、精緻的男性聲音 — 廣播/廣告調性" },
        { "label": "Josh", "description": "友善、對話感較重的男性聲音 — 平易近人且自然" }
      ],
      "multiSelect": false
    }
  ]
}

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

聲音Voice ID
MatildaXrExE9yKIg1WjnnlVkGX
Rachel21m00Tcm4TlvDq8ikWAM
DanielonwK4e9ZLuTAKqWW03F9
JoshTxGEqnHWrfWFTfGW9XjX

運用你的創意專業知識,根據產品脈絡來決定視覺風格和動畫方式。每個宣傳片都應融入 3D 元素 — 特別是帶有透視和深度感的瀏覽器/裝置 Mockup。

然後詢問轉場:

{
  "questions": [
    {
      "question": "主要章節之間(例如 吸引注意 → 痛點 → 解決方案)使用哪種轉場?",
      "header": "Sections",
      "options": [
        { "label": "金屬光澤橫掃", "description": "對角線漸層亮光橫掃過畫面" },
        { "label": "穿透縮放", "description": "放大並穿入下一個場景" },
        { "label": "淡出", "description": "經典流暢的交叉淡出" },
        { "label": "從底部滑入", "description": "下一個場景從下方推入" }
      ],
      "multiSelect": false
    },
    {
      "question": "功能場景之間使用哪種轉場?",
      "header": "Features",
      "options": [
        { "label": "從右側滑入", "description": "內容水平滑入" },
        { "label": "淡出", "description": "經典流暢的交叉淡出" },
        { "label": "金屬光澤橫掃", "description": "對角線漸層亮光橫掃過畫面" },
        { "label": "放大", "description": "下一個場景從 80% 放大到 100% 並伴隨淡入" }
      ],
      "multiSelect": false
    },
    {
      "question": "進入最終 CTA 場景使用哪種轉場?",
      "header": "CTA",
      "options": [
        { "label": "金屬光澤橫掃", "description": "對角線漸層亮光橫掃過畫面" },
        { "label": "穿透縮放", "description": "放大並穿入" },
        { "label": "淡出", "description": "經典流暢的交叉淡出" },
        { "label": "放大", "description": "CTA 從中間放大出現" }
      ],
      "multiSelect": false
    },
    {
      "question": "轉場速度要多快?",
      "header": "Speed",
      "options": [
        { "label": "快速 (0.4s)", "description": "節奏明快、充滿活力" },
        { "label": "中等 (0.7s)", "description": "平衡、專業" },
        { "label": "緩慢 (1.2s)", "description": "戲劇化、電影感" }
      ],
      "multiSelect": false
    }
  ]
}

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


第三階段:使用 Remotion 建構

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

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

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

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

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

畫面構圖與尺寸指南:

  • 填滿整個畫面。元素應該要又大又醒目 — 避免小元件漂浮在空白空間中。
  • 標題:最小 60–90px。副標題:32–44px。如果在 Remotion 預覽中看起來很小,在真實的影片播放器中就會看起來非常小。
  • 瀏覽器 Mockup / 裝置外框應佔據畫面寬度的 60–80%。不要只是一個位於中央的小縮圖。
  • 與邊緣的內距:60–100px。內容不該緊貼邊緣,但也不該全部塞在中間。
  • 顯示功能列表或統計資料時,請將它們分散在可用空間中。要充分利用整個寬度。
  • 如果一個場景感覺很空,表示元素太小了。在加入填充內容之前,先放大現有元素。

你的創意工具箱:

  • spring() 用於自然動作(調整 damping、mass、stiffness)
  • interpolate() 用於精確的時間控制
  • CSS 3D 變形(perspective、rotateX、rotateY、translateZ)用於創造深度與裝置 Mockup
  • Box shadows 和 gradients 用於創造深度
  • Blur filters 用於玻璃擬態效果
  • SVG paths 用於自訂形狀動畫
  • Lucide 圖示

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

  • 開場/吸引注意 → 痛點 → 解決方案展示 → 功能 → 成果 → CTA

但你可以這樣做:

  • 以某個功能作為開場 → 縮小檢視問題 → 解決方案
  • 客戶引言 → 問題 → 解決方案 → 功能
  • 透過單一連續的縮放,瀏覽所有內容

相信你的直覺。

建立 Composition 後,啟動 Remotion Studio 進行預覽:

npx remotion studio

然後詢問使用者:

{
  "questions": [{
    "question": "影片看起來如何?準備好加入配音和背景音樂了嗎?",
    "header": "Preview",
    "options": [
      { "label": "看起來不錯,繼續進行", "description": "加入配音和音樂" },
      { "label": "需要修改", "description": "我會先提供反饋" }
    ],
    "multiSelect": false
  }]
}

如果選擇「需要修改」,請根據他們的反饋進行迭代,然後再繼續。


第四階段:配音(至關重要)

配音必須與畫面完美同步。 這是沒有商量餘地的。

  1. 從你的 Composition 中提取場景時間軸
  2. 撰寫與畫面內容相關的腳本
  3. 使用 ElevenLabs 生成(需要 ELEVEN_LABS_API_KEY)
  4. 使用 Whisper 驗證 - 檢查實際的時間戳記
  5. 立即修正所有重疊問題 - 不要問,直接修:
    • 縮短文字(讓它更簡潔有力)
    • 增加章節之間的間隔
    • 重新生成並再次驗證
    • 重複這個步驟直到零重疊

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


第五階段:音樂與最終輸出

詢問音樂:

{
  "questions": [{
    "question": "背景音樂?",
    "header": "Music",
    "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%
動畫感覺生硬調整 spring 的 damping/mass,加入 easing
轉場過於突兀加入淡出重疊,平滑縮放變化
結尾出現空白影格延長結尾場景的持續時間

禁止事項

  • 不要使用抖動效果 - 不要有搖晃、震動或抖動的動作。所有動作都應感覺流暢且受控制。
  • 不要有場景整體旋轉 - 不要旋轉整個場景或 Composition。3D 旋轉應該是細微且有目的的(例如,瀏覽器 Mockup 帶有輕微的透視傾斜,而不是 360° 旋轉)。
  • 不要在轉場中使用 3D 變形 - 翻轉、旋轉和其他基於 3D 變形的轉場無法可靠地渲染。請堅持使用 2D:透明度、位置、縮放和漸層遮罩。(3D 變形在場景內的元素(如瀏覽器 Mockup)是沒問題的。)

資源


此 SKILL.md 檔案為 ktg-one/content-hub 的一部分。

相關技能