| name | skill-prompt-engineering |
| description | 仅在即将调用图片、视频或音乐生成模型时使用。负责把已定稿的 director_plan、剧本文字和终版参考资产编译成“本次调用”的完整生成要求并做调用前自检；不负责重新规划剧情、补发明资产、调用工具或审查生成结果。 |
Skill · 生成要求编译
执行合同
- 触发：下一步就是一次正式的生图、生视频或音乐生成调用。
- 输入：
director_plan 当前对象/segment、剧本逐字文本、实际存在且已过审的参考素材、真实调用设置。
- 输出：一次调用的一份完整生成要求 + 参考绑定表 + 明确自检结论。
- 边界：不改剧本，不改 plan，不发明缺失资产，不写工具名/字段/路径/轮询，不替审查放行。
- 失败回流：缺 plan 回编导；缺参考回素材；生成结果有问题按审查标签回根因层；禁止原样重抽。
每次调用只做这 6 步
- 锁定单次目标：明确本次生成什么对象、对应哪个 segment/beat、目标时长/画幅/声音设置。
- 读取权威来源：以
director_plan 为主，剧本逐字文本为补充；冲突时停止，先回上游校准。
- 列参考绑定表：每张图/视频分别锁身份、空间、材质、状态、特写、色彩、剧情流动或运动路线；没有实际输入就不能声称“已参考”。
- 编译正文：中文写清镜头、主体、材质、空间、空气、光、颜色；视频再写 3-6 段时间轴与声音变化。
- 核对真实设置：正文与实际时长、画幅、音频开关、参考输入不冲突。
- 先判再调用：输出
pe_self_check / model_call_preflight: PASS | BLOCKED；至少覆盖 time_axis_motion、expression_and_secondary_motion、prompt_specificity、blocking_findings。BLOCKED 时指出回哪个上游补什么，不得先调用再补理由。
一次生成要求的最低合同
- 参考绑定表：每个实际输入写成
参考 A = <对象/文件语义>；只锁 <职责>；不继承 <禁止维度>。故事板只锁剧情流动；blocking / route map 只锁站位或路线；色卡只锁颜色；参考视频只锁声明的连续性、运动、节奏、特效或音色。
- 正文七层：镜头、主体、材质、空间、空气、光、色彩均须具体；plan 已给出的数字和调色板逐字保留。
- 视频增量：必须写 3-6 段时间轴、段初/段末状态、道具持有链、物理与本能预动作、逐字声音/文字及其出现时机。
Seedance 特殊符号
写视频生成正文时保留这组语法，符号内只放对应内容：
（音乐描述）：音乐 / BGM。<具体音效>：音效 / 环境声。{逐字台词}：台词 / 实声对白，并在前文写清说话人和固定音色。【逐字画面文字】：标题标识 / 画面文字 / 屏幕叠字。
不要混用符号，也不要把工具参数写进符号轨。
硬门禁
以下任一项出现，结论必须是 阻塞：
- 只写“电影感、保持一致、参考上图、同上、承接上段”等空引用。
- plan 的 beat、镜头数字、台词、画面文字、段初/段末状态或道具持有链被删改。
- 声称参考某资产，但实际参考输入中没有它，或未说明职责。
- 本段需要的人物、场景、道具、状态变体、关键特写、故事板或路线图尚未生成/过审。
- 故事板被当成镜头数、人物细节、材质、场景结构或视角的权威。
- 链式延展没有真实使用上一段过审终版视频，并在正文开头写“基于参考视频继续往后扩写”；还要说明参考视频最后状态以及人物、服装、道具、光线、机位、运动方向均不重置。
- 视频只有总体动作链，没有分阶段变化。
- 调色板未逐字复述，或当前 prompt 自行改色。
- 真实调用设置与正文冲突，例如写有对白却关闭音频。
- prompt 出现工具名、参数字段、项目路径、任务轮询或 SDK 实现细节。
共用故障标签
优先使用：REF-1、STATE-1、CU-3、COLOR-1、TIME-1、VOICE-1、TXT-1、PHYS-1、USE-1、SPACE-1、ROUTE-1、CONT-1、CHAIN-1、PROP-1、FIX-1。
按需读取详细手册
不要默认读取整本。只按当前调用类型定位：
| 当前问题 | 读取命令 |
|---|
| 上游消费、人物标签、台词、文字、故事板、参考职责 | file_read path="skills/skill_prompt_engineering/references/handbook.md" keyword="一、先消费上游" count=210 |
| 七层画面、时间轴、光影、镜头、空间、材质、情绪 | file_read path="skills/skill_prompt_engineering/references/handbook.md" keyword="二、把方案编译成画面" count=260 |
| Seedance 特殊符号 | file_read path="skills/skill_prompt_engineering/references/handbook.md" keyword="三、Seedance 特殊符号" count=45 |
| prompt 写法和调用前流程红线 | file_read path="skills/skill_prompt_engineering/references/handbook.md" keyword="四、生成要求怎么写" count=75 |
| 工具层边界 | file_read path="skills/skill_prompt_engineering/references/handbook.md" keyword="五、不要写工具层内容" count=25 |
| 完整放行检查 | file_read path="skills/skill_prompt_engineering/references/handbook.md" keyword="六、放行自检清单" count=55 |
调用前回报格式
只报告生成对象、权威来源、实际参考及职责、关键设置，以及第 6 步规定的四项自检证据；阻塞时补充原因和应回到哪个上游补什么。
