Communitygithub.com

影片分鏡腳本

指導 AI 代理如何規劃、建構或剪輯「影片分鏡腳本」,最終產出為節拍表與分鏡清單。適合在接到需要此技能的任務時使用。

影片分鏡腳本 是什麼?

此技能為 AI 代理提供了一套結構化程序,用於規劃 Demo 影片、發布影片或功能解說影片的「分鏡腳本」。它將任務分解為六個步驟:鎖定目標與平台、建立節拍表(鉤子、問題、揭示、證明、行動呼籲)、為每個場景分配類型與時長、編寫鏡頭清單(包含文案與視覺描述)、產生結構化的 JSON 場景計畫,最後將成果交接給其他用於動畫、渲染與音效的專業技能(例如 `remotion-compose`)。此技能依賴於兩個關鍵原則:鉤子必須在前三秒內抓住觀眾,且不同場景類型(標題、文字、UI 演示、證明數據)的節奏與停留時間皆不相同。它支援所有主流平台(橫向 16:9、垂直 9:16、正方形 1:1),並內建一個 Node.js 腳本產生器,可將分鏡表轉換為 `remotion-compose` 能夠直接讀取的 `scene-plan.json` 檔案,以讓每個場景對應到一個 `<Sequence>`。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ensinohi-lab/thesis-skills/tree/HEAD/video-storyboard

在你喜歡的 AI 中提問

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

說明文件

影片分鏡腳本 是做什麼的?

在開始任何動畫之前,先執行此步驟。一支 Demo 影片的成敗取決於其規劃:錯誤的順序、缺少鉤子、或超過 40 秒的片長,無論動畫多麼流暢都會毀掉它。你作為工藝層,負責決定存在哪些場景、它們的順序、時長以及每個場景要說什麼——然後將具體的場景計畫移交給負責實際製作的機械工具包(remotion-setup、remotion-compose、remotion-render)。

當有規劃意圖時應主動觸發:例如「為我的 demo 規劃分鏡」、「規劃影片」、「我需要哪些場景」、「規劃發布影片」、「將此功能分解為場景」。即使使用者直接要求「開始動畫」,仍應先執行節拍表——一個分鏡腳本只需要 2 分鐘,卻能省下一次重新渲染。

全程使用一個範例:一個 30 秒的 AI 程式碼審查工具 Sentinel 的發布影片,它能在合併前標記出有風險的 diff。

操作程序

請依序執行。在節拍確定前不要撰寫文案,在節拍存在之前不要設定時長——節奏是結構的函數,反之則不然。

步驟 1 - 鎖定一句話的目標與平台

在設定節拍之前,先釐清兩件事:

  1. 單一核心訊息。 觀眾必須記住的一句話:「Sentinel 抓到了你的審查員遺漏的錯誤。」 如果你無法用一句話說清楚,那麼這支影片就沒有主軸。其後所有內容都服務於這句話。
  2. 平台與長寬比。 橫向 16:9(1920×1080)用於網站首頁或 YouTube;直向 9:16(1080×1920)用於社群媒體/Shorts;正方形 1:1 用於資訊流。這將設定 remotion-compose 要創作的畫布,並限制片長——社群媒體為 15-30 秒,首頁循環為 20-40 秒,功能解說可達 60 秒。

步驟 2 - 鋪設節拍表(五節拍主軸)

每個 Demo、公告和發布影片都是這五個節拍的變體。只有在有理由的情況下才能刪除節拍;切勿將鉤子以外的節拍重新排序。

  1. 鉤子(前 3 秒)。 影片中最重要的 3 秒——觀眾在此決定是否繼續觀看。以結果、緊張感或大膽的主張開場,而不是你的 Logo。「你的審查員剛剛批准了一個錯誤」勝過「介紹 Sentinel」。Logo 可以在角落待著;它不是鉤子。
  2. 問題。 具體說出觀眾已經感受到的痛點。「週五下午五點,有風險的 diff 在審查中溜了進來。」一個節拍,一個痛點。
  3. 揭示。 介紹產品作為轉折點。這是你亮出品牌名稱和核心機制的時機。展示產品在實際執行任務。
  4. 證明。 讓主張變得可信——一個真實的前後對比、一個真實的數字、一個真實的畫面。這是大多數影片跳過的節拍,也是最能促成轉換的節拍。使用真實的產品數據,絕不能憑空捏造指標。
  5. 行動呼籲。 一個行動,一個網址。「免費試用 Sentinel → sentinel.dev。」永遠不要提供兩個選項。

