C
Agent Skill · Cinematic Storyboard

把劇本轉成
可製作的 3×3
電影分鏡

ClipShot 是符合 Agent Skills 規範的獨立 Skill,正式名稱為 cinematic-storyboard-design。它先確認劇本範圍、用途與畫幅,再交付九宮格製作型分鏡、時間線鏡頭表與連續性提示。

40
GitHub Stars
9
執行狀態
6
視覺 QA 門禁
MIT
開源授權
01
Repository 定位

拍攝前的
鏡頭設計中間稿

ClipShot 接收劇本、既有分鏡腳本,以及人物、服裝、道具或場景參考。它把敘事拆成最多九個關鍵畫面,讓每格負責資訊、情緒、空間或動作的推進。

輸出不是成片預覽。預設媒介是鉛筆、鋼筆或墨線結構,加上克制的灰階或有限色塊;人物以結構人體呈現,光線以可讀的大塊形狀標示。

Agent 會先檢查實際生成圖像,再製作時間線表。GRID、STYLE、CONTINUITY、READABILITY、MOTION,以及適用時的 ACTION 門禁全部通過後,才進入交付。

cinematic-storyboard-design · 執行狀態機
READ→ CONFIRM→ DESIGN→ GENERATE→ VISUAL QA→ TIMELINE→ DELIVER
A Skill for creating clipshot
— TanShilongMario/clipshot · GitHub description
02
Cursor · Codex · Compatible Agents

固定目錄名稱與
安裝位置

安裝目錄必須命名為 cinematic-storyboard-design,使資料夾名稱與 SKILL.md 的 name 欄位一致。

git clone https://github.com/TanShilongMario/clipshot.git cinematic-storyboard-design

使用者級與專案級路徑

Cursor 使用者級安裝可放在 ~/.cursor/skills/cinematic-storyboard-design 或 ~/.agents/skills/cinematic-storyboard-design。專案級安裝則使用同名的 .cursor/skills/ 或 .agents/skills/ 子目錄。

Customize → Rules → Add Rule → Remote Rule (Github) https://github.com/TanShilongMario/clipshot
Codex 與其他相容 Agent:repository 根目錄提供 SKILL.md;agents/openai.yaml 定義顯示名稱、短描述與預設觸發句。安裝後先確認 Agent 能辨識 $cinematic-storyboard-design。
03
輸入、設計與交付

從片段確認到
視覺交付

主流程把內容理解、攝影設計、圖像生成與交付驗證分開。參考檔只在任務需要時載入,避免將所有細節同時放進 context。

Input · 01
CONFIRM
三項必填資訊
確認劇本片段、成片用途與單格畫幅,以及本輪場次、時長或段落範圍。
Reference · 02
CLASSIFY
附件用途標記
將附件拆成 CONTENT、CONTINUITY、CAMERA、STYLE;寫實圖預設只作連續性參考。
Design · 03
SHOT DESIGN
鏡頭語法
設定景別、機位、焦感、軸線、調度、光形、運動方向與轉場。
Output · 04
3×3 GRID
九格製作分鏡
交付等尺寸、固定閱讀順序的九格;每格畫幅遵循已確認的 16:9、3:4 或 9:16。
Verify · 05
VISUAL QA
實際圖像門禁
檢查格線、分鏡媒介、連續性、敘事可讀性、運動標記與動作攝影。
Deliver · 06
TIMELINE
時間線鏡頭表
記錄時間碼、鏡號、景別、表演、構圖、運鏡、聲音、轉場與連續性。

工作入口選擇

工作內容使用資料附加規則
一般敘事、廣告、MV 或短劇SKILL.md + cinematic-language.md先確認範圍、用途與畫幅
打鬥、追逐、跌落或非常規機位action-cinematography.md執行 ACTION / EXPRESSIVE CAMERA 檢查
生成九宮格或單格放大visual-production.md檢查實際圖像,不以 prompt 代替結果
整理時間線鏡頭表deliverable-schema.md連續運鏡只計算一次總時長
04
Repository 規則

九宮格、媒介與
連續性約束

以下規則來自官方 SKILL.md 與 references/。它們同時限制生成 prompt、實際畫面與時間線資料。

RULE 01

格線固定

合成圖必須是三列、三行、九個等尺寸畫框;不得合併、跨格或加入額外小格。

來源 · references/visual-production.md
RULE 02

製作型分鏡媒介

以鉛筆、鋼筆或墨線建立結構,使用平面馬克筆塊表達光影;純線稿不算完成。

來源 · references/visual-production.md
RULE 03

寫實參考隔離

照片預設只繼承體量、剪影、服裝色塊、道具外形與空間錨點,不繼承照片級渲染。

來源 · SKILL.md · 附件角色聲明
RULE 04

光影圖形化

每格標示主光方位、光的形狀、受光面與影子落點;不用體積光或寫實軟陰影替代。

