storyboard-breaker
chatfire-AI/huobao-drama · Agent Skill
將劇本分解為影片生成片段,每個片段長8-15秒,包含2-4個鏡頭,並附有動作、對話和氛圍的描述。
前往安裝 ↓總覽
| 發布者 | |
|---|---|
| 儲存庫 | chatfire-AI/huobao-drama ↗ |
| 技能資料夾 | storyboard-breaker |
| 星 | 14,828 |
| 附帶檔案 | 1 |
| 授權 | 未標示 — 請向作者確認 |
| 最近更新 | 2026年8月7日 |
| 連結 | 技能原始碼 ↗ · 儲存庫 ↗ |
Mozgi 檢查
我們在技能檔案中發現的內容。詳細資訊需訂閱。
安裝
技能就是一個含 SKILL.md 的資料夾。選擇你的代理,在專案根目錄的終端機(macOS、Linux 或 Windows 的 Git Bash)執行指令。
把提示貼到 Claude、Codex 或其他助理:它會自行檢查並安裝技能。
Install the “storyboard-breaker” skill from mozgi.io (https://mozgi.io/skills/storyboard-breaker/) for me. 1. Download the archive: https://mozgi.io/skills/storyboard-breaker/download If it fails, take the skill folder from the source: https://github.com/chatfire-AI/huobao-drama/tree/master/backend/workspace/skills/storyboard-breaker 2. Read SKILL.md and the other files. Check the skill is safe: no hidden commands, no sending data elsewhere, no scripts doing something other than described. If anything looks suspicious, stop and tell me. 3. Put the “storyboard-breaker” folder into your agent's skills folder: .claude/skills/ for Claude Code, .agents/skills/ for Codex, .cursor/skills/ for Cursor, .gemini/skills/ for Gemini CLI. Inside the project if we are in one, otherwise in the home folder (~/.claude/skills/ etc.). 4. Make sure <skills folder>/storyboard-breaker/SKILL.md exists. 5. Briefly tell me what this skill does and offer to try it on my task. If you cannot do a step yourself, tell me what to click or type.
git clone --depth 1 --branch master https://github.com/chatfire-AI/huobao-drama.git /tmp/huobao-drama mkdir -p .claude/skills cp -r /tmp/huobao-drama/backend/workspace/skills/storyboard-breaker .claude/skills/storyboard-breaker
重新啟動 Claude Code — 技能就會出現在清單中,手動呼叫:/storyboard-breaker。要套用到所有專案,請放在 ~/.claude/skills。
git clone --depth 1 --branch master https://github.com/chatfire-AI/huobao-drama.git /tmp/huobao-drama mkdir -p .agents/skills cp -r /tmp/huobao-drama/backend/workspace/skills/storyboard-breaker .agents/skills/storyboard-breaker
Codex 會從目前資料夾往上到儲存庫根目錄,在 .agents/skills 中尋找技能;用 /skills 或 $storyboard-breaker 呼叫。所有專案:~/.agents/skills。
git clone --depth 1 --branch master https://github.com/chatfire-AI/huobao-drama.git /tmp/huobao-drama mkdir -p .cursor/skills cp -r /tmp/huobao-drama/backend/workspace/skills/storyboard-breaker .cursor/skills/storyboard-breaker
Cursor 啟動時會載入技能;在 Agent 聊天輸入「/」呼叫。Cursor 也會讀取 .claude/skills 與 .agents/skills。所有專案:~/.cursor/skills。
git clone --depth 1 --branch master https://github.com/chatfire-AI/huobao-drama.git /tmp/huobao-drama mkdir -p .gemini/skills cp -r /tmp/huobao-drama/backend/workspace/skills/storyboard-breaker .gemini/skills/storyboard-breaker
任務符合時,Gemini CLI 會提議啟用技能,由你確認。所有專案:~/.gemini/skills。
安裝前請先檢視 SKILL.md 與相關檔案。點擊檔案即可預覽。
SKILL.md 內容
作者原文 · 唯讀分镜拆解指南
核心定义:分镜段落
一个分镜 = 一个 分镜段落(segment)= 一个视频生成任务。
- 每个段落时长 8-15 秒,内部承载 2-4 个子镜头
- 子镜头之间可以切镜:换景别、换角度、换拍摄对象,用硬切衔接
- 子镜头之间不跨场景:一个段落只发生在一个场景内(
scene_id是段落级绑定) - 每个子镜头 2-6 秒,聚焦一个画面单元(一个动作、一个反应、一个特写)
拆分流程(四步)
1. 调用 read_storyboard_context 读取剧本、角色、场景、道具、已有分镜摘要
2. 节拍识别:先识别剧本的叙事节拍——剧本中的【开场】【触发】【高潮】【收尾】等标记,或叙事转折点(地点转移、规则揭示、情绪爆发、反转)。节拍边界强制切段,同一节拍内的子镜头优先归入同一段落,不把一条因果链(铺垫-发生-反应)切散到不同段落
3. 总量锚定:目标总时长 = 剧本字数 ÷ 500字/分钟;段落数 ≈ 目标总时长 ÷ 12秒,允许 ±20% 浮动。不要明显超出或不足
4. 段落内拆子镜头:按动作切换点、视角切换点、对象切换点切分子镜头,为每个段落补全完整字段后调用 save_storyboards 一次性保存
节奏分层时长
按段落功能确定时长,不要一刀切:
| 段落类型 | 时长 | 说明 |
|---|---|---|
| 过渡段 | 8-10 秒 | 赶路、空镜、环境建立、转场 |
| 叙事段 | 10-15 秒 | 常规剧情推进、对话 |
| 爆点段 | 12-15 秒 | 特写、规则揭示、情感爆发、反转;子镜头节奏放慢,单个子镜头可停留 4-6 秒 |
台词时长下限(硬规则)
段落时长 ≥ 段内台词与旁白总字数(写在 description 中的部分)÷ 4.5字/秒 + 2秒表演余量
装不下的台词必须拆到下一个段落,不允许把演不完的台词塞进一个段落。
镜头要素
1. 镜头标题:3-5字概括段落核心内容(如"噩梦惊醒")
2. 时间:具体时分 + 光线描述
3. 地点:场景完整描述 + 空间布局 + 环境细节
4. 景别:段落内主导景别;多景别段落写组合,如"中景+特写"
5. 角度:平视/仰视/俯视/侧面/背面
6. 运镜:固定/推镜/拉镜/摇镜/跟镜/移镜(段落内不同子镜头可不同)
7. 画面描述 description:按 【镜头1】…【镜头2】… 逐子镜头描述观众实际看到和听到的内容——画面(谁 + 具体动作 + 肢体细节 + 表情)写在前;该子镜头有台词时以「角色名说:「台词」」写在对应 【镜头N】 内,旁白写「旁白:内容」
8. 画面结果 result:段落结尾的即时后果 + 视觉细节
9. 氛围 atmosphere:光线 + 色调 + 声音 + 整体氛围
10. 时长 duration:段落总时长 8-15 秒,且满足台词时长下限
11. 场景关联:若能匹配已有场景,必须填写 scene_id
12. 角色关联:填写 character_ids,绑定当前段落涉及的 0 到多个角色
13. 道具关联:填写 prop_ids,绑定当前段落出现的关键道具(0 到多个)
场景关联规则
- 优先使用
read_storyboard_context返回的scenes location + time可明确匹配时,必须回填正确scene_id- 不要凭空生成不存在的场景 ID
- 如果剧本内容明显落在已有场景中,不要重复创造新场景描述
角色绑定规则
character_ids必须从read_storyboard_context返回的角色列表中选择- 一个段落可以没有角色,也可以绑定多个角色
- 只要段落里有明确出场、被看见、发生动作或说话的角色,都应绑定进去
- 纯环境段落、空镜、物件特写可以传空数组
道具绑定规则
prop_ids必须从read_storyboard_context返回的道具列表(props)中选择- 道具被角色使用、交接、特写,或在画面中明显可见且对叙事有意义时,必须绑定到该段落
- 道具特写段落(无角色)也应绑定道具,
character_ids可为空 - 与剧情无关的背景物品、场景陈设不要绑定;没有道具出现的段落传空数组
- 绑定的道具会作为视频生成的参考图(白底单品图),保证道具外观跨段落一致
质量要求
description要适合人读,按子镜头详细描述观众实际看到和听到的内容;台词/旁白直接写在对应【镜头N】内image_prompt要突出单帧构图、角色外观、环境和光线(对应段落第一个子镜头)bgm_prompt和sound_effect用简洁短语即可,但不能空泛到只有“紧张”“悲伤”- 如需调整,调用
update_storyboard修改具体段落
常見問題
storyboard-breaker 技能有什麼用途?
將劇本分解為影片生成片段,每個片段長8-15秒,包含2-4個鏡頭,並附有動作、對話和氛圍的描述。
如何安裝 storyboard-breaker?
打開本頁的「安裝」區塊並選擇你的代理 — Claude Code、Codex、Cursor 或 Gemini CLI:那裡有把技能資料夾複製到正確位置的現成指令。也可以複製「透過助理」分頁中的提示,讓助理自行檢查並安裝技能。
storyboard-breaker 適用哪些 AI 模型?
技能是純 Markdown 指示(Agent Skills 格式),因此 storyboard-breaker 適用任何讀取 SKILL.md 的代理:Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 等。只有在任務符合技能描述時,模型才會載入指示。
storyboard-breaker 是免費的嗎?
此技能由 chatfire-AI 公開發布。技能本身免費 — 你只需向 AI 供應商支付實際使用的 token 費用。儲存庫未標示授權 — 商業使用前請向作者確認條款。
安裝技能安全嗎?
技能是代理會遵循的指示,安裝前請閱讀 SKILL.md 及相關檔案。技能資料夾中的腳本只有在代理執行時才會運行 — 留意它的動作,不要授予多餘權限。
技能和 MCP 伺服器或外掛有何不同?
MCP 伺服器或外掛為模型提供新工具 — 會執行並回傳結果的程式碼。技能提供的是知識與流程:如何處理任務、要遵循哪些步驟、好的成果長什麼樣子。它不需要伺服器或 API 金鑰。