對於較長的功能解說,揭示和證明節拍會針對每個功能重複(揭示功能 1 → 證明,揭示功能 2 → 證明)。鉤子、問題和行動呼籲則保持單一。

步驟 3 - 為每個節拍指定場景類型和目標時長

每個節拍會變成一個或多個場景。場景類型驅動節奏——文字需要閱讀時間,UI 演示需要停留時間,Logo 則要快速。使用以下目標(以 30fps 為例;durationInFrames = 秒數 × fps):

場景類型目標時長原因
鉤子 / 標題卡片2.5-3.5 秒足夠讀完一行,又夠短以保持開場緊湊
文字陳述2.5-4 秒約 2.5 字/秒的閱讀速度;7 個字的句子需要約 3 秒在螢幕上
UI / 產品 Demo4-6 秒眼睛需要停留時間來解析畫面及其中的動態
證明 / 數據3-5 秒一個數字或前後對比需要一個節拍來被感知
Logo / 行動呼籲尾2.5-4 秒閱讀網址,讓它呼吸,然後結束

節奏規則:鉤子是最快的剪輯,證明是最慢的。 如果總片長過長,應刪除一個場景——而不是加快每個場景的速度。匆忙的 Demo 會顯得不自信。

步驟 4 - 編寫鏡頭清單(每個場景的文案 + 視覺描述)

為每個場景設定四個欄位:它所服務的節拍、場景類型、螢幕上的文案(真實的文字——詢問使用者,永遠不要捏造說法),以及一句話的視覺描述,用來告訴 remotion-compose 要渲染什麼。這是最終交付物。視覺描述是一個簡要說明,而非程式碼:「終端機打出一段 git diff,一行有風險的程式碼被高亮為紅色」——remotion-compose 會決定 interpolate/spring 的機制。

步驟 5 - 輸出 JSON 場景計畫

執行以下產生器,將鏡頭清單轉換為結構化的 scene-plan.json。這是負責交接的產物:remotion-compose 將它讀取為場景計畫(每個場景對應一個 <Sequence>,from/durationInFrames 已計算完成),而每個場景的 motion 提示則是 motion-design-principles 或 motion-color-and-light 決策的介入點。將其儲存在專案旁邊,以便機械工具包能夠取用。

步驟 6 - 交接

向使用者提供節拍表、鏡頭清單表格和 JSON。然後明確交接:「這是場景計畫。如果專案尚未建立,請使用 remotion-setup,然後 remotion-compose 會將這個 JSON 轉換為組合,而 remotion-render 會將它匯出。在我們開始動畫之前,需要調整節奏或文案嗎?」 如果影片是特定的產品 Demo,並且你想要一個導演視角來決定每個場景在螢幕上展示什麼,請搭配 product-demo-director。動態的標題處理交給 kinetic-typography;背景音樂和節拍同步剪輯交給 sound-and-music-sync;為社群媒體進行的直向重新剪輯交給 social-video-formatter。

品質標準

只有當所有條件都滿足時,分鏡腳本才能獲得 A+ 評級:

  • 鉤子在前 3 秒內出現,且不是 Logo——它以結果、緊張感或主張開場。
  • 所有五個節拍都存在,或者每個缺少的節拍都有陳述的理由(預告片可能合理省略「證明」)。
  • 每個場景都有真實的文案行和具體的視覺簡要——沒有「這裡放一些 UI」,沒有憑空捏造的指標。
  • 總片長符合平台的上限,且時長遵循場景類型表(鉤子快,證明慢),而不是每 3 秒均等剪輯。
  • 行動呼籲是單一行動且只有一個網址。
  • JSON 通過驗證,且其累計時長等於 remotion-compose 將註冊的總組合時長——不匹配是渲染時最大的意外。

請勿

  • 請勿以 Logo 或緩慢淡入的標題開場——你會在鉤子出現之前就失去觀眾。
  • 請勿為「證明」節拍捏造數字、見證或產品聲明;請詢問真實數據或刪除該節拍。
  • 請勿在此撰寫 .tsx、選擇 interpolate 範圍或設定 spring 的 damping——那是 remotion-compose 的工作。此技能輸出計畫,而非程式碼。
  • 請勿讓每個場景的節奏都相同;固定的 3 秒剪輯會讓 Demo 感覺像簡報。
  • 請勿堆疊兩個行動呼籲或兩個網址;一個選項能促成轉換,兩個會分散注意力。
  • 請勿為了塞入更多內容而讓片長超過平台上限——應刪除一個場景。

