| name | tapcanvas-storyboard-expert |
| description | 统一的 TapCanvas 章节分镜专家。用于“漫剧创作/章节剧本/分镜提示词/Seedance 片段脚本/章节出镜头”任务，默认输出 storyboard-director/v1.1 JSON，同时内置 Seedance 时间轴片段脚本、资产规划、对白/OS/VO/闪回格式与连续性收口方法。 |
| disable-model-invocation | false |
TapCanvas Storyboard Expert
何时使用
当用户要你根据小说/剧本章节生成可执行提示词，并明确要求：
- 分多个镜头输出
- 每个镜头要素齐全
- 可直接用于图像/视频模型生成
核心目标
把“叙事文本”转换成“可执行的镜头生产 JSON”，并让输出可同时服务：
- 3D 建模师（形体/材质/姿态约束）
- 导演（调度/镜头/光线/节奏）
- 定格动画（帧步进/微抖动/手工痕迹）
- Seedance / 短剧视频生成（15 秒片段时间轴、镜头节奏、参考图图位、承接上一片段尾帧）
统一职责边界
本 skill 是当前仓库里唯一的章节分镜与 Seedance 派生产物主技能，统一负责：
- 章节正文 -> 章节剧本 / 分镜结构
- 角色 / 场景 / 道具资产规划
- Seedance 15 秒片段时间轴脚本
- 对白、OS、VO、闪回、字幕的脚本表达
- 上一片段尾帧 -> 下一片段首帧的连续性收口
若任务需要 Seedance 风格片段脚本，也必须在本 skill 内完成，不允许再切出平行分镜方法论。
附属参考资料
本 skill 附带以下权威参考资料：
references/seedance-manual.mdreferences/故事转视频脚本-转换工具.mdreferences/优化分镜.mdreferences/好剧本.md
当用户任务明确落在以下场景时，应主动读取对应 reference，而不是只依赖本文件摘要：
- 多模态 Seedance 输入限制、参考图/参考视频/参考音频用法、视频延长、视频编辑、音乐卡点
- 产品展示、角色动作、旅拍、空间漫游、口播、战争、长镜头追踪、伪纪录片等专门模板
- 从原始故事抽取核心梗、人物小传、三幕/四幕结构、15 秒集数弧线、尾帧衔接检查
- Seedance 提示词优化公式、动作/镜头/光影/画质/约束关键词
Seedance 多模态能力边界
当宿主明确要求输出可直接用于 Seedance 的提示词时，同时遵守以下多模态边界：
- 最多 12 个输入文件
- 图片参考
<= 9
- 视频参考
<= 3，总时长 <= 15s
- 音频参考
<= 3，总时长 <= 15s
- 支持的 Seedance 任务模式包括：
- 参考图像生成
- 参考视频复刻
- 视频延长 / 续拍
- 视频编辑 / 剧情改写
- 音频驱动口播
- 音乐卡点剪辑
- 不支持把“写实真人脸部素材”当成稳定可复刻输入；若用户强依赖此能力，必须显式提示限制
这些是 Seedance 侧操作约束，不得在派生 prompt 时遗漏。
Seedance 任务询问框架
当用户给的信息不足以直接写出稳定的 Seedance 提示词时，先补齐以下信息：
- 这条视频讲什么故事，核心冲突或卖点是什么
- 时长是多少，默认是否为 15 秒
- 现有参考素材有哪些：图片 / 视频 / 音频
- 画幅比例：
9:16 / 16:9 / 2.35:1
- 整体风格、色调和氛围
- 镜头语言：景别、运镜、转场
- 动作节奏：舒缓 / 急促 / 是否卡音乐拍点
- 声音设计：配乐、环境音、对白、旁白
若这些信息无法从上下文证据中恢复，必须显式指出缺口，而不是脑补。
输出模式（默认）
默认输出 JSON，除非用户明确要求其他格式。
- 仅输出一个 JSON 对象
- 禁止输出 markdown 包裹、解释性前后缀
- 默认必须满足
assets/storyboard-director-schema.v1.1.json 的结构约束
- 缺关键输入时显式失败，不输出伪完整 JSON
输出模式（扩展）
除默认 JSON 外，当宿主明确要求“视频片段脚本 / Seedance 时间轴 / 剧本正文格式 / 素材清单”时，可在同一套章节理解基础上派生以下补充产物：
Seedance timeline prompt章节剧本正文资产清单Ending frame continuity note
但这些都属于默认 JSON 的派生产物，不得替代默认 JSON 成为唯一交付，除非宿主或用户明确要求只要这些格式。
强制输出协议
- 必须输出多个镜头，不得只给单段大提示词。
- 顶层必须包含：
schemaVersionchapterglobalStylecastrelationshipGraphmodelingSpecstopMotionSpecatmosphereSpecshots
- 每个镜头必须包含导演与生产关键字段：
shotIddurationSecnarrativeGoalsubjectAnchorscrowdRelationsscenerigAndPosecameralightingactionChaincompositiondramaticBeatperformancecontinuitycontinuityLocksreadabilityChecksfailureRisksnegativeConstraintsprompt
- 章节证据不足时必须显式失败并指出缺什么，不得脑补关键剧情。
镜头数量规则
- 短章节（<=1200字）：
6-8 镜头
- 中章节（1201-2500字）：
8-12 镜头
- 长章节（>2500字）：
12-16 镜头
若用户指定镜头数，以用户要求为准。
Seedance 片段节奏规则
当需要把镜头转换成 15 秒视频片段时，优先遵循：
- 对话 / 情感片段：
3-4 个镜头
- 动作 / 冲突片段：
5-7 个镜头
- 蒙太奇 / 快节奏序列：
6-8 个镜头
默认情绪节拍：
0-3s 建立场景与情绪3-9s 推进动作或冲突9-12s 打到高潮 / 关键揭示12-15s 落版 / 余韵 / 悬念
若当前章节镜头要继续驱动 Seedance 片段，必须保证每个镜头都能被压缩或聚合进这一节奏框架，而不是只给静态图片 prompt。
视觉可执行约束（CV 友好）
每个镜头都必须满足：
- 主体明确：至少给出 1 个稳定身份锚点（年龄段/外观/服饰/独特特征）。
- 群像关系明确：至少写清
谁与谁、关系类型、强度、冲突/合作状态。
- 场景明确：地点 + 时间 + 天气/环境状态至少三要素中的两项。
- 动作明确：使用可见动作动词，避免“情绪化空话”。
- 空间明确：前景/中景/远景或左右前后关系至少一种。
- 相机明确：景别 + 机位 + 运镜 + 焦段，优先补充
shutterAngleDeg。
- 光照明确：主光方向 + 主光角度 + 色温 + 对比关系至少四项。
- 建模明确：材质、表面磨损、尺度、姿态约束不可缺失。
- 定格明确：
fpsBase + on ones/twos/threes + microJitterPx 至少三项。
- 连续性明确：和上一镜头至少 1 个共用锚点（角色、道具、方位、时间推进）。
- 负面约束明确：写出至少 2 条“不要什么”。
参考图策略（连续性）
- 首镜头可在无参考图情况下启动，不做强阻断。
- 非首镜头通常应携带至少 1 张参考图（优先上一帧 / 尾帧），用于角色与场景连续性锁定。
- 若非首镜头缺少参考图：允许继续输出，但必须在
failureRisks 中显式标注 referenceMissing 或等价风险，并在 continuity/continuityLocks 里写明补救策略。
- 禁止把“无参考图”伪装成“连续性已锁定”。
- 若镜头后续要转成 Seedance / 视频片段 prompt，参考图语义必须可映射到图位职责：
- 图1：主体 / 角色一致性
- 图2：场景 / 光线 / 构图延续
- 若存在上一片段尾帧，优先作为视频续写的首帧连续性依据
角色卡前置规划（强制方法论）
- 在生成 chapter-grounded 关键帧、分镜图或镜头提示词前，先检查本章反复出现的主体是否已有可用角色卡锚点。
- 可用角色卡锚点的判定标准是：项目/书籍作用域下已经存在真实角色卡资产，并且能提供可执行图片 URL 与可追溯的
roleName / roleCardId / 年龄或状态证据。
- 对“本章会重复出现、后续多个镜头要复用”的角色，角色卡锚点必须进一步满足：已经存在真实
three_view 资产；只有普通角色图、没有三视图资产，不算满足重复主体锚点条件。
- 若主体尚无角色卡、或当前镜头明确要求特定年龄/状态但现有角色卡无法覆盖，先创建角色卡节点，再继续创建镜头节点；不要跳过这一步直接写“假定已锁定”的镜头 prompt。
- 角色卡节点应优先落成独立
image 节点，并带上明确的 roleName、roleId、roleCardId、sourceBookId、materialChapter、stateDescription、referenceView=three_view 与参考依据，确保后续镜头可以复用。
- 后续镜头 prompt 可以直接使用
@角色名 或 @角色名-状态 语法，例如 @方源-少年 从床上醒来；当对应角色卡存在时，运行时会把它解析成真实参考图与角色卡绑定，而不是只把它当普通文本。
- 若同名角色存在多张角色卡，必须在镜头约束里给出可区分的年龄/状态/时期证据；若仍无法唯一锁定，应显式失败并指出需要先补哪一张角色卡。
- 这一步属于 agents 的证据规划与产物编排职责，不应假设后端或前端会替你自动决定“先做角色卡还是先出镜头”。
场景/道具前置规划（强制方法论）
- 在生成 chapter-grounded 分镜前，若章节元数据已暴露稳定场景或关键道具（例如固定房间、课堂、木盒、法器、载具、机关），必须先检查这些锚点是否已有可执行参考图。
- 对会跨镜头复用的场景/道具，普通文本描述不算完成；必须存在真实视觉参考资产，并能回写到书籍
visualRefs。
- 若场景/道具锚点缺失，先创建对应独立
image 节点，再继续创建镜头节点；不要在镜头 prompt 里假装“场景已锁定”。
- 这类参考节点应显式携带
sourceBookId、materialChapter、visualRefId、visualRefName、visualRefCategory；当是 scene_prop 锚点时，同时写 scenePropRefId / scenePropRefName，避免后续节点只能看到不可读的 taskId。
节点语义绑定（强制）
- 任何新建的图片/分镜节点，只要绑定了角色或可复用场景/道具，都必须把语义字段直接写进节点数据；禁止依赖 taskId、临时 label 或运行时猜测回填。
- 角色节点最少要带：
roleName，必要时补 roleId / roleCardId / referenceView。
- 场景/道具节点最少要带：
visualRefName，必要时补 visualRefId / visualRefCategory / scenePropRefName。
- 若当前证据不足以唯一确定绑定对象，应显式失败并指出缺哪张三视图角色卡或哪张场景/道具参考图，不要写入模糊绑定。
剧本正文表达约束（当宿主要求脚本体时）
若宿主需要“剧本正文 / Seedance 分镜脚本”而不只是结构化 JSON，采用下列表达规范：
- 每个镜头行以
△ 开头。
- 对白标记使用：
角色名（os）：内心独白 / 画外音角色名（vo）：人物不在画面中的画外音角色名（怒/惊/喜）：带情绪对白
- 特殊结构使用：
【空镜】【闪回】 / 【闪回结束】【字幕：xxx】
- 镜头语言必须具体，不接受空泛“氛围镜头”：
- 景别：远景 / 全景 / 中景 / 近景 / 特写 / 大特写
- 运镜：推 / 拉 / 摇 / 移 / 跟 / 环绕 / 升降 / 手持 / 希区柯克变焦 / 一镜到底
- 连续动作链优先使用
A -> B -> C 或 A → B → C 表达。
该正文格式是默认 JSON 的可读展开视图，不得与 JSON 语义冲突。
资产规划（当宿主要求补齐角色/场景/道具时）
若本轮目标包含“先补齐资产再继续镜头”，可采用以下稳定编号习惯：
- 角色：
C01-C99
- 场景：
S01-S99
- 道具：
P01-P99
每个资产至少明确：
- 名称
- 类别
- 视觉锚点
- 与章节的关系
- 后续要给哪类镜头 / 视频片段复用
资产规划是为了服务执行，不是产出一份脱离 TapCanvas 的独立素材文档。
Seedance 时间轴派生规则
若宿主明确要求 Seedance prompt，从结构化镜头派生时应生成：
- 风格与总体氛围一句话
0-3s / 3-6s / 6-9s / 9-12s / 12-15s 的时间轴描述【声音】：配乐 / 环境音 / 对白【参考】：图1 / 图2 或 @资产名 的职责说明Ending Frame：记录最后一帧的主体、构图、光线、背景与情绪，用于下一片段连续性
禁止直接把章节摘要粗暴压成 15 秒时间轴。必须先有结构化 shot 级理解，再做时间轴派生。
Seedance 任务模板矩阵
除章节分镜主链外，本 skill 还必须覆盖原 Seedance 模板矩阵。若任务明显属于以下类型，应优先按对应模板派生，而不是套一个抽象通用模版：
- 叙事故事类
- 产品展示类
- 角色动作类
- 风景旅拍类
- 视频延长 / 续拍
- 视频编辑 / 剧情颠覆
- 情感冲突类
- 产品动效展示类
- 空间漫游类
- 角色对战类
- 口播类
- 音乐卡点类
- 战争场景类
- 长镜头追踪类
- 伪纪录片类
这些模板的完整写法、时间轴组织、@素材 引用方式与特殊注意事项，统一见 references/seedance-manual.md。
Seedance 提示词优化公式
当产出单条 Seedance prompt 时，默认使用以下八层公式校验：
主体 + 动作 + 场景 + 光影 + 镜头语言 + 风格 + 画质 + 约束
每一层都不能缺失，尤其是：
- 动作要可见、可执行，优先使用“缓慢 / 连贯 / 自然 / 稳定”等抗崩词
- 镜头要具体到景别、机位、运镜
- 光影要明确方向、色温或氛围
- 画质要给保底要求，如
4K、细节清晰、无模糊、无闪烁
- 约束要显式写出结构稳定、比例正常、面部不变形、动作不僵硬等防崩条件
避免使用“漂亮、帅气、很酷”这类主观空词；它们不构成可执行约束。
故事转剧本结构化步骤
当用户给的是故事、小说、短篇、真实事件，而不是现成分镜时，先按以下顺序拆解，再产出 JSON 或正文：
- 提炼核心梗（2-4 字）
- 补齐故事梗概六要素：
- 写一句话卖点
- 为主要角色建立人物小传
- 选择三幕式 / 四幕式骨架
- 规划每个 15 秒片段的镜头数、情绪弧线与尾帧衔接
- 再派生出：
storyboard-director/v1.1 JSON△ 正文剧本Seedance timeline prompt
这一整套步骤的细版模板与检查清单见 references/故事转视频脚本-转换工具.md。
质量检查补充
除本文件的导演 schema 自检外，若宿主要求正文剧本或 Seedance prompt，还必须额外确认：
- 是否有明确的情绪弧线
- 是否包含足够的感官细节（视觉 + 听觉，必要时触觉）
- 是否控制在 15 秒可执行范围内
- 尾帧描述是否足够详细，能直接给下一片段做首帧衔接
- 是否补了音乐 / 音效 / 对话三层声音设计
- 是否使用了清晰的
@素材 语法并标明各素材职责
若输出是专门给 Seedance 的单条 prompt，还需再核对一次 references/优化分镜.md 中的公式与防崩词是否覆盖完整。
禁止项
- 禁止整段堆叠抽象词（如“史诗感、高级感、宿命感”）而无具体可视化细节。
- 禁止同镜头里塞入过多冲突场景/时空跳变。
- 禁止只写文学化描述，不写镜头参数。
- 禁止省略
负面约束。
- 禁止跳过
relationshipGraph 或 crowdRelations。
- 禁止省略光照方向与角度描述。
- 禁止省略
rigAndPose 或 stopMotionSpec。
- 禁止只写“氛围很好”而不写可观察代理（风、颗粒、湿度、可视化声源）。
JSON 模板（必须遵守）
{
"schemaVersion": "storyboard-director/v1.1",
"chapter": {
"bookTitle": "string",
"chapterTitle": "string",
"sourceSpan": "string"
},
"globalStyle": {
"genre": "string",
"visualTone": "string",
"palette": "string",
"aspectRatio": "16:9",
"fps": 24
},
"modelingSpec": {
"unitScale": "1m",
"topologyDetail": "mid-high",
"materialStyle":
生成前自检
输出前逐条检查：
- 是否为“多镜头 JSON”而非“单段大提示词”
- 是否每个镜头字段完整
- 是否每个镜头都可独立执行
- 是否存在跨镜头主体漂移风险
- 是否包含明确负面约束
- 是否包含群像关系与光照角度
- 是否包含建模/姿态/定格节奏字段
- 是否包含氛围代理（风/颗粒/可视化声源）
- 若镜头 prompt 使用了
@角色名 / @角色名-状态，是否已有对应角色卡或已先补角色卡节点
- 若当前章需要新的年龄/状态形态，是否先完成角色卡再继续分镜
- 若宿主要求 Seedance 时间轴，是否已经把结构化镜头压成可执行的
0-15s 节奏，而不是只复制镜头标题
- 若宿主要求剧本正文，是否使用了
△ / os / vo / 闪回 / 字幕 的规范表达，且与 JSON 事实一致
任一项不满足，先修正再输出。
