前言¶
短劇、豎屏劇、信息流劇的交付節奏快，團隊裏常見分工是編劇出稿、導演口頭補視覺，再交給攝影和剪輯拆鏡。若分鏡只靠表格或聊天記錄整理，景別、機位、賣點鏡頭和後期說明容易散落，後期改一版劇本就要整表重抄。
下面介紹 SkillHub 上的 短劇文字分鏡腳本（@ihangfeng/hf-drama-storyboard-script，v1.0.0）。它在 Agent 側把「劇集內容 + 導演視覺建議」收斂成逐鏡頭文字分鏡，並按固定 schema 輸出 嚴格 JSON，便於拍攝、剪輯、特效和宣發標注共用同一套結構。
這是什麼¶
短劇文字分鏡腳本 是面向內容創作的 Agent Skill，發佈者爲 航峯匯智，來源標註爲 enterprise，分類爲 content-creation。SkillHub 頁面顯示評分 100000，下載約 3153 次；標籤 requires_api_key=false，安裝後無需額外 API Key。
官方入口：
- Skill 資源：
https://api.skillhub.cn/ihangfeng/hf-drama-storyboard-script - 商店頁：
https://www.skillhub.cn/skills/ihangfeng/hf-drama-storyboard-script
一句話定位：根據劇集劇本內容和導演視覺建議，生成短劇文字分鏡腳本，覆蓋鏡頭拆解、景別設計、鏡頭調度、視效說明、剪輯節奏、賣點標籤整合，以及可拍攝分鏡 JSON 輸出；適用短劇、漫劇、信息流劇、豎屏劇等形態。
核心功能¶
以下能力均來自該 Skill 的 SKILL.md 說明，啓用後由 Agent 按文檔執行。
輸入與邊界¶
用戶通常提供兩類材料：
- 劇集內容：劇本、梗概、動作、臺詞、人物狀態、場景說明。
- 視覺呈現內容：導演建議、視覺風格、情緒曲線、視覺錨點、必須入鏡元素、色彩風格、特效方向。
若只有劇集內容，仍會生成分鏡；與導演意圖相關的字段會標明「未提供，按劇情語境推定」。Skill 明確要求：不得憑空新增會改變劇情因果的事件、角色或道具。
工作流程¶
Agent 按固定步驟處理：
- 通讀劇集內容，提取場景、角色、行動鏈、臺詞、情緒與衝突。
- 通讀視覺呈現，提取情緒曲線、視覺錨點、必入鏡元素、色彩、特效與商業賣點。
- 按動作節奏拆鏡：環境交代、起勢、衝突、反應、反轉、結果、鉤子各自成鏡。
- 爲每鏡指定景別、機位運動、人物調度、光影色彩、特效後期、聲音與剪輯點。
- 把導演視覺建議寫入對應鏡頭字段，而非堆在備註裏。
- 最終只交付嚴格 JSON，不輸出解釋、Markdown 表格或代碼塊包裹。
鏡頭與字段規範¶
- 一鏡一事：每個鏡頭只承載一個清晰動作、情緒反應或信息揭示；視覺描述以
【全景】、【中景】、【近景】、【特寫】、【極特寫】等景別標籤開頭。 - 商業賣點（打臉、身份暴露、親密拉扯、危機、反轉等）需落到可被剪輯抓取的鏡頭；高情緒段傾向短鏡頭與特寫，鋪墊段可用穩定中景或橫移。
- 單鏡字段包括：
鏡頭編號（S01連續編號）、劇情節點、時長建議（秒數區間）、景別、視覺描述、人物與動作、臺詞與聲音、剪輯與轉場、特效與後期、導演意圖整合、賣點標籤（數組）、來源依據。 - 頂層 JSON 僅含
分鏡信息與文字分鏡腳本；分鏡信息含劇集標題、場景、整體情緒曲線、色彩風格、視覺錨點、必須入鏡元素，以及無法分配的未使用導演元素說明。
交付前 Skill 要求自檢：JSON 可解析、無 Markdown/註釋/尾隨逗號、鏡頭編號連續、導演必入鏡元素已分配等。
安裝與啓用¶
SkillHub 推薦兩種方式：用 CLI 安裝到當前 Agent 的 skills 目錄，或把安裝提示詞發給 AI 按官方文檔操作。
1、安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能無法被加載。官方文檔給出的常見路徑如下：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝命令示例（命名空間爲發佈者 ihangfeng）：
skillhub install hf-drama-storyboard-script --namespace ihangfeng --dir ~/.cursor/skills/
將 ~/.cursor/skills/ 換成你當前客戶端對應路徑即可。商店頁亦提供自然語言安裝提示：請根據 https://skillhub.cn/install/skillhub.md，安裝 @ihangfeng/hf-drama-storyboard-script。
安裝完成後按各客戶端要求刷新或重啓 Agent，使 Skill 生效。
典型用法¶
在對話中引用 Skill 後，粘貼劇集內容與導演視覺說明，要求按規範輸出 JSON。Skill 包內 agents/openai.yaml 給出的默認提示可作爲起點：
使用 $hf-drama-storyboard-script 根據劇集內容和導演視覺建議，生成嚴格 JSON 格式的短劇文字分鏡腳本。
實操時可按下面結構組織輸入（內容爲示例格式，需替換爲你的真實劇本與導演 brief）：
【劇集內容】
場景：辦公室夜戲。女主發現合同被換頁，男主進門對峙……
（附臺詞與動作）
【視覺呈現】
情緒曲線：壓抑 → 爆發 → 冷寂收尾
視覺錨點：紅色印章特寫、窗外霓虹
必須入鏡：合同頁角摺痕、女主手背青筋
色彩：冷藍環境 + 暖色檯燈面光
特效：合同文字微距高光，無魔幻元素
請輸出完整文字分鏡 JSON，字段名與 SKILL 要求一致。
注意：Skill 規定 不要複述分析過程，不要輸出 Markdown；模型應直接返回可被標準解析器讀取的 JSON 對象。
適用場景與注意¶
適合誰
- 短劇 / 漫劇 / 豎屏劇 / 信息流劇的前期：編劇、導演、製片需要快速把劇本拆成可溝通的分鏡表。
- 需要把「賣點鏡頭」和剪輯節奏寫進結構化數據，方便後續剪輯腳本、宣發打標籤或自動化流水線消費 JSON 的團隊。
使用注意
- 輸出質量依賴輸入劇本與導演 brief 的完整度；視覺字段缺失時會推定，但推定範圍受 Skill 約束，不能改劇情因果。
- 本 Skill 交付的是 文字分鏡 + JSON schema，不包含分鏡圖繪製或自動成片；攝影、燈光、演員走位仍需現場調整。
- 若 Agent 仍用 Markdown 或代碼圍欄包裹 JSON，可在提示中再次強調「僅輸出 JSON、無代碼塊」，並對照 Skill 內「質量檢查」清單要求重試。
- 下載量、評分來自 SkillHub 頁面展示，會隨時間變化；以商店頁爲準。
結尾¶
短劇文字分鏡腳本 把劇本與導演視覺要求收斂爲統一的逐鏡頭 JSON，減少分鏡表反覆手改的成本，並顯式保留賣點標籤與來源依據，便於拍攝與後期對齊。需要安裝或查看說明時，可打開官方地址：https://www.skillhub.cn/skills/ihangfeng/hf-drama-storyboard-script，資源座標爲 @ihangfeng/hf-drama-storyboard-script。
