---
name: prompt-craft
purpose: "把 storyboard / 分析转成 Seedance 能拍好的 prompt —— 复刻保真的命门"
---

# 写好生成 prompt（call-N.txt）

> 在「产出 Production Plan」给每个 Call 写 `prompts/call-N.txt` 时，**必须**照本文结构写。
> 默认视频路径把这段文本**原样**喂给模型，中间**没有任何改写 / 增强兜底**——文本糙 = 成片糙。复刻成败就卡在这。
> **结构来源**：本文五段式结构是 optima-gen 服务端 `SYSTEM_PROMPT_VIDEO` 的 **skill 端镜像**；改其一须同步另一（skill 读不到服务端，无法单一来源）。

## 为什么 prompt 决定成败

默认路径是 image-to-video，模型只吃三样：**首帧图 + 这段 prompt + 时长**。它按 prompt 把首帧「动起来」。所以：

- 首帧定「长什么样」，**prompt 定「怎么动」**。
- prompt 没写清动作 / 运镜 → 模型自由发挥 → 动作呆、方向乱、跟参考对不上。
- **复刻尤其吃这条**：参考视频好看，是因为它的**节奏 + 运镜 + 动作**好看，而这些只活在「动态」里——首帧图带不出来，**必须靠 prompt 文字补回去**。

## 五段式结构（顺序不要乱）

每个 `call-N.txt` 按这个顺序写，每段一到两句。**构图 / 机位 / 运镜 / 光线的专业术语全部查 `cinematic-language.md`**——这几段写得专不专业，直接决定模型拍得像不像导演拍的：

1. **开场构图**：主体是什么、在画面什么位置（三分 / 居中）、**景别 + 机位 + 焦段/景深**（如「ECU 大特写、略仰拍、85mm 长焦浅景深隔离主体」，不是只写「特写」）、前中后景分层。
2. **动作弧（最重要）**：这一镜从头到尾**发生了什么动作**——主体怎么动、状态怎么从 A 变到 B。复刻时照搬参考这一镜的动作。
3. **运镜**：镜头怎么动——固定 / 推 dolly in / 拉 / 摇 / 横移 / 跟 / 手持 / 环绕 arc。挑**一种**和动作匹配的，别堆；**分清 dolly（机身移、透视变）与 zoom（变焦、透视不变）**。
4. **光线与氛围**：写**光向 + 光质 + 色温 + 光比**（「窗户来的柔和侧逆光、暖白、半脸入暗的高光比」），不是只写「暖光、干净」。
5. **结束状态**：这一镜最后定格在什么画面（便于和下一镜衔接 / 链式承接末帧）。

**长度**：80–220 词（中文约 60–150 字），写满信息但不灌水。

## 四条硬禁忌

- **不写时长秒数**（如「持续 3 秒」）——时长由 `--duration` 参数控制，写进 prompt 反而干扰。
- **不写画幅比例**（如「9:16」）——由 `--aspect-ratio` 控制。
- **不写声音 / 音效 / BGM / 台词**——这段只描述画面，音频是另一条链。
- **复刻不要自补创意**——任务是忠于参考的动作和运镜，不是「我觉得这样更好」。要改，等用户明说。

## 从 analysis.md → prompt 的字段映射（复刻用）

| analysis.md 字段 | 写进 prompt 第几段 |
|---|---|
| 主体 / 构图 / 景别 | ① 开场构图 |
| 描述（发生了什么） | ② 动作弧 —— **若 analysis 只写了静态画面，回看素材补出动作** |
| 运镜 | ③ 运镜 |
| 光线 / 色调 | ④ 光线与氛围 |
| 下一镜首帧需要的画面 | ⑤ 结束状态 |

> 复刻链路**最常见的丢分点**：analysis 把每镜写成了「一张静态照片的描述」（主体 + 构图 + 光线），**漏了动作**。video 模型最吃动作。写 prompt 前对照素材确认：每镜的动作弧已经落到第 ② 段。

## 例子：同一镜，差 prompt vs 好 prompt

**参考镜头**：一只手把懒人拖把按进水桶、提起来甩两下、拖把头展开。

❌ **差**（静态、无动作弧、无运镜）：

> 一只手拿着拖把在厨房里，旁边有个水桶，暖色灯光，干净的画面。

→ 模型不知道「要发生什么」，大概率把拖把拍成僵在原地轻微晃动，完全不是参考的「按—提—甩—展开」。

✅ **好**（五段式）：

> 中景，一只手从画面右侧握住平板拖把杆，厨房台面背景虚化。手把拖把头压进左下角的水桶里浸满水，随即利落提起、向右轻甩两下甩掉余水，超细纤维拖把头随甩动展开蓬松。镜头固定，只随拖把头上下轻微跟移。清晨侧光从左侧窗户进来，暖白色调，水珠在光里有细小高光，画面干净有质感。结束时拖把头停在画面中央、纤维完全展开，准备进入下一镜的擦地动作。

→ 动作弧（压→提→甩→展开）、运镜（固定 + 轻跟）、光线、结束状态都齐了，模型能照着拍出和参考一致的节奏。

## 写完自检（4 个勾）

- [ ] 第 ② 段有没有明确的**动作弧**（从 A 变到 B），不是静态描述？
- [ ] 运镜只挑了**一种**且和动作匹配？
- [ ] 没出现秒数 / 比例 / 声音？
- [ ] 复刻镜：动作和运镜**忠于参考**，没自作主张改？
