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 提示词时，先补齐以下信息：

1. 这条视频讲什么故事，核心冲突或卖点是什么
2. 时长是多少，默认是否为 15 秒
3. 现有参考素材有哪些：图片 / 视频 / 音频
4. 画幅比例：9:16 / 16:9 / 2.35:1
5. 整体风格、色调和氛围
6. 镜头语言：景别、运镜、转场
7. 动作节奏：舒缓 / 急促 / 是否卡音乐拍点
8. 声音设计：配乐、环境音、对白、旁白

若这些信息无法从上下文证据中恢复，必须显式指出缺口，而不是脑补。

输出模式（默认）

默认输出 JSON，除非用户明确要求其他格式。

• 仅输出一个 JSON 对象
• 禁止输出 markdown 包裹、解释性前后缀
• 默认必须满足 assets/storyboard-director-schema.v1.1.json 的结构约束
• 缺关键输入时显式失败，不输出伪完整 JSON

输出模式（扩展）

除默认 JSON 外，当宿主明确要求“视频片段脚本 / Seedance 时间轴 / 剧本正文格式 / 素材清单”时，可在同一套章节理解基础上派生以下补充产物：

• Seedance timeline prompt
• 章节剧本正文
• 资产清单
• Ending frame continuity note

但这些都属于默认 JSON 的派生产物，不得替代默认 JSON 成为唯一交付，除非宿主或用户明确要求只要这些格式。

强制输出协议

1. 必须输出多个镜头，不得只给单段大提示词。
2. 顶层必须包含：
   • schemaVersion
   • chapter
   • globalStyle
   • cast
   • relationshipGraph
   • modelingSpec
   • stopMotionSpec
   • atmosphereSpec
   • shots
3. 每个镜头必须包含导演与生产关键字段：
   • shotId
   • durationSec
   • narrativeGoal
   • subjectAnchors
   • crowdRelations
   • scene
   • rigAndPose
   • camera
   • lighting
   • actionChain
   • composition
   • dramaticBeat
   • performance
   • continuity
   • continuityLocks
   • readabilityChecks
   • failureRisks
   • negativeConstraints
   • prompt
4. 章节证据不足时必须显式失败并指出缺什么，不得脑补关键剧情。

镜头数量规则

• 短章节（<=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. 主体明确：至少给出 1 个稳定身份锚点（年龄段/外观/服饰/独特特征）。
2. 群像关系明确：至少写清 谁与谁、关系类型、强度、冲突/合作状态。
3. 场景明确：地点 + 时间 + 天气/环境状态至少三要素中的两项。
4. 动作明确：使用可见动作动词，避免“情绪化空话”。
5. 空间明确：前景/中景/远景或左右前后关系至少一种。
6. 相机明确：景别 + 机位 + 运镜 + 焦段，优先补充 shutterAngleDeg。
7. 光照明确：主光方向 + 主光角度 + 色温 + 对比关系至少四项。
8. 建模明确：材质、表面磨损、尺度、姿态约束不可缺失。
9. 定格明确：fpsBase + on ones/twos/threes + microJitterPx 至少三项。
10. 连续性明确：和上一镜头至少 1 个共用锚点（角色、道具、方位、时间推进）。
11. 负面约束明确：写出至少 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，采用下列表达规范：

1. 每个镜头行以 △ 开头。
2. 对白标记使用：
   • 角色名（os）：内心独白 / 画外音
   • 角色名（vo）：人物不在画面中的画外音
   • 角色名（怒/惊/喜）：带情绪对白
3. 特殊结构使用：
   • 【空镜】
   • 【闪回】 / 【闪回结束】
   • 【字幕：xxx】
4. 镜头语言必须具体，不接受空泛“氛围镜头”：
   • 景别：远景 / 全景 / 中景 / 近景 / 特写 / 大特写
   • 运镜：推 / 拉 / 摇 / 移 / 跟 / 环绕 / 升降 / 手持 / 希区柯克变焦 / 一镜到底
5. 连续动作链优先使用 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 或正文：

1. 提炼核心梗（2-4 字）
2. 补齐故事梗概六要素：
   • 故事背景
   • 开场冲突
   • 主角画像
   • 主线事件
   • 结局
3. 写一句话卖点
4. 为主要角色建立人物小传
5. 选择三幕式 / 四幕式骨架
6. 规划每个 15 秒片段的镜头数、情绪弧线与尾帧衔接
7. 再派生出：
   • 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"
      }
    }
  ]
}

生成前自检

输出前逐条检查：

1. 是否为“多镜头 JSON”而非“单段大提示词”
2. 是否每个镜头字段完整
3. 是否每个镜头都可独立执行
4. 是否存在跨镜头主体漂移风险
5. 是否包含明确负面约束
6. 是否包含群像关系与光照角度
7. 是否包含建模/姿态/定格节奏字段
8. 是否包含氛围代理（风/颗粒/可视化声源）
9. 若镜头 prompt 使用了 @角色名 / @角色名-状态，是否已有对应角色卡或已先补角色卡节点
10. 若当前章需要新的年龄/状态形态，是否先完成角色卡再继续分镜
11. 若宿主要求 Seedance 时间轴，是否已经把结构化镜头压成可执行的 0-15s 节奏，而不是只复制镜头标题
12. 若宿主要求剧本正文，是否使用了 △ / os / vo / 闪回 / 字幕 的规范表达，且与 JSON 事实一致

任一项不满足，先修正再输出。