/SKILL.md
视频分镜脚本生成器,支持头脑风暴、用户偏好记忆、15秒镜头规则、角色提示词生成、音效/BGM建议。用于生成带运镜指导、画面设计、旁白、角色描述的完整分镜脚本。支持极简版(内容描述)和专业版(详细运镜)。适用:教程、书籍介绍、评论、剧情、产品介绍、数据报告。当用户说"做分镜"、"分镜脚本"、"视频分镜"时使用。
npx skillsauth add oyyh-apple/video-storyboard-generator video-storyboard-generatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
通过头脑风暴与用户共同确定视频需求,基于用户画像提供个性化建议,生成结构化的视频分镜脚本。
📋 新手推荐: 查看
references/quick-reference.md获取一页纸速查表
段落是主题驱动的,不是标准化的:分镜的段落结构完全取决于视频主题和内容需求。
需求需要共同探索:用户可能对视频的具体表现形式不够清晰,需要通过头脑风暴一起确定。
用户画像驱动个性化:系统会记忆用户的偏好,在后续交互中提供更贴合用户喜好的建议。
镜头时长规则:默认单个镜头时长不得超过15秒(可自定义)。
内容安全规范:所有分镜内容必须符合安全标准,不包含暴力、血腥或不适描述。详见 references/content-safety.md。
在开始任何交互前,检查用户画像文件是否存在:
C:\Users\[用户名]\.video-storyboard\user-profile.md~/.video-storyboard/user-profile.md<用户主目录>/.video-storyboard/user-profile.md如果画像文件存在: 读取用户画像后,必须询问用户:
"检测到您之前的使用偏好记录。是否使用之前的偏好设置?"
- 是:应用用户画像中的偏好设置作为推荐
- 否:忽略画像记录,使用默认设置
如果画像文件不存在: 使用默认设置,并在本次交互结束后询问是否保存偏好。
详见 references/user-profile.md。
根据用户描述识别视频类型,详见 references/video-types.md。
根据视频类型进行针对性的头脑风暴,详见 references/questions-by-type.md。
所有视频类型都需要确认: 5. 镜头时长限制 - 单个镜头最长时长(根据视频总时长自动推荐)
分镜版式 - 需要极简版(仅内容描述)还是专业版(详细运镜指导)?
音效/BGM - 需要音效和BGM建议吗?
旁白/台词呈现方式 - 如何展示旁白和角色台词?
OpenCode提示词 - 需要生成可在OpenCode中使用的执行提示词吗?(仅专业版)
Seedance 2.0 提示词 - 需要生成可用于Seedance 2.0 AI视频生成工具的提示词吗?
详见 docs/Seedance2.0提示词模板.md
故事类、剧情类、电影类视频额外确认: 11. 角色设定 - 主要角色有哪些? - 角色数量和定位 - 角色外貌特征 - 角色性格特点 - 是否需要角色提示词(用于AI生成角色形象)
详见 references/character-prompts.md。
根据视频类型和用户画像推荐风格,详见 references/visual-styles.md。优先推荐用户画像中记录的偏好风格。
根据视频类型和头脑风暴结果,设计段落结构。详见 references/story-patterns.md。
设计原则:
核心规则:单个镜头时长不得超过用户设定的上限(默认15秒)
超过上限的镜头必须拆分为多个子镜头,确保视觉节奏紧凑、镜头间有明确的运镜变化。
拆分策略详见 references/shot-duration.md。
在生成分镜脚本前,必须进行系统性检查,确保分镜内容逻辑合理、流畅连贯。
| 检查项 | 检查内容 | 通过标准 | |--------|----------|----------| | 内容完整性 | 画面描述是否完整 | 包含主体、动作、环境三要素 | | 时长合理性 | 是否遵守15秒规则 | 不超过用户设定的时长上限 | | 动作可行性 | 描述的动作能否在时长内完成 | 动作复杂度与时长匹配 | | 视觉可执行性 | 效果是否可实际制作 | 技术可实现,无不可能描述 | | 内容安全性 | 是否符合安全规范 | 无暴力血腥,详见content-safety.md |
检查失败示例与修正:
❌ 问题分镜:"主角在3秒内完成从城市一端跑到另一端"
✓ 修正:拆分为3个镜头,每个展示不同阶段的奔跑
❌ 问题分镜:"特写镜头同时展示全景和微观细节"
✓ 修正:拆分为全景镜头 + 特写镜头
❌ 问题分镜:镜头A"人物躺下休息" → 镜头B"双手无力地下垂"
✓ 修正:躺卧姿势下手应描述为"双手自然放置在身侧"
❌ 问题分镜:镜头A"手拿咖啡杯" → 镜头B"双手插兜走开"
✓ 修正:增加过渡"放下咖啡杯"或保持道具连贯
叙事连贯性检查:
空间与物理逻辑检查:
情绪连贯性检查:
信息递进检查:
节奏检查清单:
视觉多样性检查:
音画同步检查:
第一步:分镜自查(AI自我检查) 逐条检查每个分镜的5项内部逻辑,标记问题分镜。
第二步:段落审查(整体连贯性) 按段落检查分镜间逻辑,确保叙事、空间、情绪、信息四维度连贯。
第三步:流畅度评分 为整个分镜脚本打分(1-10分),低于7分需优化。
第四步:问题汇总与修正
问题汇总格式:
- 段落X,镜头Y:问题描述
- 建议修正:具体修改方案
- 优先级:高/中/低
第五步:迭代优化 修改问题分镜后,重新执行检查流程,直到全部通过。
基于确定的段落结构和镜头拆分结果,生成完整的分镜脚本。
根据用户选择,生成分镜脚本:
极简版输出:
专业版输出:
如果视频类型是剧情类、故事类、电影类,为每个主要角色生成AI绘画提示词:
内容安全要求:
references/content-safety.md)角色提示词包含:
主角1: 年轻女性,短发,白色衬衫,面部轮廓清晰,电影风格,电影光效,8k,高质量 --ar 9:16
主角2: 中年男性,西装,面部线条分明,写实风格,电影光效,4k,细节丰富 --ar 9:16
重要:角色提示词中禁止使用描述临时状态的词语(如"微笑""惊讶""奔跑"),应使用描述外貌特征和姿势的词语。
专业版分镜脚本生成时,为每个场景生成场景提示词:
场景提示词包含:
格式示例:
场景1-深夜办公室: 室内办公空间,深夜,电脑屏幕冷光+窗外城市灯光,冷蓝色调,办公桌、多显示器、咖啡杯、散落的文件、落地窗外城市夜景
详见 references/scene-prompts.md。
专业版分镜脚本生成时,为重要道具生成道具提示词(精简原则:只抓取重要道具):
道具分类判断:
道具提示词包含:
格式示例:
道具-咖啡杯: 白色陶瓷马克杯,表面有轻微咖啡渍痕迹,把手一侧有细微裂纹,放置在办公桌右侧,场景1专用
详见 references/prop-prompts.md。
专业版分镜脚本生成时,为每个有角色出场的分镜生成分镜角色提示词:
与基础角色提示词的区别:
分镜角色提示词包含:
格式示例:
林晓明-分镜1: 疲惫状态,眼圈微暗,白衬衫袖口卷起,领带松散,眉头微皱盯着屏幕,坐姿前倾,办公桌前,场景1
精简原则:
详见 references/character-prompts.md 中的"分镜角色提示词"部分。
专业版分镜脚本生成时,微表情控制直接融入分镜角色提示词,用流畅的自然语言描述。
核心原则:
三要素融合描述:
正确示例(自然语言写法):
林晓明-分镜3: 站在会议室前方准备汇报PPT,由于担心数据不够理想,他的眉头逐渐紧锁,眼神中透着掩饰不住的不安,嘴角紧抿成一条线,整个人绷得像一张拉满的弓,手持翻页笔,场景2
错误示例(机械拆分,不推荐):
微表情:
- 情绪:紧张(强度3级)
- 原因:即将汇报工作
- 演变:平静→紧张
详见 references/micro-expression-control.md。
音效:
BGM:
详见 references/audio-bgm.md。
每个段落包含:
极简版镜头内容(必须使用text代码块格式):
画面描述:简洁说明镜头要展示什么
时间:镜头时长
旁白/台词:对应该镜头的解说词或角色台词(如果没有则标注"无")
专业版镜头内容(必须使用text代码块格式):
运镜描述:速度、方向、缓动函数
画面布局:电影级构图方式(三分法/黄金分割/对称/框架式)、景别(远景/全景/中景/近景/特写)、视觉重心位置
视觉元素:具体元素描述(含角色微表情,特别是有角色戏份时)
过渡方式:镜头间过渡效果
时间:镜头时长
音效(如启用):具体音效类型
BGM(如启用):音乐类型和音量
旁白/台词:对应该镜头的解说词或角色台词(如果没有则标注"无")
视觉元素中的微表情描述:
当镜头有角色戏份时,视觉元素应包含角色的微表情描述,用自然语言流畅表达:
示例:
视觉元素:主角站在会议室前方,手持翻页笔指着PPT上的数据图表。由于担心数据不够理想,他的眉头逐渐紧锁,眼神中透着掩饰不住的不安,嘴角紧抿成一条线,整个人绷得像一张拉满的弓。
微表情与运镜配合:
旁白和台词一致性:
如果用户选择生成,创建可在 OpenCode 中直接使用的提示词,用于执行视频制作(仅专业版生成)。
如果用户选择生成Seedance 2.0提示词,为每个镜头生成符合AI视频生成格式的提示词:
提示词结构(每镜头一个,必须使用text代码块格式):
[主体描述]:详细描述主要角色/物体外观、服装、年龄、体型、表情等。
[场景与氛围]:描述环境、光线、天气、色调、整体风格(电影级、写实、赛博朋克等)。
[动作与情节]:按时间顺序描述该镜头的完整动作流程,在需要说话的时刻标注"(角色说:XXX)"或"(旁白响起)"。动作要具体、可视化。
[台词与旁白]:精确写出该镜头的台词/旁白文字内容、说话角色、语气、语速、情感。
[镜头语言]:明确镜头运动和剪辑方式(从低机位缓慢推近、360度环绕拍摄、快速切镜、长镜头跟随等)。
[音画同步/音频]:描述音效、BGM、以及台词/旁白与画面的同步要求(台词在角色张嘴时精确对齐唇动、旁白在镜头推近时渐强等)。
[其他控制]:时长(建议15秒以内)、分辨率(1080p或更高)、质量要求(高度逼真,细节丰富,无畸变)。
注意事项:
docs/Seedance2.0提示词模板.md 中的示例格式在生成分镜文档前,确认文件保存位置。
默认位置: 用户当前项目的 /docs 文件夹
分镜生成完成后,更新用户画像文件。记录本次交互中用户的选择偏好,详见 references/user-profile.md。
我们提供两个层级的运镜参考文档,根据您的需求选择:
| 文档 | 级别 | 适用场景 | 内容特点 |
|------|------|----------|----------|
| camera-movements.md | 基础 | 快速查阅、入门学习 | 6种核心运镜,简洁易懂 |
| cinematic-camera-movements.md | 专业 | 电影级制作、深度需求 | 20+种运镜,含复杂组合、情绪对照 |
常用运镜类型,详见 references/camera-movements.md:
专业电影运镜技术,详见 references/cinematic-camera-movements.md:
基础运镜扩展:
复杂运镜组合:
运镜情绪对照:
📐 专业构图布局技术详见
references/cinematic-layouts.md
电影级别构图与布局技术:
构图法则:
景别系统:
布局方案:
推荐新手先查阅:
references/quick-reference.md- 一页纸速查表,涵盖所有常用参数和规则
assets/storyboard-template.md - 分镜模板文件(含变量说明和头脑风暴清单)config/user-profile-template.md - 用户画像模板references/video-types.md - 7类视频类型对照表references/questions-by-type.md - 按视频类型的提问清单references/visual-styles.md - 视觉风格参考references/shot-duration.md - 镜头时长和拆分规则references/story-patterns.md - 12种叙事模式references/output-templates.md - 输出格式模板(含极简版和专业版)references/content-safety.md - 内容安全规范(暴力血腥替换方案)references/camera-movements.md - 基础运镜类型参考references/cinematic-camera-movements.md - 电影级别运镜参考(含复杂运镜组合)references/cinematic-layouts.md - 电影级别画面布局参考(含构图法则、景别系统)references/scene-prompts.md - 场景提示词生成指南references/prop-prompts.md - 道具提示词生成指南references/character-prompts.md - 角色提示词生成指南(含分镜角色提示词)references/user-profile.md - 用户画像机制docs/Seedance2.0提示词模板.md - Seedance 2.0 AI视频生成工具提示词模板references/cinematic-layouts.md)
references/cinematic-camera-movements.md)
生成的分镜脚本包含:
详见 references/output-templates.md。
content-media
Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).
content-media
QQBot 富媒体收发能力。使用 <qqmedia> 标签,系统根据文件扩展名自动识别类型(图片/语音/视频/文件)。
content-media
Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).
content-media
QQBot 富媒体收发能力。使用 <qqmedia> 标签,系统根据文件扩展名自动识别类型(图片/语音/视频/文件)。