來源 · references/visual-production.md
RULE 05

動作與鏡頭箭頭分離

人物路徑使用貼近動作的實線箭頭;鏡頭運動放在畫框邊緣並附極短英文標籤。

來源 · references/visual-production.md
RULE 06

視覺系統失敗重繪

角色立繪、成片靜幀、三維 shading 或寫實材質屬系統錯誤;放棄錯誤圖像參考並重新生成。

來源 · SKILL.md · 錯誤恢復策略
05
30 秒橫屏短劇片段

從阻塞資訊到
九格交付

以下示意對話使用 repository 的正式觸發名稱與必填資訊。實際分鏡內容由使用者提供的劇本決定。

cinematic-storyboard-design · planning session
You › 使用 $cinematic-storyboard-design 把這段短劇做成九宮格分鏡。
Agent › 請提供本次劇本片段,並確認成片用途、單格畫幅與本輪覆蓋範圍。
You › 用途:30 秒橫屏短劇;單格 16:9;範圍:角色進門到發現信封。 人物與場景設定附後;照片只用於人物服裝與房間配置的連續性。
[CONFIRM] 劇本片段、用途、畫幅與範圍齊全 [CLASSIFY] 人物與場景照片 → CONTINUITY [DESIGN] 節拍、軸線、景別、動線、光形與轉場 [GENERATE] strict equal 3×3 production storyboard
Agent › 先檢查實際九宮格,再決定局部修正或整張重繪。
GRID PASS · STYLE PASS · CONTINUITY PASS READABILITY PASS · MOTION PASS [TIMELINE] 依唯一鏡號計算 30 秒總時長 [DELIVER] 九宮格、時間線表、轉場與連續性提示
Reference images are continuity references only, not rendering-style references.
— cinematic-storyboard-design · SKILL.md

完成條件

九格數量、尺寸與畫幅正確;人物、道具、場景與屏幕方向保持連續;每格可讀出主要動作、主光位置與光形。完整台詞與鏡頭說明放入圖後時間線表,不堆在格內。

06
用途與交付邊界

生成前確認與
失敗處理

  • 不直接生成寫實成片。此 Skill 的預設成果是拍攝用 production storyboard,不是電影靜幀、廣告 key visual、精緻漫畫或 3D 預覽。
  • 三項必要資訊缺一項就先停下。劇本片段、成片用途與單格畫幅、本輪覆蓋範圍不明時,Agent 必須先追問。
  • 長劇本需要拆組。九格無法清楚承載所有關鍵節拍時,先列出分組、覆蓋場次、建議畫幅與拆分理由,再確認本輪範圍。
  • 照片不是預設風格參考。真人、產品與場景照片預設只用於連續性,不繼承皮膚、材質、景深、調色或攝影光學。
  • Prompt 正確不等於圖像通過。生成後必須查看實際圖片;任何 QA 門禁失敗都不能以文字說明代替修正。
  • 視覺系統錯誤需整張重繪。人物過度具象、畫面接近成片、光影成為 3D shading 或參考圖完成度被繼承時,不沿用錯誤圖像。
  • A/B 方案有啟用條件。預設只交付一套導演推薦方案;探索階段、使用者明確要求或觀看立場存在兩個成立答案時才提供雙方案。
  • 本輪 repository 不含案例圖片。README 明示案例圖片將另行補充;評估目前版本時應以規則、流程與 schema 為主。
07
鏡頭設計與驗證

從固定九格到
可執行攝影語言

先以簡短片段建立基準,再增加動作設計、連續運鏡關鍵帧與單格放大。每次擴充都保留原本的鏡號、畫幅、角色方向與空間錨點。

進階工作地圖

1. 建立輸入模板。固定收集劇本範圍、用途、畫幅、人物、場景、目標時長、禁忌與參考資料用途。

2. 定義觀看原則。為整段選擇主觀距離、構圖秩序、景別節奏與運鏡策略,避免九格各自套用無關技法。

3. 使用連續鏡頭關鍵幀。以 S04a、S04b、S04c 記錄同一鏡頭的起點、轉折與落點;時間線只計算一次總時長。

4. 增加動作攝影審查。打鬥、追逐或跌落段落需檢查受力、接觸點、重心改變、構圖收益與空間後果。

5. 放大單格。鎖定原機位、動作瞬間與連續性,只深化姿態、手部、五官動態、光面與影子落點。

延伸閱讀

① SKILL.md:狀態機、輸入確認、方案數量、鏡頭設計與錯誤恢復。
② visual-production.md:九宮格規格、固定媒介、提示詞結構與六道 QA。
③ deliverable-schema.md:時間線欄位、連續鏡頭計時與拆分建議。

先畫攝影,再畫人體,再畫光,最後才允許角色有最低限度的身份特徵。
— cinematic-storyboard-design · SKILL.md · 視覺生成優先級