tapcanvas-storyboard-expert

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.md references/故事转视频脚本-转换工具.md references/优化分镜.md references/好剧本.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 成为唯一交付，除非宿主或用户明确要求只要这些格式。 强制输出协议 必须输出多个镜头，不得只给单段大提示词。 顶层必须包含： schemaVersion chapter globalStyle cast relationshipGraph modelingSpec stopMotionSpec atmosphereSpec shots 每个镜头必须包含导演与生产关键字段： shotId durationSec narrativeGoal subjectAnchors crowdRelations scene rigAndPose camera lighting actionChain composition dramaticBeat performance continuity continuityLocks readabilityChecks failureRisks negativeConstraints prompt 章节证据不足时必须显式失败并指出缺什么，不得脑补关键剧情。 镜头数量规则 短章节（<=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" : "stylized-pbr" , "textureAging" : "blood-stain + dust" , "clothBehavior" : "stiff-heavy" } , "stopMotionSpec" : { "fpsBase" : 24 , "cadence" : "onTwos" , "microJitterPx" : 0.8 , "holdFrames" : [ 2 , 3 ] , "imperfectionPolicy" : "allow tactile handmade wobble" } , "atmosphereSpec" : { "tensionLevel" : 0.9 , "airDensity" : "dusty-thin" , "humidityCue" : "dry-wind" , "windVector" : "left-to-right" , "particleType" : [ "dust" , "blood-mist" ] , "soundProxySources" : [ "cloth-flap" , "weapon-hum" , "distant-shout" ] } , "cast" : [ { "id" : "char_fangyuan" , "name" : "方源" , "anchorTraits" : [ "苍白肤色" , "眼神幽深" , "黑发" , "残破碧绿袍" ] } ] , "relationshipGraph" : [ { "from" : "char_fangyuan" , "to" : "group_zhengdao" , "relationType" : "hostile" , "intensity" : 0.95 , "state" : "encirclement" } ] , "shots" : [ { "shotId" : "SHOT_01" , "durationSec" : 3.5 , "narrativeGoal" : "string" , "subjectAnchors" : [ "string" ] , "crowdRelations" : [ { "group" : "group_zhengdao" , "relationToSubject" : "hostile" , "blocking" : "ring" , "distance" : "mid" } ] , "scene" : { "location" : "string" , "timeOfDay" : "string" , "weather" : "string" , "environmentDetails" : [ "string" ] } , "rigAndPose" : { "centerOfMass" : "mid-low" , "limbConstraints" : [ "no hyperextension" ] , "forbiddenPoses" : [ "heroic-victory-pose" ] , "keyPoseNotes" : "string" } , "camera" : { "shotSize" : "wide" , "angle" : "high" , "height" : "crane-high" , "lensMm" : 35 , "shutterAngleDeg" : 180 , "movement" : "slow push-in" , "focusTarget" : "char_fangyuan" } , "lighting" : { "keyDirection" : "back-left" , "keyAngleDeg" : 35 , "colorTempK" : 4300 , "contrastRatio" : "high" , "fillStyle" : "minimal" , "rimLight" : "sunset edge" } , "actionChain" : [ "A -> B -> C" ] , "composition" : { "foreground" : "string" , "midground" : "string" , "background" : "string" , "spatialRule" : "triangular balance" } , "dramaticBeat" : { "before" : "string" , "during" : "string" , "after" : "string" } , "performance" : { "emotion" : "string" , "microExpression" : "string" , "bodyLanguage" : "string" } , "continuity" : { "fromPrev" : "string" , "persistentAnchors" : [ "string" ] , "forbiddenDrifts" : [ "string" ] } , "continuityLocks" : { "identityLock" : [ "string" ] , "propLock" : [ "string" ] , "spaceLock" : [ "string" ] , "lightLock" : [ "string" ] } , "readabilityChecks" : { "subjectReadable" : true , "relationshipReadable" : true , "lightingConsistent" : true } , "failureRisks" : [ "identityDrift" , "lightFlip" ] , "negativeConstraints" : [ "string" , "string" ] , "prompt" : { "cn" : "string" , "enOptional" : "string" } } ] } 生成前自检 输出前逐条检查： 是否为“多镜头 JSON”而非“单段大提示词” 是否每个镜头字段完整 是否每个镜头都可独立执行 是否存在跨镜头主体漂移风险 是否包含明确负面约束 是否包含群像关系与光照角度 是否包含建模/姿态/定格节奏字段 是否包含氛围代理（风/颗粒/可视化声源） 若镜头 prompt 使用了 @角色名 / @角色名-状态 ，是否已有对应角色卡或已先补角色卡节点 若当前章需要新的年龄/状态形态，是否先完成角色卡再继续分镜 若宿主要求 Seedance 时间轴，是否已经把结构化镜头压成可执行的 0-15s 节奏，而不是只复制镜头标题 若宿主要求剧本正文，是否使用了 △ / os / vo / 闪回 / 字幕 的规范表达，且与 JSON 事实一致 任一项不满足，先修正再输出。