Short Drama Storyboard

---
name: short-drama-storyboard
description: 把中文短剧剧本和视觉设定写成有戏剧职责、连续性边界与冻结关键帧提示词的分镜 Markdown。用户提出“拆分镜/设计镜头/做镜头表”“场次视觉计划/调度故事板”“比较导演方案”“写首帧/关键帧提示词”或检查轴线、站位、视线、持物连续性时使用；不生成媒体。
license: MIT
---

# 短剧分镜与冻结关键帧

把剧本和视觉事实转成有镜头职责、空间连续性和可冻结起点的 `剧集/<EP>/分镜.md`。
每镜使用二级标题 `## SHOT-...`，同镜下用 `### 冻结关键帧提示词` 写起始帧正文。

## Quick Start

```text
用 $short-drama-storyboard 完成 EP001 的正式分镜和每镜冻结关键帧
```

## 入口

当前剧本加必要视觉事实即可直接进入。资产图片提示词与分镜是兄弟分支，不互相等待。只有关键场次
真的存在多个成立导演方案时，才在上下文比较覆盖方案；普通场次直接设计。

创作者可读说明跟随项目语言；冻结关键帧的可复制正文跟随
`short-drama.json#/format/prompt_language`。没有 `short-drama.json` 时正文默认使用 `en`。

## 工作流

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

## 镜头要求

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

## 视觉依据与图片

- `IMG-...` 是《图片提示词.md》里的**提示词条目 ID**，不代表图片已生成、已提供或可用。
- 已有《图片提示词.md》且本镜需要其中条目时，写「图片提示词项」：ID 必须匹配该文档的可见二级标题，同时写中文名称和它控制的身份、造型、地理、构图或其他边界。ID 只用于查找，不让英文 slug 承担含义。
- 没有《图片提示词.md》或没有合适条目时，写「图片提示词项：无」，再以中文指向《视觉设定.md》的人物、地点或道具项及控制范围。这是正常直接入口；不为继续分镜而编造 ID，也不补造另一个阶段。
- 「输入参考图」是独立的另一条轴：创作者已提供，或经确认生产且当前可读的实际图片，用不同于 `IMG-...` 的稳定 `REF-...` 槽位引用。每个槽位同时写显式顺序、仅用 `/` 分隔的项目相对路径、中文名称、「控制」和「不得控制」范围；没有就写「输入参考图：无」。不得把提示词条目、计划生成的图或对话中的描述写成已有图片。
- 两条轴可以独立组合：有合法的图片提示词项时，输入参考图仍可为「无」；创作者给了真实参考图时，图片提示词项也可为「无」。

## 按需知识

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

- 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
- 镜头职责、切镜理由和边界：[镜头手艺](references/shot-craft.md)
- 实际制作所需的镜头语法：[生产镜头语法](references/production-shot-grammar.md)
- 关键场次比较导演方案：[场次视觉计划](references/scene-visual-plan.md)
- 检查原文是否都有画面承载：[Coverage Audition](references/coverage-audition.md)
- 多人、群体和复杂空间调度：[调度手册](references/blocking-playbooks.md)
- 冻结瞬间、注意中心和可读性：[关键帧手艺](references/keyframe-craft.md)
- 漫剧/二维漫画形态的共享画风词汇：[漫剧关键帧词表](references/comic-keyframe-lexicon.md)
- 剧本事实到关键帧的完整示例：[剧本到关键帧](references/screenplay-to-keyframe-example.md)
- 拆镜、并镜和稳定镜头 ID：[镜头修订身份](references/shot-revision-identity.md)
- 完成前的连续性检查：[审查与示例](references/review-and-fixtures.md)

## 修订

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

## 完成

点名范围的原文都有镜头落实，每镜职责不重复、空间与状态连续、起止边界可制作、关键帧可冻结，即
完成。视频提示词、生产和审查只有用户点名时开始。
五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。

## 安装维护

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