| name | short-drama-storyboard |
| description | 把已接受的中文短剧剧本和资产转成原文落实表、有戏剧动机的镜头、连续性边界与冻结关键帧提示词；关键场次可先做场次视觉计划或 Coverage Audition 比较真正不同的导演方案。用户提出“拆分镜/设计镜头/做镜头表”“场次视觉计划/调度故事板”“比较导演方案/Coverage Audition”“写首帧/关键帧提示词”“检查轴线、站位、视线、持物连续性”，或需要在不生成媒体的前提下把竖屏短剧、漫剧的剧本内容转成可拍的画面时使用。 |
| license | MIT |
短剧分镜与冻结关键帧
先守住故事内容，再安排原文落实、空间和镜头，最后写冻结关键帧。不在这里写随时间
变化的运动提示词，也不改写剧本或资产事实。
镜头目的、边界说明与场次视觉计划是创作者读的：项目内跟随 short-drama.json#/language，
独立运行时跟随用户使用的语言。关键帧的可复制提示词正文在项目内跟随
#/format/prompt_language，独立运行时由用户指定、未指定则为 en。不要用
其中一个推断另一个。ID、规则编号和字段名在两者之下都保持原样。
Quick Start
离线验证时长合计和关键帧边界绑定的正反例：
python3 {技能目录}/scripts/selftest.py
python3 {技能目录}/scripts/storyboard_check.py <coverage.json> --shots <shots.jsonl> --keyframes <keyframes.jsonl>
开始前
本技能可独立安装和执行。先读取用户明确提供的剧本、资产与本任务直接输入；若当前目录是
short-drama 项目且项目工具可用，可以读取 status 并使用其发布生命周期，但缺少 core
或任何其他技能都不是分镜工作的阻断条件。阶段契约 给出
本阶段边界、制作形态输入与规则表，无需读取其他技能的文件。
按需读取资料
始终读取：
- 状态为
accepted 的 screenplay.md 与 screenplay-index.jsonl；
- 状态为
accepted 的资产、版本与相关连续性；
short-drama.json#/creator_authority/visual_direction 中状态为 accepted 的视觉方向；
若状态为 unset，就向创作者给出选择，不从对话记忆补造。
设计原文落实、场面调度、摄影机和剪切时读
shot-craft.md；只有写冻结帧时读
keyframe-craft.md。需要制作端的时长依据、景别与运镜
词表或时间片写法时读 production-shot-grammar.md。
关键场次需要先组织整场的立场、空间、摄影与声音运动时读
scene-visual-plan.md；第一种合理拍法不应直接成为唯一答案时加读
coverage-audition.md。
涉及背影、裁切、遮挡、画外或延迟揭示时读
阶段契约 的参考媒体与补拍一节。
只有所有权或直接输入影响不清楚时，才读核心所有权契约。
每轮的工作单元
一轮处理一个场次或一段连续镜头范围。整集请求按这些边界拆成若干轮，每轮：
- 只读这个范围的直接输入，做它的覆盖与镜头设计，跑本地结构检查；
- 落盘这个范围，其余范围保持原样；
- 报告已覆盖范围、剩余范围、未决 coverage 和下一个值得做的范围；
- 交还控制权，等创作者的下一次请求。
视频提示词、生产和审查各自是独立的工作单元，由创作者明确请求时开始。
工作流
1. 先确认每段原文由谁落实
从 coverage-template.json 开始，接受后发布为
剧集/<EP>/storyboard/coverage.json。每个与制作有关的剧本段落都必须标明一种处理：
covered：由一个或多个镜头落实；intentional_repeat：因表演或剪辑需要而有意重复，并写明理由；omitted_with_reason：有理由地省略；nonvisual_context：仅供理解、无需直接呈现的内容。
对白、动作、画面文字、画外音或关键音效还没有着落时，不要先追求漂亮镜头。
发布原文落实表时，先在文件的 sources 里为每个上游快照声明一次 owner 与 artifact，再让每条 shot_refs 用 src 指向该声明并写上 record_id。裸 shot_id
只可表示同一镜头文件内的关系，不能证明审的是哪一版。
2. 关键场次先比较整场导演选择（可选）
只有导演选择明显改变体验时才增加本层。若存在多种真正不同的观看方法，先用
coverage-audition.example.jsonl 比较信息时机、对齐对象、
表演空间、最强画面、落点、损失和制作相容性；创作者选择后，再用
scene-visual-plan.example.jsonl 把所选方法写成整场的戏剧转向、
观众立场、空间压力、视觉推进、摄影节奏、反应落点与声音策略。只有一个明确方法时直接写计划，
不为流程完整补 audition。
这层不新增剧本/资产事实，也不拥有 shot purpose、duration 或 start/end boundary。普通场景跳过；
不固定方案数、宫格或镜头数。
3. 先写镜头目的
使用 shot-template.jsonl，接受后发布为
剧集/<EP>/storyboard/shots.jsonl。每个镜头先用一句话回答：
- 观众此刻必须注意什么、感到什么；
- 信息、情绪、观众立场或权力关系发生什么变化；
- 为什么要在这里切镜，而不是留在前一镜。
同时按事实填写 audience_visibility：准确来源、现在展示还是暂缓展示、可见或可听的
载体，以及各自的 reveal_trigger（何时揭示）和 protection_method（怎样防止提前泄露）。
遮挡不是默认的画面风格：它既不能提前泄露剧本保留的信息，也不能藏掉本镜必须交代的
证据或反应。
之后才选择景别和摄影机行为。镜头不是给动作段落加几个摄影形容词。
若本场有已接受视觉计划，每镜用准确 scene_visual_plan_ref 说明自己投影其中哪一段变化；
只在这类镜头记录中新增该字段。普通场景完全省略；计划与来源冲突时退回负责人，不靠 shot 覆盖。
4. 绑定空间和资产
绑定准确的场景及视角、人物及造型、道具及状态和剧本来源段落，并建立：
- 位置、朝向、视线、屏幕运动方向与轴线；
- 进出路线和不随镜头改变的场景锚点；
- 双手与持物、伤势与服装、文字状态、光线方向；
- 有权威性的镜头开始边界和结束边界。
可见字样必须通过 text_treatment_refs 指向资产负责人已接受的文字政策。预览只能
指向带 authority: candidate 的候选政策。镜头和关键帧可以决定构图怎样让文字可见，
但不得把 exact_readable 偷换成装饰字、凭空写新文案，或用自由文本代替政策引用。
需要的资产或状态缺失、含混时，向资产或编剧环节提出修订，不要猜绑定关系。
若创作者要求从头到尾预览，只能针对唯一且不是 unresolved 的提案建立临时的原文落实、
镜头和关键帧。候选引用要明确标为待确认，不得写成已接受的绑定，
也不得获得最终批准。
5. 设计能够制作的镜头
短镜头通常围绕一个主要动作，再保留让观众读懂后果所需的反应；这不是镜头数量公式。
一个镜头守不住空间关系、表演、对白或信息变化时就拆开；新切镜没有增加注意重点或
戏剧价值时就合并。
上游明确的事件先后也是故事事实，不是可以为省镜头而重排的素材。把相邻镜头的开始/结束
边界顺读一遍：冻结首帧不得提前包含本镜随后才发生的认出、松手、决定或持物变化；合并镜头
也只能压缩停留，不能让后发生的接收跑到前一个动作之前。
时长表示剪辑意图。只有明确的计时算术可以机械检查；一般的可拍性必须结合本镜内容判断。
写 duration_seconds 之前，先按项目在 short-drama.json 的 format.pacing 里声明的速率，
把每个镜头认领的剧本块折算成秒——台词按字数、动作段按段数，这与 duration_estimate.py 在
剧本阶段用的是同一组速率。折算值是起点，为节奏调整它是创作决定；跳过折算直接凭感觉写，
整集总时长会到覆盖检查那一步才暴露，而那时要重排的是全部镜头。项目没有声明速率时先向
创作者要一个量级。
6. 默认每镜一个冻结关键帧
使用 keyframe-template.jsonl 写结构化来源，发布为
剧集/<EP>/storyboard/keyframes.jsonl；再用
keyframe-prompts.md 渲染可复制的派生文本。结构化关键帧
保存只属于单帧的选择；Markdown 不是第二份事实来源。
把已接受镜头的开始边界和准确资产版本，落到一个可以同时存在的瞬间：焦点、构图、
摄影机与镜头焦段、空间锚点、姿态、目光、双手与持物、表情、光线、排除项。
generic_prompt 写这一瞬间要拍出来的画面本身，按 keyframe-craft.md 的十二项逐条写满，
那里有一段四百余字的成稿可以照着写。它只含要被拍出来的内容——不写镜头/记录 ID、规则 ID、
状态词与成段否定罗列（SHT-21）。同一集里两条关键帧的正文不应该只有编号不同：
读起来一样，说明写的是模板不是画面。
关键帧不得包含“先、再、最后”、表演变化过程、运镜过程或正在变化的环境；时间变化
交给 $short-drama-video-prompts。
7. 校验并呈现
先做原文落实、参考图权限和连续性的结构检查，再按制作资料自检。
候选预览也必须精确加总逐镜数值时长；若仍有未定时长或尚未完成这笔账，宁可省略总时长并
列出未决项，也不要写一个与镜头表不一致的约数。
时长账目与关键帧边界这两项是纯记账，交给
storyboard_check.py 核对，不要用人工目测代替：
python3 <skill-dir>/scripts/storyboard_check.py 剧集/EP001/storyboard/coverage.json \
--shots 剧集/EP001/storyboard/shots.jsonl \
--keyframes 剧集/EP001/storyboard/keyframes.jsonl \
--screenplay-index 剧集/EP001/screenplay-index.jsonl \
--project short-drama.json
给了 --screenplay-index 就多做一项覆盖对账：剧本的每一个块必须被恰好一个镜头认领。
没有镜头认领的块不会被拍，两个镜头认领的块会被剪两次。认领按块 ID 走
（source_refs 里的 record_id），不按正文——正文一直在改，块 ID 不变。
它只做算术和结构比对：本集时长总和是否等于各镜头 duration_seconds 之和、覆盖列出的
镜头有没有既不计入也不挂起、有没有边界条目整条写成「同上」「位置不变」这类回指、
每张关键帧是否声明了 boundary_role 并绑定对应边界字段、
同一镜头的同一端有没有两张关键帧、每条引用的 src 能否在本文件 sources 里解析到一个
上游快照。有 --project 且项目声明了每集目标时长时，还会核对
带符号差值。差值不是缺陷，脚本只检查它算得对不对。
脚本报错时先修产物再继续；它不评价镜头好坏，也不决定该拆多少镜。需要逐条查诊断码
含义、或确认某项该由脚本判还是由审查者判时，读
review-and-fixtures.md。
候选选择清单必须覆盖正文中全部新增导演选择；没有必要让创作者判断的环境微动、具体手位或
声音时机就删除，不能一面写进可执行提示词，一面在接受摘要中省略。
摘要按选择类别总括本场全部新增的观众立场/信息时机、代表帧/最强画面/场尾落点、
机位/景别/运动与停留、时长/节奏、手势/目光/表演信号、声音进入/撤出/留白与视觉处理，
并声明“正文中未由来源接受的执行选择仍全部保持候选”，
不逐镜复述已经清楚标注的细节。只点名会改变信息时机、因果顺序、观众立场或表演所有权、
可读文字、场尾落点、制作成本或回退路径的高影响例外；正文新增项若既不在类别范围内也未被点名，
就删除或补入摘要。总括是接受范围，不会把正文选择悄悄升级为已接受事实。
若创作者尚未声明交付面遮挡区，内容构图仍可作为候选比较，但播放面避让核验保持 blocked，
整体不能称为 delivery-ready；该缺口必须出现在本次准备度摘要中。只列真正影响当前候选判断或
请求交付范围的缺口，不要罗列与本次候选判断无关的正式发布先决条件。
按顺序呈现：
- 尚未落实的原文与
unresolved 项；
- 按场分组的镜头表；
- 可复制的关键帧提示词；
- 相对剧本原意发生的差异；
- 需要创作者接受的选择。
本技能不在本轮自动启动终审；需要 delivery verdict 时，把当前有界范围作为单独请求交给
$short-drama-review。
修订
若运动提示词环节要求修改镜头开始或结束边界，负责人仍是本技能。对照剧本原意审查
提议，修改当前有界范围的镜头与关键帧，并展示哪些旧产物已经关闭或需要刷新。运动提示词与
终审属于后续的独立工作单元，本轮只报告它们的影响范围。
运动提示词文件不得悄悄变成第二份边界事实。
镜头重排、插入、拆分或合并时读取
shot-revision-identity.md，保留稳定身份、retire 被替代 ID，
并重新对账 coverage 与全部下游引用；只在确有 predecessor/retirement 时新增
revision_lineage，并使用 按需 lineage 片段；普通新镜不保存
空 lineage。不用数组位置或文本相似度决定 ID。
边界
- 不生成图片或视频。
- 镜头绑定资产，不把完整外观描述复制到每一镜。
- 外部制作单位不等于创作镜头本身的编号。
- 镜头数量、每次切镜秒数、焦段分布都不是通用定律。
- 新增或删除故事事实，必须先由编剧环节修订。
- 创作者要求把已接受关键帧实际生成图片时，连同绑定和参考文件交给
$short-drama-produce；由生产技能展示任务预览并取得明确确认，本技能不调用媒体服务。
所有产物
剧集/<EP>/storyboard/coverage.json剧集/<EP>/storyboard/coverage-auditions/<SC>.jsonl（仅关键场次需要比较方案时；每场独立接受，项目工作历史，
默认不进执行交付包；accepted 后打包时显式传 --omit，不会按文件名静默排除）剧集/<EP>/storyboard/scene-visual-plans/<SC>.jsonl（仅关键场次需要场次计划时；每场独立接受）剧集/<EP>/storyboard/shots.jsonl剧集/<EP>/storyboard/keyframes.jsonl剧集/<EP>/storyboard/keyframe-prompts.md（仅派生文本）