產生器

一個獨立的 Node.js 腳本。儲存為 scene_plan.js,編輯 beats 陣列以符合你的影片,然後執行 node scene_plan.js > scene-plan.json。無需任何依賴。它會計算幀偏移、驗證總時長,並輸出 remotion-compose 所使用的計畫。

// 分鏡腳本 -> 場景計畫。編輯 `meta` 和 `beats`,然後:
//   node scene_plan.js > scene-plan.json
const meta = {
  title: 'Sentinel Launch',
  fps: 30,
  width: 1920,   // 直向 9:16 為 1080,正方形為 1080
  height: 1080,  // 直向 9:16 為 1920,正方形為 1080
}

// 每個場景一行。`seconds` 遵循場景類型表。
// `motion` 是給 motion-design-principles / motion-color-and-light 的提示;
// 它是一個簡要說明,而非程式碼。
const beats = [
  { beat: 'hook',    type: 'title',   seconds: 3.0, copy: 'Your reviewer just approved a bug.', visual: 'Dark screen, line of code types in; one line snaps red.', motion: 'snappy, low damping on the red flag' },
  { beat: 'problem', type: 'text',    seconds: 3.5, copy: 'Risky diffs slip through review at 5pm on a Friday.', visual: 'Calendar/clock motif, a PR marked merged.', motion: 'calm fade, no overshoot' },
  { beat: 'reveal',  type: 'ui',      seconds: 5.0, copy: 'Sentinel reviews every diff before merge.', visual: 'Sentinel scans the same diff, surfaces the risky line with a reason.', motion: 'scan sweep, then settle' },
  { beat: 'proof',   type: 'proof',   seconds: 4.5, copy: 'Caught on real PRs. Before it shipped.', visual: 'Before/after: red flag -> fixed diff, real screenshot.', motion: 'slow cross-dissolve, hold' },
  { beat: 'cta',     type: 'cta',     seconds: 3.0, copy: 'Try Sentinel free -> sentinel.dev', visual: 'Logo + URL on brand color.', motion: 'gentle pop, end clean' },
]

const fps = meta.fps
let from = 0
const scenes = beats.map((b, i) => {
  const durationInFrames = Math.round(b.seconds * fps)
  const scene = {
    id: `${i + 1}-${b.beat}`,
    beat: b.beat,
    type: b.type,
    from,
    durationInFrames,
    seconds: b.seconds,
    copy: b.copy,
    visual: b.visual,
    motion: b.motion,
  }
  from += durationInFrames
  return scene
})

const durationInFrames = from
const totalSeconds = durationInFrames / fps
const hook = scenes[0]
const warnings = []
if (hook.beat !== 'hook') warnings.push('First scene is not the hook.')
if (hook.seconds > 3.5) warnings.push('Hook is longer than 3.5s - tighten the open.')
if (scenes.filter((s) => s.beat === 'cta').length > 1) warnings.push('More than one CTA.')
if (!scenes.some((s) => s.beat === 'proof')) warnings.push('No proof beat - claim may not convert.')
if (totalSeconds > 60) warnings.push(`Runtime ${totalSeconds}s exceeds 60s ceiling - cut a scene.`)

const plan = {
  composition: {
    id: meta.title.replace(/[^A-Za-z0-9]/g, ''),
    fps,
    width: meta.width,
    height: meta.height,
    durationInFrames, // remotion-compose registers exactly this on the <Composition>
  },
  scenes,
  meta: { totalSeconds, sceneCount: scenes.length, warnings },
}

process.stdout.write(JSON.stringify(plan, null, 2) + '\n')
if (warnings.length) console.error('WARNINGS:\n  - ' + warnings.join('\n  - '))

範例輸出

使用上述 beats 設定,腳本會寫出 scene-plan.json:

