| name | short-drama-storyboard |
| description | 把中文短剧剧本和视觉设定写成有戏剧职责、连续性边界与冻结关键帧提示词的分镜 Markdown。用户提出“拆分镜/设计镜头/做镜头表”“场次视觉计划/调度故事板”“比较导演方案”“写首帧/关键帧提示词”或检查轴线、站位、视线、持物连续性时使用；不生成媒体。 |
| license | MIT |
短剧分镜与冻结关键帧
把剧本和视觉事实转成有镜头职责、空间连续性和可冻结起点的 剧集/<EP>/分镜.md。
每镜使用二级标题 ## SHOT-...，同镜下用 ### 冻结关键帧提示词 写起始帧正文。
Quick Start
用 $short-drama-storyboard 完成 EP001 的正式分镜和每镜冻结关键帧
入口
当前剧本加必要视觉事实即可直接进入。资产图片提示词与分镜是兄弟分支，不互相等待。只有关键场次
真的存在多个成立导演方案时，才在上下文比较覆盖方案；普通场次直接设计。
创作者可读说明跟随项目语言；冻结关键帧的可复制正文跟随
short-drama.json#/format/prompt_language。没有 short-drama.json 时正文默认使用 en。
工作流
- 确认每个场景动作、对白、声音、画面文字和转折由哪些镜头承载。
- 确定观众何时知道什么、对齐谁、空间如何揭示、转折落在哪个可见动作。
- 每镜写清唯一职责、来源、时长、景别/机位、起点、终点、声音和引用的
IMG-... 参考。
- 锁定人物朝向、位置、视线、持物、出入口、屏幕方向和必要状态。
- 冻结关键帧只投影镜头起点；删除终点才出现的文字、动作、姿态或道具状态。
- 整集请求完成整集，末端一次报告覆盖、节奏和真实未决选择。
镜头要求
- 每镜有唯一职责、明确来源、可见起止状态和合理时长。
- 切镜必须带来信息、权力、情绪、空间或节奏变化；同义重复镜头删掉。
- 同一动作不跨镜重复发生；终点应能成为下一镜可信起点。
- 关键信息的可读性优先于装饰性运镜，竖屏构图优先保证主体和反应可见。
- 复杂群戏先锁空间锚点和屏幕方向，再决定景别变化。
- 冻结关键帧只写该瞬间能看见的内容；文字、手指、反射和遮挡要可生成。
- 检查发现遗漏就直接修正文档，不生成覆盖表来证明自己检查过。
按需知识
默认只读本 SKILL、当前剧本和必要视觉事实。遇到对应问题时只打开一份：
修订
保留未受影响的镜头 ID。拆镜、并镜或改变镜头职责时，说明哪些下游视频提示词需要刷新，但不自动
重写用户没点名的文件。
完成
点名范围的原文都有镜头落实，每镜职责不重复、空间与状态连续、起止边界可制作、关键帧可冻结，即
完成。视频提示词、生产和审查只有用户点名时开始。
安装维护
只有安装、升级或排障时运行 python3 scripts/selftest.py。
