short-drama-storyboard

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。

工作流

1. 确认每个场景动作、对白、声音、画面文字和转折由哪些镜头承载。
2. 确定观众何时知道什么、对齐谁、空间如何揭示、转折落在哪个可见动作。
3. 每镜写清唯一职责、来源、时长、景别/机位、起点、终点、声音和引用的 IMG-... 参考。
4. 锁定人物朝向、位置、视线、持物、出入口、屏幕方向和必要状态。
5. 冻结关键帧只投影镜头起点；删除终点才出现的文字、动作、姿态或道具状态。
6. 整集请求完成整集，末端一次报告覆盖、节奏和真实未决选择。

镜头要求

• 每镜有唯一职责、明确来源、可见起止状态和合理时长。
• 切镜必须带来信息、权力、情绪、空间或节奏变化；同义重复镜头删掉。
• 同一动作不跨镜重复发生；终点应能成为下一镜可信起点。
• 关键信息的可读性优先于装饰性运镜，竖屏构图优先保证主体和反应可见。
• 复杂群戏先锁空间锚点和屏幕方向，再决定景别变化。
• 冻结关键帧只写该瞬间能看见的内容；文字、手指、反射和遮挡要可生成。
• 检查发现遗漏就直接修正文档，不生成覆盖表来证明自己检查过。

按需知识

默认只读本 SKILL、当前剧本和必要视觉事实。遇到对应问题时只打开一份：

• 阶段边界与规则分级：阶段契约
• 镜头职责、切镜理由和边界：镜头手艺
• 实际制作所需的镜头语法：生产镜头语法
• 关键场次比较导演方案：场次视觉计划
• 检查原文是否都有画面承载：Coverage Audition
• 多人、群体和复杂空间调度：调度手册
• 冻结瞬间、注意中心和可读性：关键帧手艺
• 漫剧/二维漫画形态的共享画风词汇：漫剧关键帧词表
• 剧本事实到关键帧的完整示例：剧本到关键帧
• 拆镜、并镜和稳定镜头 ID：镜头修订身份
• 完成前的连续性检查：审查与示例

修订

保留未受影响的镜头 ID。拆镜、并镜或改变镜头职责时，说明哪些下游视频提示词需要刷新，但不自动 重写用户没点名的文件。

完成

点名范围的原文都有镜头落实，每镜职责不重复、空间与状态连续、起止边界可制作、关键帧可冻结，即 完成。视频提示词、生产和审查只有用户点名时开始。

安装维护

只有安装、升级或排障时运行 python3 scripts/selftest.py。