{
  "composition": {
    "id": "SentinelLaunch",
    "fps": 30,
    "width": 1920,
    "height": 1080,
    "durationInFrames": 570
  },
  "scenes": [
    { "id": "1-hook",    "beat": "hook",    "type": "title", "from": 0,   "durationInFrames": 90,  "seconds": 3.0, "copy": "Your reviewer just approved a bug.", "visual": "Dark screen, line of code types in; one line snaps red.", "motion": "snappy, low damping on the red flag" },
    { "id": "2-problem", "beat": "problem", "type": "text",  "from": 90,  "durationInFrames": 105, "seconds": 3.5, "copy": "Risky diffs slip through review at 5pm on a Friday.", "visual": "Calendar/clock motif, a PR marked merged.", "motion": "calm fade, no overshoot" },
    { "id": "3-reveal",  "beat": "reveal",  "type": "ui",    "from": 195, "durationInFrames": 150, "seconds": 5.0, "copy": "Sentinel reviews every diff before merge.", "visual": "Sentinel scans the same diff, surfaces the risky line with a reason.", "motion": "scan sweep, then settle" },
    { "id": "4-proof",   "beat": "proof",   "type": "proof", "from": 345, "durationInFrames": 135, "seconds": 4.5, "copy": "Caught on real PRs. Before it shipped.", "visual": "Before/after: red flag -> fixed diff, real screenshot.", "motion": "slow cross-dissolve, hold" },
    { "id": "5-cta",     "beat": "cta",     "type": "cta",   "from": 480, "durationInFrames": 90,  "seconds": 3.0, "copy": "Try Sentinel free -> sentinel.dev", "visual": "Logo + URL on brand color.", "motion": "gentle pop, end clean" }
  ],
  "meta": { "totalSeconds": 19, "sceneCount": 5, "warnings": [] }
}

解讀:5 個場景,570 幀 = 30fps 下的 19 秒,遠低於社群媒體的上限。鉤子為 3 秒,並以緊張感開場,而非 Logo。證明節拍(4.5 秒)是最慢的剪輯;鉤子和行動呼籲(3 秒)則是最緊湊的。沒有警告,因此它已準備好交給 remotion-compose——它會註冊一個 <Composition durationInFrames={570}>,並為每個場景建立一個 <Sequence from={…} durationInFrames={…}>,直接從此檔案讀取 from 和 durationInFrames。

模板:鏡頭清單

當你希望JSON 旁邊有一個人類可讀的表格時使用。將 FILL 欄位替換為你的影片實際內容。

影片分鏡腳本。 [填寫: 影片名稱]。 [填寫: 平台 / 長寬比]
目標(一句話):[填寫: 單一核心訊息]
目標片長:     [填寫: 社群媒體 15-30 秒 / 首頁 20-40 秒 / 解說可達 60 秒]

節拍      場景類型   時長      螢幕文案(真實文字)          視覺簡要
鉤子      標題       [填寫]秒   [填寫: 結果/緊張感/主張]     [填寫]
問題      文字       [填寫]秒   [填寫: 一個具體痛點]         [填寫]
揭示      UI         [填寫]秒   [填寫: 產品 + 核心機制]      [填寫]
證明      證明       [填寫]秒   [填寫: 真實數字/前後對比]    [填寫]
行動呼籲  CTA        [填寫]秒   [填寫: 一個行動 + 一個網址]  [填寫]
  (針對功能解說,為每個功能重複揭示 + 證明)

總計:     [填寫]秒   (必須等於 JSON 中的 composition.durationInFrames / fps)
交接:     scene-plan.json -> remotion-compose

參考資料/為什麼前三秒那麼重要

觀眾在大約前 3 秒內決定是否繼續觀看,因此鉤子不是放置 Logo 或緩慢淡入的地方。用回報或緊張感開場:已發布的 Bug、下降的數字、能讓觀眾停下滑動螢幕的主張。Logo 可以一直待在角落;把它當作開場節拍,會把你最寶貴的秒數浪費在最不具說服力的內容上。如果你只能做好一個節拍,那就做好這一個。

參考資料/按場景類型調整節奏

不同場景需要在螢幕上停留不同的時間,且每 N 秒均等剪輯會讓影片看起來像簡報:

  • 標題/鉤子 - 快速。一行文字,乾脆地出現,在它失去新鮮感之前剪掉。
  • 文字 - 給予閱讀時間。人們閱讀速度約為 2.5 字/秒;7 個字的句子需要約 3 秒,12 個字的句子約 5 秒。文字時間不足是最常見的…

(原始內容被截斷)

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能