使用手冊

Agent Skill · Cinematic Storyboard

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

ClipShot(cinematic-storyboard-design)繁體中文使用說明書:安裝、輸入確認、九宮格分鏡、時間線鏡頭表、視覺 QA 與連續性規則。

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

TanShilongMario/clipshot
星標
—
分支
—
授權
—
資料截至
—
閱讀時間
5 分
更新日期
開啟原始報告
GitHub Stars
40
執行狀態
9
視覺 QA 門禁
6
開源授權
MIT

01Repository 定位

拍攝前的鏡頭設計中間稿

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

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

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

  1. READ

  2. CONFIRM

  3. DESIGN

  4. GENERATE

  5. VISUAL QA

  6. TIMELINE

  7. DELIVER

A Skill for creating clipshot

— TanShilongMario/clipshot · GitHub description

02Cursor · Codex · Compatible Agents

固定目錄名稱與安裝位置

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

bash
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/ 子目錄。

bash
Customize → Rules → Add Rule → Remote Rule (Github)
https://github.com/TanShilongMario/clipshot

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連續運鏡只計算一次總時長

04Repository 規則

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

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

RULE · 格線固定

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

來源 · references/visual-production.md

RULE · 製作型分鏡媒介

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

來源 · references/visual-production.md

RULE · 寫實參考隔離

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

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

RULE · 光影圖形化

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

來源 · references/visual-production.md

RULE · 動作與鏡頭箭頭分離

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

來源 · references/visual-production.md

RULE · 視覺系統失敗重繪

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

來源 · SKILL.md · 錯誤恢復策略

0530 秒橫屏短劇片段

從阻塞資訊到九格交付

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

cinematic-storyboard-design · planning session

$ You ›
  使用 $cinematic-storyboard-design 把這段短劇做成九宮格分鏡。


claude: Agent ›
  請提供本次劇本片段,並確認成片用途、單格畫幅與本輪覆蓋範圍。


$ You ›
  用途:30 秒橫屏短劇;單格 16:9;範圍:角色進門到發現信封。
  人物與場景設定附後;照片只用於人物服裝與房間配置的連續性。


# [CONFIRM] 劇本片段、用途、畫幅與範圍齊全
# [CLASSIFY] 人物與場景照片 → CONTINUITY
# [DESIGN] 節拍、軸線、景別、動線、光形與轉場
# [GENERATE] strict equal 3×3 production storyboard


claude: Agent ›
  先檢查實際九宮格,再決定局部修正或整張重繪。


ok: GRID PASS · STYLE PASS · CONTINUITY PASS
ok: READABILITY PASS · MOTION PASS
# [TIMELINE] 依唯一鏡號計算 30 秒總時長
# [DELIVER] 九宮格、時間線表、轉場與連續性提示
        

Reference images are continuity references only, not rendering-style references.

— cinematic-storyboard-design · SKILL.md

完成條件

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

06用途與交付邊界

生成前確認與失敗處理

07鏡頭設計與驗證

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

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

進階工作地圖

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

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

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

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

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

延伸閱讀

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

先畫攝影,再畫人體,再畫光,最後才允許角色有最低限度的身份特徵。

— cinematic-storyboard-design · SKILL.md · 視覺生成優先級