Communitygithub.com

故事板拼板

將任意故事、腳本、短劇段落拆解成鏡頭單,逐格生成統一風格的分鏡畫面,自動拼合帶鏡頭號與時長標註的故事板(多格拼板圖)。

故事板拼板 是什麼?

這個技能提供了一個嚴謹、自動化的故事板生成流程,專為需要將文字敘事轉化為視覺預覽的創作者(如編劇、導演、影片腳本作者)設計。它支援 Claude Code、Cursor 等 AI 代理工具,透過固定的八步驟流水線確保輸出品質:從填寫內容卡、拆解鏡頭單,到逐格生成、品質檢驗、源頭追溯、拼版疊字,最後終審交付。核心機制是「三道門」品質閘——鏡頭單驗證未通過不生成圖像、單格檢驗未通過不拼版、回寫資料不完整不交付——以及「單一事實源」原則,所有角色、站位、光線等描述統一在頂層 anchors 區塊,各格 prompt 直接複製,避免跨格不一致。該技能也內建了嚴格的視覺連續性規則,如參考圖鏈、比例錨、不越軸等,並透過 PowerShell 腳本(validate-shots.ps1 和 build-board.ps1)自動執行靜態驗證與拼版,無需額外安裝依賴,確保最終故事板在構圖、角色比例、光線方向上都保持一致。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/freedonplus/storyboard-sheet/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

故事板拼板 是做什麼的?

穩定的關鍵不是臨場發揮,而是固定這條鏈路:內容卡 → 鏡頭單 → 靜態校驗 → 逐格生成 → 逐格質檢 → 溯源回寫 → 拼板疊字 → 整板終審交付。每一步的規格都寫死,換故事只換內容,不換結構。三道門卡死品質:校驗不過不開圖、單格不過不拼板、原句不回寫不交付。

執行流程

  1. 填內容卡。見 prompt-templates.md 的欄位:片名與題材、角色錨點、場景、站位卡、空間藍圖與機位表、狀態卡、光影與質感、畫幅與格數、鏡頭單、禁止項。缺什麼由 Agent 依據故事合理補全,不追問用戶風格偏好。
  2. 拆鏡頭單。按內容事件拆,不按字數或畫面美觀度拆;一格一個主要動作變化。寫成 assets/shots.example.json 同構的 JSON,欄位與命名嚴格照抄。所有跨格複用的句子集中寫進頂層 anchors 塊(單一事實源):style/characters/blueprint/blocking/axis/lighting/props/negative,各格 Prompt 從這八句原句拼裝,禁止各格自寫變體。機位表寫進 cameras,每格必須有 camera/in_state/out_state。
  3. 靜態校驗(不過不開圖)。先跑 scripts/validate-shots.ps1:必填欄位、格數容量、鏡頭號連續、時間區間首尾相接、in_state/out_state 逐字接力、每格 prompt 是否原句包含全部 anchors、機位引用是否存在、參考圖鏈方向。任何一項 FAIL 都先修 JSON,不進入生圖。
  4. 逐格生成分鏡畫面。一次 image_gen 呼叫內可提交同一場戲全部格的請求(request_list 多條),每格 1536×864。每格 Prompt 按 prompt-templates.md 的模板寫:全局質感句 + 角色錨點句 + 場景句 + 站位錨點句 + 比例錨 + 狀態卡 + 入格狀態 + 本鏡動作句 + 出格狀態 + 禁止句,全部錨點句逐格原句複製。同一場戲按機位表順序走參考圖鏈:上一格成品作為參考圖傳給下一格,指令固定寫「只參考空間佈局、角色比例、地面關係與光線方向,不照抄構圖」;換場斷鏈重開首格。詳見 continuity.md。
  5. 逐格質檢(單格不過不拼板)。每出一格立即對照 prompt-templates.md 的十條清單過目:臉型/服裝是否對錨點、站位是否在藍圖座標上、左右是否符合軸線定則、比例是否合錨、燈態/狀態卡是否符合真實語義、光位色溫是否一致、入格狀態是否接住了上一格、有無文字水印。不合格原地重出:改 Prompt 不重出錨點句,只修出錯的一項;同格重出兩次仍漂移,把首格成品一起傳入做雙參考,再不行就降級景別(近景比全景更穩)。
  6. 溯源回寫(不回寫不交付)。每格定稿後把四樣寫回鏡頭單 JSON 對應 shot:prompt(提交給生圖模型的完整原句,一字不改)、seed(若工具返回)、ref(本格使用的參考圖 id 鏈,如 "SH003" 或 "SH001+SH003")、qa(質檢結論與備註)。這張 JSON 是唯一的溯源檔案:任何人拿到它能逐格復現、定位穿幫責任句。
  7. 拼板疊字。用 scripts/build-board.ps1(參數化:spec JSON + 幀目錄 + 輸出路徑),按 output-spec.md 的比例公式定格數與畫布,鏡頭號、時長、鏡頭名一律後期疊在格底半透明條上,不讓圖像模型畫任何文字。拼板前再跑一次 validate-shots.ps1 -PanelsDir <幀目錄> -RequirePanels。
  8. 整板終審交付。拼完看一次整板:相鄰格接不接得上、角色左右全板是否一致、場景固定物(停止線/緣石/門框等)形態全板是否一致、標題卡資訊是否正確。發現問題回到第 5 步只重出有問題的那幾格。交付拼板圖本身(PNG 原圖 + 便於查看的 JPG)與鏡頭單 JSON;用戶要求時再單獨交付單幀。

