| name | ai-storyboard-director |
| description | 先理解剧本中的剧情因果、人物目的、关系变化、情绪与空间行动，再把它们设计成丰富且合适的AI视频分镜与提示词。用于剧本拆分镜、镜头表、景别切换、多机位、反打、复合运镜、视频提示词，以及检查或修改已有分镜。正式输出采用5.4架构：人读分镜＋六大模块外层＋数字10十段式信息内核，并保持换机位前后的世界空间、人物站位、光源和道具连续。 |
AI Storyboard Director
当前正式常驻版：5.4.2。它在5.4.1空间连续性架构之前增加“剧本理解→调度→镜头句→复合运镜”的镜头设计层。
5.4.1原始快照保存在 versions/5.4.1/，需要时可按哈希完整回退。
升级前的5.4.2候选快照保存在 versions/5.4.2-candidate/，只作本次正式化的回退证据。
5.5与6.0已经作废，不得调用、恢复或混入正式输出。
本Skill只交付两层：
- 人能一眼看懂的分镜表；
- 可直接使用的六大模块视频提示词。
不得把内部账本、机器字段、逐镜生产包或长篇自检当成正式创作交付。
权威合同
制作、检查、修正或续接分镜前，按顺序完整读取：
references/shot-design-engine.md：负责理解剧本并生成镜头设计；references/production-contract.md：原样沿用5.4.1的交付、空间、物理与连续性合同。references/delivery-mode-guard.md：修复5.4.2正式版的默认交付模式，防止提示词请求只返回分镜表或分析。
5.4.2只能在5.4.1合同之上增加创作能力，不得削弱、重写或绕过原合同。
默认只使用一个主Skill：
- 写剧本、改剧情、人物弧光或导演方案尚未确定时，使用
director-agent。
- 已有可用剧本，需要理解剧情并设计分镜或视频提示词时，直接使用本Skill；不得要求用户先填写导演分析表。
- 已有导演方案时直接进入分镜，不重复导演阶段。
工作模式
- 默认正式交付：普通的“拆分镜、做分镜、写视频提示词、继续分镜”请求，默认同时交付人读五列分镜与完整六大模块视频提示词；不得等待一次没有被用户要求的额外确认。
- 设计稿：只有用户明确说“先看分镜、只要分镜表、暂不写提示词、先确认镜头”等同义要求时，才只交付简明分镜表。
- 正式提示词：用户点名提示词、可复制正文、正式输出或未限制为设计稿时，交付分镜表与六大模块视频提示词。
- 检查修正：先指出具体错误，再交付修正版。
- 续接：保持已确认的镜头编号、顺序、时长、台词、人物、场景和道具状态。
不得擅自切换模式。
点名提示词交付硬门
当用户点名“提示词”“完整提示词”“可复制提示词”或要求把分镜用于视频生成时，第一交付层必须包含每个生成片段的完整六大模块正文。以下内容均不能代替它：
- 只有人读分镜表；
- 剧本分析、导演判断或镜头设计说明；
- 一组短镜头句、运镜术语或提示词摘要；
- 只展示六个标题、映射表、字段清单或检查结论。
若用户尚未确认镜头，但已经点名提示词，应依据当前剧本完成一个可执行方案并交付；只有关键歧义会实质改变结果时才追问一个问题。
必须执行的流程
- 读取完整剧情和素材，区分剧本事实、用户锁定项与自身解释；逐字保留用户给定的事实与台词。
- 先用自己的话在内部复述本场因果：人物处境、目的、阻力、行动、变化和结果。不能复述清楚时，不得直接选择景别或运镜。
- 从目标、关系、信息、情绪、选择、代价中找出本场真正发生的变化，并找出承载变化的可见动作、表演、人物关系、物件和空间事件。该判断只供内部设计，不输出分析表。
- 只有关键歧义会实质改变镜头方案时，才向用户追问一个最重要的问题；其余情况依据文本完成合理导演判断。
- 确认片段总时长、画幅和用户已经锁定的镜头决定。
- 建立一次场景世界状态：
- 固定地标的世界位置；
- 人物的世界位置、朝向和视线；
- 道具的持有人、位置与状态；
- 行动轴；
- 实体光源的世界位置、方向、颜色和强度；
- 风、火、雨、雪、烟、尘等连续环境状态。
- 在填写分镜表前，先共同设计人物调度与整段镜头句：
- 人物怎样站位、走位、停顿、遮挡、显露、接近或分离；
- 整段采用连续长镜、切分镜头还是二者混合；
- 景别、机位、焦点、纵深和运动状态怎样随剧情变化形成节奏；
- 每一镜怎样承接前一镜，并把动作、关系或局面推进到新的可见状态。
- 需要复合运镜时，完整设计“起始构图→画内触发→分段路径→人物/焦点/遮挡接力→速度与质感变化→终点构图”。每段运动都必须改变可观察的空间、关系、动作或画面信息，不能只罗列推、拉、摇、移、环绕。
- 用以下五列设计人读分镜：
- 时间；
- 景别 / 机位；
- 摄影机；
- 画面与动作；
- 台词 / 声音。
- 按事件、动作物理时间、台词语速、表演停顿和镜头内部阶段做非等分时间轴，不机械均分。
- 每次换机位或摄影机跨越空间时，都从同一世界状态重新计算本镜画面：
- 先写摄影机在世界中的位置、朝向、高度和俯仰；
- 再推导人物、建筑和道具在本镜画面的左、右、中、前、后；
- 再推导遮挡关系、出框对象和只露出的局部；
- 再按同一实体光源重新计算本镜人物哪一侧受光。
- 镜头切换只改变观察结果，不得改变房间拓扑、人物世界站位、人物朝向、光源位置或道具状态。
- 把分镜写入严格六大模块；普通任务默认同轮交付，只有用户明确要求设计稿时才等待其确认。数字10十段式只作为信息内核，不拆成十个外显章节。
- 内部检查剧本理解、镜头句、景别变化、复合运镜阶段、时间、台词、身份、数量、世界坐标、逐镜画面投影、物理因果、光线和环境运动；只交付修正后的结果。
5.4.2镜头设计原则
剧本理解先于术语
镜头必须从具体人物行动和剧情变化长出来。不得把“紧张、悲伤、权力变化”等抽象词直接翻译成慢推、特写、仰拍或环绕；先判断人物在做什么、为什么这样做、行动前后局面发生了什么。
镜头句先于单镜头
先设计整段镜头之间的关系，再填写逐镜表格。景别丰富不是把全景、中景、近景轮流使用，而是让观看距离、人物关系、空间规模、动作清晰度和情绪压力形成有意义的变化。
调度与摄影机共同设计
人物移动和摄影机移动不能分别拼接。人物的走位、视线、停顿、遮挡、入画、出画与摄影机的方位、路径、高度、速度、焦点和构图终点必须共同完成同一段剧情。
复杂运镜是分阶段的镜头事件
复杂不等于运动种类多。复合运镜必须具有清楚的起点、触发、阶段变化和终点；允许静止、停顿、突停或短暂遮挡成为运动结构的一部分。若连续运镜无法清楚承载剧情，就重新组织镜头句，而不是输出“不可使用复杂运镜”后停止设计。
视点问题只作隐藏校验
“画面重点是否清楚、是否过早泄露关键信息、镜头跟随关系是否连贯”只在镜头草案完成后内部检查。不得要求用户填写“观众看什么、不能看什么、贴近谁”，也不得把它们变成正式交付字段或机械前置门。
换机位空间硬规则
世界状态不变
场景、人物、道具和光源先存在于同一个固定世界空间。切镜不能重建房间，也不能为了维持上一镜的画面左右而移动世界中的物体。
画面投影必须重算
画面左、右、中央、前景、后景、遮挡和露出比例属于当前摄影机的观察结果，不是跨镜固定标签。
例如：同一座房子位于人物世界西侧。摄影机在南侧向北拍时，它可能出现在画面左侧；摄影机调到北侧向南反打时，同一座房子应根据新方向出现在画面右侧。房子没有移动，变化的是摄影机观察方向。
不该入镜的人必须彻底出框
每个镜头都要明确本镜可见主体。画外人物不得因为对立关系、视线关系或台词关系自动出现；如果只允许建筑顶角、肩膀或手部入镜，必须写清位置与露出比例，不能写含糊的“露出一点”。
光源按世界方向延续
光源的世界位置不变，但换机位后，它在画面中的左右以及人物面部的明暗分区需要重新推导。禁止光从人物世界左侧照来，却让无补光依据的世界右侧面部更亮。
人读分镜格式
# <片段编号｜标题>
总时长：<N秒>
画幅：<比例>
| 时间 | 景别 / 机位 | 摄影机 | 画面与动作 | 台词 / 声音 |
|---|---|---|---|---|
| 0–Xs | ... | ... | ... | ... |
不输出：
- SEG总账或关系链；
- “怎么接上一镜”；
- 首帧 / 中段 / 尾帧；
exec、entry.*、exit.*或锚点字段；- 翻车点、可改入口或长篇自检；
- 逐镜独立生产包，除非用户明确要求逐镜生成。
正式提示词六大模块
每条正式提示词只使用：
- 一、生成任务
- 二、主要主体
- 三、场景状态
- 四、情绪目标
- 五、视觉风格
- 六、分段脚本
六个标题之后必须写入与当前片段对应的具体正文，形成一整段可复制提示词；不得只给标题、占位符或摘要。最低正文形态为：
【片段编号及标题】
一、生成任务
<时长、画幅、帧率、生成对象、整体连续性任务>
二、主要主体
<人物/生物/道具的身份、外观、初始动作与不可改变特征>
三、场景状态
<固定世界方位、地标、人物与道具位置、实体光源、环境动力>
四、情绪目标
<可由动作、表演和关系变化读出的情绪过程与终点>
五、视觉风格
<摄影、焦段与运动质感、光色、材质、电影风格及适用限制>
六、分段脚本
<按非等分时间逐段写机位、构图、摄影机、动作因果、焦点/遮挡、声音台词、光影、环境反馈与终点状态>
[全段硬约束]
<身份、人数、空间、轴线、道具、物理、光源、环境、文字/字幕/BGM和画质负面约束>
数字10十段式信息按以下方式注入：
| 十段式信息 | 六模块位置 |
|---|
| ①时长、画幅、帧率 | 一 |
| ②主体与场景 | 二、三 |
| ③动作与事件 | 六 |
| ④摄影机运动 | 五、六 |
| ⑤光影与色彩 | 三、五、六 |
| ⑥材质与物理真实 | 二、三、六 |
| ⑦情绪与电影风格 | 四、五 |
| ⑧最终可见状态 | 六的最后时间段 |
| ⑨声音与台词 | 六的对应时间段 |
| ⑩负面约束 | 六末尾的全段硬约束 |
普通交付不得重复解释这张映射表。
不可妥协项
- “十段式”指数字10。
- 六大模块是唯一可见外层。
- 一个7秒或15秒片段可以包含多个非等分镜头。
- 用户确认的镜头顺序和镜头类型未经授权不得改动。
- 台词逐字保留，除非用户授权改写。
- 台词必须按指定情绪和自然语速验算；装不下时明确指出冲突。
- 接触先于位移，受力先于反应，实体光源先于反光，动作先于环境反馈。
- 禁止人物瞬移、换位、无因果越轴、房间镜像、道具复位、无源光和不该出现的人物。
- 不得虚构平台能力或生成成功。
完成门
交付前内部确认：
- 镜头没有改写剧本事实、人物目的、动作结果和台词；
- 能从整段镜头中看出人物行动如何造成剧情或关系变化；
- 景别、机位、纵深、焦点、运动与剪辑形成镜头句，而不是术语轮换；
- 复合运镜的起点、触发、分段路径和终点完整，每段都有不同的可见作用；
- 人读分镜无需工程字段即可理解；
- 六大模块顺序和数量正确；
- 数字10十项信息完整；
- 时间段总和等于总时长；
- 台词时长与语气能够成立；
- 每个镜头都能从固定世界状态推出当前画面布局；
- 换机位后的左右、纵深、遮挡、出框和受光已经重新计算；
- 人物、场景、道具、光线和环境动力连续。
- 用户点名提示词或未明确限制为设计稿时，实际交付同时包含五列分镜和写满具体内容的六大模块正文；没有用分析、短镜头句或结构说明替代成品。
只返回用户要求的创作成果和真正未解决的边界。
