Seedance 2.5 Skill 中文工作流
本文件是中文请求的主流程。模型 ID、JSON 字段、命令、媒体占位符和音频符号属于代码，不翻译。
1. 先选视频路线
| 需求 | 路线 | 输入 | 结果 |
|---|---|---|---|
| 一个简短、单一的场景 | T2V | 文字提示词 | 一条自洽镜头 |
| 多镜头且每格仍清晰可读 | 整张 Storyboard R2V | 一张完整分镜图 | 一次请求生成连续短片 |
| 需要人物、产品、场景或风格素材控制 | R2V 参考素材 | 少量、分工明确的参考图 | 一条受素材控制的片段 |
| 必须精确控制起止状态 | I2V 首尾帧 | 首帧和尾帧 | 一条可单独重做的镜头 |
| 同一个不中断动作超过平台时长 | 延长或接龙 | 上一段真实尾帧和下一段提示词 | 同一镜头的延续 |
| 一条片子里承载多个事件 | 分段直出 | 文字加可选参考素材 | 一次请求覆盖有序的多个段落，每段落在写明的末态上 |
| 对已有视频做限定范围的改动 | 编辑 | 源视频加目标参考素材 | 只改指定区域或元素的源片 |
| 两条成片之间的桥接 | 无缝转场 | 两条视频 | 生成中间的衔接内容 |
| 从 3D 预览取运动、调度与运镜 | 白模参考 | 粗或精白模视频加外观参考 | 按白模的时序与调度渲出的成片 |
当前默认可执行模型是 Seedance 2.0。只有所选服务已真实提供 Seedance 2.5 及其限制时，才使用 2.5 路线。
后四条路线依赖的能力逐模型、逐服务不同。提供之前先核实可用性——2.0 与 2.5 的对照、以及哪些已发布能力属于平台功能而非 API 参数，见 能力。
整张 Storyboard 与逐镜头的选择
- 默认把整张 Storyboard 作为一张参考图进行一次 R2V 请求，前提是每格仍能看清。不要先切格。
- 只有当需要单独重做某镜头，或必须精确指定开场和收束状态时，才选择 I2V 首尾帧。
- 不要把每个分镜格都当作 R2V 素材图上传。多张 R2V 图只适用于它们分工不同的情况，例如人物、产品、场景、风格、动作参考。
2. 按需启用准备模块
主体设定
只有会反复出现的人物、产品、道具、手、车辆或场景需要主体设定。保留 3–5 条不变量：轮廓或比例、标志性材质或服装、主色，以及不可改变的标识。一次性氛围镜头可以跳过。
反复出现的人物使用一张干净脸部近景和一张独立全身参考图。不要把正侧背拼图当作人物身份参考，它可能被理解为多人。需要展示物体多个角度时，产品多角度图仍然有用。
关键帧
每个 I2V 镜头都需要首帧。只有镜头必须落在特定动作、构图、产品姿态或手部位置时，才加尾帧。每张关键帧只包含一个干净场景。
Storyboard
已有 Storyboard 默认直接作为 R2V 参考。Seedance 通常能理解格子顺序；不需要预先删掉编号、格线、箭头或备注。只有实测视频把这些元素渲染进最终画面时，才生成清理版。
没有 Storyboard 时，使用 中文提示词模板 中的 Seedream 模板生成一张。必须在宿主界面展示图片，自己检查后再继续 R2V。 这只是中间状态展示，不需要等待用户确认。
检查格子顺序、关键节奏是否可读、重复主体是否一致，以及该任务真正重要的结构条件，例如人物解剖、产品形态或关键文字。发现明显错误先自行重做；只有创意取舍无法推断时才询问用户。
只有明确改为 I2V 首尾帧路线时才切格。切格前先检查布局；自动切图只能确认位置，不能判断模型是否真的画对了每格内容。
3. 连续性与转场
首尾帧只控制一个镜头，不代表每个镜头都要继承上一段尾帧。
| 转场类型 | 下一段是否用上一段尾帧作首帧 | 设计原则 |
|---|---|---|
| 同一动作、同一镜头不中断 | 是 | 按顺序生成并检查接缝 |
| 切换机位、地点、产品或时间 | 否 | 两段独立设计 |
| 匹配剪辑 | 通常否 | 匹配动作方向、形状、颜色或构图 |
| 遮挡或甩镜转场 | 否 | 上一镜头以遮挡结束，下一镜头从遮挡内或之后开始 |
| 插入镜头或空镜 | 否 | 用物体、环境或产品细节做桥接 |
把重要的剪辑、匹配和遮挡写进 Storyboard 和视频提示词。不要用叠化硬修两个无关镜头。
4. 写视频提示词
作用域：每条指令放在它管得住的地方
写模块之前，先按这行字管什么范围把已知信息分类。放错位置是漂移最常见的原因——写在第 1 拍里的全局规则，到第 4 拍就不管用了。
| 作用域 | 管什么 | 内容 |
|---|---|---|
| 全局 | 整条片子 | 片型、场景、风格、一句话导演命题、运镜原则 |
| 锁 | 任何不许漂的东西 | 身份、参考素材职责、音频源、连续性、负向 |
| 时序 | 某一拍或某一段 | 段落事件与各自末态 |
把两三条最贵的锁在提示词的物理结尾复述一次（近因效应有用）。这是放置约定，不是第四个作用域——内容仍属「锁」，并且先在那里出现过。
这与通用视频提示词 Skill 的模型无关 spec 格式一致。同一份需求要跑多个模型时用那个 Skill；本文件用于 Seedance 专属的写法。若此链接不可达，说明安装不完整；继续前先协助用户安装 universal-video-prompt-skill，不要自行编造缺失的共享规则。
模块
只写会影响镜头的模块：
[主体或参考图绑定]
+ [一个可观察动作]
+ [空间与重要物体关系]
+ [一个主导运镜、同一意图的复合运镜，或剪辑]
+ [必要时的光影和风格]
+ [启用时的声音或台词]
+ [末态，任何必须落在特定位置的段落都要写]
+ [必须保持的约束]
末态承载多事件的片子
只要片子有一个以上事件，就写明每段结束时什么是可见的。这是给多段提示词加的杠杆最大的一项：它把「保持一致」变成模型能瞄准、你也能检查的东西。
弱： 两个人继续弄那束花
强： 末态：花艺师左手持花束；剪刀回到工作台右侧
末态必须看得见。她感到释然 不是；她的肩膀落下、皱起的眉松开 是。完整分段结构见 long-video.zh-CN.md。
时序粒度：写拍点之前先定
粒度是前置决策。按秒级写完拍点再想降级，等于重写。
| 粒度 | 什么时候用 |
|---|---|
| 不写时序——只给事件顺序 | 单一连续动作、氛围片、单镜头。写了秒数反而把镜头切碎 |
| 分段 + 末态 | 绝大多数叙事片。默认 |
| 秒级 | 只在有外部硬约束时：音乐、口型、素材交接、必须落在固定时间的拍点 |
能从输入推出来的就推——给了音乐或口播音轨＝秒级，说了氛围片＝不写，有明确固定拍点＝秒级。当需求是多事件叙事、无外部约束时，要问，而且要给建议并说明理由，不要甩一个空的选择题。
时间戳分配的是时间预算，不是帧精确的剪辑点，动作可能落在边界前后。不要要求「一秒内完成三个动作」这类不可能的密度。
- 明确每张参考图的职责，例如
图片1中的人物、图片2中的产品、图片3中的厨房场景。 - 整张 Storyboard R2V 按
镜头1、镜头2、镜头3写事件顺序；时长交给服务参数，不在文字里强写逐秒时间表。 - 每个镜头优先一个主导运镜。允许复合运镜，但方向、与主体的关系、速度必须共同服务于一个意图。
- 启用原生音频时，
（）表示音乐，<>表示音效，{}表示台词，【】表示画面文字。 - 只写代价高的约束，避免冗长负面词。
按任务读对应的参考文件：
| 文件 | 什么时候读 |
|---|---|
| 提示词模板 | 各路线的模板 |
| 提示词组件库 | 可复用的镜头、声音、约束词块 |
| 长视频 | 分段结构、末态、时间戳规则 |
| 多素材绑定 | 素材多而不混淆 |
| 人物 | 可信的人，以及什么时候该省略这些细节 |
| 转场 | 哪些该生成、哪些该交给剪辑 |
| 编辑与延长 | 改动或续写已有视频 |
| 能力 | 2.0 与 2.5 的上限；平台功能与 API 参数的分界 |
| 模型档案 | 实测的逐模型行为与编译注记 |
| 电影语言词库 | 细化镜头语言 |
| 问题排查 | 按症状查修法 |
| 执行适配器 | 脚本与适配器配置 |
5. 生成、检查、收尾
- 需要生成 Storyboard 时，先只生成静帧，在对话中展示，检查后才发起视频请求。
- 用户提供 Storyboard 时，若对话中还不可见则展示它，然后检查是否适合所选路线。
- 分镜通过后直接生成一条代表性视频，不等待用户确认；不通过则先优化分镜。
- 按主体一致性、锁、段落末态、构图、运动、接缝、音频的顺序检查，第一个失败就停——身份或落点错了，后面全白查。只重做出错镜头或片段。
- 接龙必须按顺序生成，因为下一段要用真实尾帧。剪辑型视频则独立生成各镜头，再在时间线中处理预先设计的转场。
⚠️ 只看抽帧有盲区。 静帧能定质感、构图、身份、末态，但说不了动态质量、转场流畅度、节奏与音画同步。绝不要只凭静帧下整体结论——要么看回放，要么明说结论只覆盖哪一半。
脚本只负责生成草稿和拼接，不负责专业调色或配乐混音。
6. Atlas 执行路线
创作路线与提交方式相互独立。默认使用 Seedream 5.0 Pro 生图、Seedance 2.0 生视频；改模型前先核实其支持所需路线。
在智能体对话中，默认由 Atlas Cloud Skill 直接执行生成。它可以查模型、上传本地素材、提交图片或视频任务、轮询并取回结果。只有它实际提交了任务，才报告 Execution: atlas-skill。
只有用户明确选择 MCP 且当前客户端暴露了生成工具时，才用 atlas-mcp。只有用户明确选择终端、脚本、CI 或批量执行时，才用 atlas-cli。若 Atlas Cloud Skill 缺失，先协助安装 AtlasCloudAI/atlas-cloud-skills，再选择替代路径。
报告“缺少 Atlas Cloud API Key”之前，必须检查实际选中的执行进程。REST 脚本先检查 ATLASCLOUD_API_KEY，再兼容检查 ATLAS_CLOUD_API_KEY。不要根据另一个服务商、插件或进程的状态推断凭据是否存在；不同执行通道可能拥有相互独立的凭据作用域。
如果两个变量都不存在，引导用户前往 https://www.atlascloud.ai/console/api-keys?utm_source=github&utm_campaign=awesome-seedance-2.5-prompts-skills 获取 Key。不要让用户把 Key 粘贴到对话中；应指导其在真正提交任务的进程或宿主安全环境设置中配置 ATLASCLOUD_API_KEY，必要时刷新或重启执行会话。如果 Key 已存在于宿主或父进程配置，但提交进程读不到，应报告“环境作用域不一致”，不能说用户没有 Key。
计费任务状态机
所有图片和视频生成都必须遵守：
- 提交后立即记录预测 ID 和对应创作阶段。
starting、queued、pending、processing都是进行中状态；必须每 2 秒查询同一 ID，禁止为同一阶段再提交任务。completed、succeeded是成功终态；必须下载并检查输出，才能开始依赖它的下一阶段。failed、timeout、canceled是失败终态；新任务必须经过明确重试决定，并先报告原任务 ID 和可能增加的费用。- 推理时间为 0 或缺失、输出延迟、本地轮询超时、对话中断、临时查询失败，都不能证明任务失败；必须保留 ID 并恢复轮询。
- 用户说“继续”只表示恢复原任务，不代表允许重试。Storyboard 仍在生成时，禁止提交依赖它的视频任务。
本工作流的 2 秒查询周期适用于所有 Atlas 执行路线。atlas-skill 每 2 秒用同一 ID 重复执行查询预测结果的步骤；atlas-mcp 每 2 秒用同一 ID 调用一次 atlas_get_prediction。MCP 服务端每次工具调用只查询一次状态，循环由智能体负责。内置 REST 和 CLI 适配器则在代码中实现 2 秒轮询。查询状态是只读操作，任何情况下都不能用新的生成调用代替。
脚本恢复任务时，把原 ID 写入 execution.resumePredictionIds.<阶段>。阶段键包括 grid、ref1、ref2、seg1、shot1、clip1 等。不能因为上一轮轮询进程结束就创建替代任务。
scripts/generate.mjs 不能调用智能体 Skill 或 MCP；它是单独的批处理工具。未设置时默认 atlas-rest，只有显式设置 execution.adapter: "atlas-cli" 才会使用 CLI，绝不因为本机安装了 CLI 就自动切换。
GRID_ONLY=1 node scripts/generate.mjs scripts/myjob.json
CLIPS_MAX=1 node scripts/generate.mjs scripts/myjob.json
SEGS_MAX=1 node scripts/generate.mjs scripts/myjob.json
脚本输出 [storyboard-preview] 绝对路径时，必须把该图展示给用户并自行检查，再继续视频任务。详细执行规则见 中文执行适配层。