硬規則

  • 三道門:鏡頭單靜態校驗不過 → 不生圖;單格質檢不過 → 不拼板;prompt/seed/ref/qa 未回寫 → 不交付。
  • n×n 網格 + 每格 16:9 = 整板嚴格 16:9。3×3 用 1280×720 拼 3840×2160;4 格用 2×2;6 格用 3×2(超寬)或 2×3(豎版);9 格用 3×3。非方陣整板比例 = (列數×16):(行數×9)。
  • anchors 單一事實源:角色、站位、藍圖、光位、狀態卡、禁止項各只有一句原話,住在頂層 anchors 塊裡;各格 Prompt 從這裡原句複製,禁止寫「同上」「保持一致的造型」,禁止各格改寫近義句。同一角色跨格變臉是拼板最常見的失敗。
  • 站位以場景固定物為基準,逐格原句複製:停止線、第 N 條白線、緣石、桌沿、門框、護欄立柱。禁止用「前景/後景/畫面左側」描述角色位置——這些隨景別和機位變化,是站位漂移的頭號原因。位移只寫相對錨點的方向與距離(「向前踏出一步、越過停止線」)。
  • 場景一致性三件套:藍圖(空間座標)+ 狀態卡(可變物件語義)+ 場景固定物形態(材質/顏色/數量),全組逐格原句複製;換場才允許換,換場在鏡頭單裡標 scene_break: true 並斷參考圖鏈。
  • 光位句全組統一,只有敘事上確實換時段才改;改時在鏡頭單裡註明。
  • 一格一個動作:起點狀態 → 路徑/接觸點 → 可視結果。多步動作拆鄰格。
  • 相鄰格必須接力:每格 out_state 與下一格 in_state 逐字相等(位置/朝向/動作相位/接觸點/表情強度五項),禁止「基本一致」;換場斷鏈用 scene_break: true 顯式聲明,不允許默默斷開。
  • 不越軸、按機位表移動:全組機位在同一側,角色畫面左右不互換;相鄰機位夾角 ≤ 90°、高度差 ≤ 一個身位、景別不連跳兩級。
  • 比例錨寫進每格:給一個場景固定尺寸物(白條 45cm、緣石 15cm、桌寬 60cm),角色尺寸用錨換算,防忽大忽小。
  • 狀態卡逐格原句複製,燈態必須符合真實語義:行人紅燈=站立紅人,行人綠燈=行走綠人,車輛燈=純色圓盤;寫清哪盞面向誰,並讓車流與通行權一致。禁止圓盤裡畫人形、紅燈配綠色數字這類混搭。
  • 切點寫清接住什麼:禁止「自然轉場」「流暢銜接」。
  • 空詞換實寫:高級感、震撼、電影感、氛圍拉滿,一律替換為具體光線、材質、速度、距離、景別。
  • 禁止項固定包含:不出現文字、字幕、水印、編號、邊框;按題材追加(如不出現血液噴濺、不出現現代槍械、不做卡通化)。
  • 少於 列×行 格且啟用 title_cell 時,最後一格為標題卡;否則空格留深色底,不得為了湊數補無關鏡頭。

資源

檔案職責
references/prompt-templates.md內容卡、單格 Prompt 模板、整板九宮格 Prompt、動作與運鏡寫法、單格質檢門、失敗清單
references/continuity.md銜接卡:空間藍圖、軸線規則、機位表、尾態首態接力、參考圖鏈、比例錨、溯源回寫、自查清單
references/output-spec.md格數與比例公式、解析度、疊字版式、鏡頭單 JSON 欄位規範(含 anchors 與溯源欄位)
assets/shots.example.json鏡頭單 JSON 完整示例(8 格 + 標題卡,含 anchors/cameras/溯源欄位)
assets/demo.jpg示例成品:上面這份鏡頭單拼出的整板預覽(8 鏡 + 標題卡,3×3,長邊 2560 的 JPG)
scripts/validate-shots.ps1鏡頭單靜態校驗:欄位、接力、錨點原句包含、機位引用、幀檔案存在性
scripts/build-board.ps1拼板疊字:讀取 JSON,輸出整板 PNG 與 JPG 預覽

兩個腳本依賴 Windows 內建 PowerShell 與 System.Drawing,無需額外安裝庫。執行方式:

# 開圖前:靜態校驗(不過不開圖)
& "<skill-dir>\scripts\validate-shots.ps1" -SpecPath <shots.json>

# 拼板前:連幀檔案一起校驗(缺幀直接失敗)
& "<skill-dir>\scripts\validate-shots.ps1" -SpecPath <shots.json> -PanelsDir <幀目錄> -RequirePanels

# 拼板疊字
& "<skill-dir>\scripts\build-board.ps1" -SpecPath <shots.json> -PanelsDir <幀目錄> -OutputPath <整板.png> -PreviewPath <預覽.jpg>

拼板腳本按格子中心裁切填充(cover),不拉伸畫面;幀尺寸與格子比例不一致時不會變形。

示例成品見 assets/demo.jpg:8 鏡 + 標題卡的整板預覽,對應鏡頭單是 assets/shots.example.json,先跑 validate-shots.ps1 通過後再按同一份 JSON 復現即可得到同結構的板。

相關技能