Communitygithub.com

EvanGruhlkey/poster-armory

使用 Remotion 製作專業宣傳影片,支援 AI 配音與背景音樂。透過 /promo-video 指令啟動。

poster-armory 是什麼?

此技能能讓 AI 代理化身為擁有 20 年經驗的動態圖形設計師,協助使用者從零開始打造專業級產品宣傳影片。它會先透過互動式問答了解產品、目標受眾與痛點,再動態生成影片腳本與視覺風格。接著,它會使用 Remotion 框架、lucide-react 圖示庫與 CSS 3D 變形等技術構築 1920x1080 全高清畫面。技能整合了 ElevenLabs 進行 AI 配音、Whisper 進行時間戳驗證以確保語音與畫面同步,並提供免版稅背景音樂與 FFmpeg 混音流程。最終可輸出包含配音與音樂的完整 MP4 檔案。支援 macOS、Linux 與 Windows(需安裝 Node.js、FFmpeg 與 ElevenLabs API 金鑰)。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/EvanGruhlkey/poster-armory/tree/HEAD/.agents/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": "輸入方式",
    "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": "產品", "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 }
  ]
}

從掃描結果中預先填入選項,讓使用者點選而非打字。

接著詢問行動呼籲(CTA):

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

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


第二階段:時長與主題

詢問使用者幾個快速設定的問題。其餘的創意方向由您決定 — 不必將其表述為「確定創意方向」,只需選擇時長與主題。

視覺風格建議:

  • 簡潔極簡搭配粗體排版
  • 深色模式搭配細緻點綴與層次感
  • 淺色模式搭配柔和漸層與陰影
  • 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": "進入最終 CTA 使用哪種轉場?",
      "header": "CTA",
      "options": [
        { "label": "金屬質感擦拭", "description": "對角線漸層光澤橫掃過畫面" },
        { "label": "縮放穿越", "description": "放大並推入" },
        { "label": "淡出", "description": "經典的平滑交叉淡出" },
        { "label": "縮放放大", "description": "CTA 從中心放大出現" }
      ],
      "multiSelect": false
    },
    {
      "question": "轉場速度要多快?",
      "header": "速度",
      "options": [
        { "label": "快速(0.4 秒)", "description": "明快、有活力" },
        { "label": "中等(0.7 秒)", "description": "平衡、專業" },
        { "label": "緩慢(1.2 秒)", "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  # 用於圖示

設定構圖為 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 圖示

場景結構具有彈性。 經典結構作為起點:

  • 鉤子/開場 → 痛點 → 解決方案揭示 → 功能 → 成果 → CTA

但您也可以嘗試:

  • 直接從功能開始 → 拉遠到問題 → 解決方案
  • 客戶引言 → 問題 → 解決方案 → 功能
  • 單一連續縮放穿越所有內容

相信您的直覺。

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

npx remotion studio

然後詢問使用者:

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

若選擇「需要修改」,在繼續前根據回饋進行迭代。


第四階段:配音(關鍵)

配音必須與視覺內容同步。 這是不可妥協的。

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

詳細的生成腳本與說明請參閱 voiceover.md。


第五階段:音樂與最終渲染

詢問音樂:

{
  "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 變換可用於場景內元素,如瀏覽器模型。)

資源

…

[為翻譯而截斷]

相關技能