---
name: ai-short-play-video-creation
version: 1.14.0
description: "AI 短剧创作工作流技能（动态漫/漫剧/写实风等形态通用）。当用户要制作 AI 短剧、漫剧、动态漫、竖屏微短剧、漫画风视频，或有一句话剧情/剧情梗概要快速成片，或提到 Seedance、即梦、Jimeng、Gemini 分镜脚本、Nano Banana 参考图、宫格分镜（4/6/9/25宫格）、@素材引用、素材锚点/参考图一致性、引用核对、多集项目、连续性台账、段缝衔接、转场（剪辑做还是模型做）、视频编辑/延长、配音/旁白/TTS/音色、BGM 卡点、字幕同步、人脸审核限制/人脸不过审、内容审核敏感词、负面约束失效（写了不要还出现）、Liblib 哩布哩布、分镜提示词、时间轴提示词、分镜图、关键帧候选、三层工艺分离、拟物化角色偏置、视频生成提示词、长剧多集改编、微表情/面部表演、打戏/动作段、情绪节拍与开场钩子、多人戏调度/站位轴线、场景首现与重复出场交代、视觉验收、分镜 JSON 校验、九宫格拼图、镜头衔接、参考视频对标（学结构不抄内容）时使用；生成的视频出现人脸漂移换人、角色重复、多余字幕水印、风格漂移、拼接跳帧等故障要排障时也用。产出系统提示词、工程级分镜蓝图、排障速查与操作指引。AI short-drama video creation with Seedance / Jimeng (motion comic, style-agnostic): storyboard agent prompts, grid storyboard JSON, @reference assets, transition & editing, dubbing, continuity ledgers, segment-seam continuity, blocking & axis, scene staging, FACS micro-expression, action previs, emotional beats & hooks, face-check workarounds, negative-prompt workarounds, reference-video benchmarking, troubleshooting, multi-episode adaptation."
license: MIT
---

# AI 短剧创作工作流（Seedance 出片）

把一句话剧本或完整剧本文本变成可执行的 AI 短剧视频（动态漫/漫剧、写实风等形态通用）。A/B 两条主路线按手头材料选，C 为可叠加的规避法：

> **策划层指针**：选题、市场情报、IP 定位、故事架构、节奏地图、剧本创作与多集规划（真人短剧与漫剧共用的红果/抖音投放打法）用 `onlyshot-drama` 技能；本技能负责素材、分镜、出片与排障。串联方式：onlyshot-drama 产出剧本 / 圣经 / 分镜工程文件 → 本技能走制作流程。

| 场景 | 走哪条 |
|---|---|
| 有完整剧本，要工程级分镜（镜号/时长/转场/声音设计） | **路线 A：分镜智能体** |
| 只有剧情一句话/一段梗概，要快出连贯片段 | **路线 B：宫格分镜直生** |
| 人物参考图过不了 Seedance 人脸审核 | **路线 C：人脸规避五法**（可与 A/B 叠加） |
| 整部短剧/小说要做成多集 | **多集工作流**（先分集，逐集走 A/B） |

## 触发示例（26 类话术，命中即可直接开工）

| 用户话术示例 | 落点 |
|---|---|
| 「帮我把这个剧本做成漫剧分镜」 | 路线 A |
| 「只有一段剧情梗概，快速出一条动态漫片段」 | 路线 B |
| 「人物参考图被人脸审核拦了，怎么绕」 | 路线 C |
| 「生成的视频人脸漂了还出现俩主角，怎么修」 | 排障速查 |
| 「视频里冒出了没要过的字幕和水印」 | 排障速查 |
| 「写一条带转场设计的视频提示词，每镜标转场代码」 | 铁律与词库 |
| 「这部短篇小说想做成多集动态漫，从哪开始」 | 多集长剧工作流 |
| 「分镜 JSON 生成好了，帮我检查合不合格」 | `scripts/validate_storyboard.py` |
| 「九张场景图帮我拼成九宫格」 | `scripts/make_grid.py` |
| 「镜头之间怎么衔接才连贯」 | 关键帧接力（铁律） |
| 「人物素材怎么出才不会每镜换脸」 | 素材锚点法（`references/asset-workflow.md`） |
| 「一条视频里想放多个镜头，提示词怎么写」 | 时间轴式写法（铁律） |
| 「每镜先出几张候选图选一张，再出视频，怎么做」 | 分镜图工艺（`references/frame-industrial.md`） |
| 「拟人化建筑/器物当主角，素材总崩怎么防」 | 非人形偏置对策（`references/frame-industrial.md`） |
| 「两个人对话的戏，机位和站位怎么排」 | 多人戏调度（铁律） |
| 「这个场景之前出现过吗，这次还要不要重新交代一遍」 | 场景展示判断（多集工作流） |
| 「多段生成的段间衔接生硬，人物消失又出现」 | 段缝衔接（`references/continuity-log.md`） |
| 「一批分镜生成完了，帮我跑一遍接缝量化、出底账」 | `scripts/qa_batch.py` |
| 「记清楚每段成片是哪版提示词生成的，别混源」 | `scripts/manifest.py` |
| 「接缝检查没问题了，帮我把各段统一裁到 5.00 秒」 | `scripts/trim_clips.py` |
| 「脚本要改一版，批量替换并核对都改到了哪些处」 | `scripts/gen_script.py` |
| 「人物的表情/眼神戏写不好，表情总崩」 | 面部表演工艺（`references/facs-micro-expression.md`） |
| 「这段打戏/动作戏的镜头怎么设计」 | 打戏预演（`references/action-previs.md`） |
| 「这一集情绪不够燃，开场怎么留人」 | 情绪节拍与开场钩子（`references/emotion-beat-curve.md`） |
| 「提示词写了不要出现 X，结果还是出现」 | 排障速查（否定失效） |
| 「照这条爆款视频/链接做一版」（给参考视频） | 对标参考流程 |

## 路线 A：分镜智能体（工程级分镜）

1. 读 `references/agent-prompt.md`，把其中的系统提示词整段粘贴进 AI 对话助手的新对话。
2. 用户粘贴剧本 → 模型输出分镜蓝图（场景总览 + SEQUENCE 分镜执行表 + 序列自检）。
3. 按蓝图里的「素材 @ 引用注册表」，用生图工具逐条生成人物参考图——人物走**锚点法**（先定正面全身锚点，其余视角/表情只参考锚点衍生）；场景走 9 宫格工作流（提示词模板同在该文件，拼图用 `scripts/make_grid.py`）；素材被拦见路线 C。素材工艺详见 `references/asset-workflow.md`。
4. **逐镜先出关键帧**：每镜先出 1–4 张候选分镜图（用 8 段式写法，见 `references/frame-industrial.md`），选优定稿作该镜首帧——构图问题在静态图上解决（成本约视频段 1/15–1/20）；关键镜 4 张、标准镜 1–2 张、过渡镜 1 张。
5. 定稿分镜图与参考素材上传至视频生成平台并选 Seedance 模型 → 分镜图作首帧，「动态视频提示词」粘进视频生成框，`@对应素材` → 逐镜生成。序列内的连续衔接二选一：分镜图首帧起镜，或截取上一镜尾帧作下一镜首帧参考接力（同一序列不混用，见 `references/transition-editing.md`）。按素材形态自动选档（图生视频/首尾帧/多帧一镜/全能参考）见 `references/frame-industrial.md`。

## 路线 B：宫格分镜直生（快）

1. 读 `references/grid-storyboard.md`，用其中的宫格分镜提示词创建自定义智能体（宫格数按片长选：15s 优先 9 宫格、8–10s 短动作 4 宫格、30s 分两段 6 宫格、长剧情分段用 25 宫格——原文默认给 25 宫格版，改一句即可转）。
2. 在自定义智能体内导入角色素材 + 剧情文本 → 得到分镜 JSON（机检：`python scripts/validate_storyboard.py <json文件>`）。
3. 新窗口导入素材 + JSON + 生成提示词 → 得到宫格分镜图（出 1–2 张候选、选优再定稿——宫格图修改成本远低于视频，构图走样就重抽）→ 高清放大 → 去水印。
4. 视频生成平台导入宫格图 + 该文件里的视频提示词直出 15s 片段。

**15s 视频优先用 9 宫格**：25 宫格配 15s 会出现镜头遗漏、画面仓促；9 宫格更连贯。改法在该文件（一句话让 AI 对话助手把 25 宫格 JSON 转 9 宫格）。

## 路线 C：人脸审核规避

Seedance 对真实人脸有人脸检测，人物参考图常被拦。五种规避法（墨镜遮挡三视图 / 网格遮挡 / 无五官三视图 / 服装+头部三视图组合 / 多次风格转绘画洗图），各带生成提示词、视频提示词配套写法和坑点，见 `references/face-workarounds.md`。

## 铁律与核心公式（两条路线通用）

- **@ 引用铁律**：所有镜头提示词必须 `@素材名` 关联参考素材，禁止纯文字描述代替；`@名称` 必须与视频生成平台里上传的素材名完全一致，否则引用失效。
- **引用即锁定**：@引用素材后禁止再用文字重描该主体外貌（脸型/发型/服装）——ref 与文字是权重冲突不是叠加，重描会让 ref 失效、角色变形；外貌在素材阶段定稿，镜头提示词只写动作/景别/运镜/光线。同框多角色时 1 主 ref + 其余文字/剪影，红线见 `references/asset-workflow.md`。
- **三层工艺分离**：素材图=身份证（平光/信息优先）、分镜图=视频首帧（戏剧光/三层景深）、视频段=动作连贯——三层参数不可互套。素材阶段的中性风格词不进分镜图（会压掉戏剧光）；分镜图只写动作、禁止重描外貌。镜头级「先图后视频」工序与自动选档见 `references/frame-industrial.md`。
- **提示词三种写法**：①清单式（默认，单镜头精准控制）：`@角色名 @场景名，[动作/状态]，[景别代码]，[摄像机运动]，[光线]，[色调]，[风格标签]，[质量增强词]`；②时间轴式（多镜一条/宫格直生/长镜头）：`【风格】【时长】【画幅】` + `0-X秒：[镜头]+[画面]+[动作]` 分段 + `【声音】` + `【参考】@图片1 作为首帧`；③分镜图 8 段式（出每镜关键帧时用）：CHARACTER/BACKGROUND/ACTION/SCENE/CAMERA/LIGHT/TEXT/STYLE，写法与完整示例见 `references/frame-industrial.md`。
- **景别代码**：ECU 极端特写 / CU 特写 / MCU 近景 / MS 中景 / LS 全景 / ELS 大远景。画面内运动（人物动作）与摄影机运动分开描述，不混写。
- **黄金节奏**：每 25–30 秒一个 ⚡PEAK 情绪峰值；单序列 ≤6 镜；禁止连续同景别超过 2 镜；首镜 2 秒内出现视觉钩子；每镜必标转场代码 + 一句执行说明。台词时长折算：中文语速约 4–5 字/秒，镜头时长 ≥ 台词字数 ÷ 5，超了就拆镜或精简台词。完整词库（运镜/光线/质量词/24 种转场及情绪选用表）在 `references/agent-prompt.md`。本条管单片段内的镜头节奏；整集/多集的长叙事节奏设计（红果必爆 7 招 / 180 秒时间轴 / 24 集规划）用 `onlyshot-drama` 技能。
- **双框写法**：动态视频提示词 → 平台「视频生成」框；画面提示词 → 「图像生成」框。除 @引用名称与景别代码外用中文。
- **声音符号**：官方语法（ ）音乐、< >音效、{ }台词、【 】字幕——分镜表「声音设计」栏的内容必须按符号并入动态视频提示词末尾，例：（沉重雨声）<刀风呼啸>{台词}。
- **作用域与末态（防漂移）**：提示词按「管什么」分三层写——全局（片种/风格）、锁定（身份/@分工/连续性/负向）、时间（每拍的事件与**可见末态**）；多事件提示词必须为每个阶段写可见末态（「她感到释然」不算，「肩膀松下、皱眉消失」才算），最贵的锁定位在提示词末尾重述一次。详见 `references/prompt-craft.md`。
- **多人戏调度（写分镜前预排）**：同框 2 人以上的戏先排后写——①文字化俯视站位：以固定物件为坐标（谁在门边、桌哪侧、谁挡谁、通道在哪）；②逐拍走位链：谁行动 → 谁看到/听到 → 谁反应 → 谁移动 → 新站位，配角不凭空消失、走位要有时间预算；③视线有目标：看谁、何时转向、何时移开，反应只给在场且知情的人，避免全员同步震惊；④反打检查：左右关系、视线高度、光源方向一致，无意越轴不允许（有意越轴须有中性镜或明确重建方位）。镜头级执行细节与自检项见 `references/agent-prompt.md` 多人场景预排节。
- **关键帧接力与视频延长**：接力——首镜用序列起始帧作首帧参考，此后截取上一镜尾帧作下一镜首帧参考，保证构图与角色状态连续；延长——连续内容也可上传上一段视频写「将@视频1延长Xs」续写新内容。同一序列内两种衔接方式不混用；编辑/延长/转场决策的完整写法见 `references/transition-editing.md`。

## 多集长剧工作流

剧本超过单条片段容量（整部短剧、小说改编）时，先切分再逐集走路线 A/B：

1. **分集**：按剧情节点切成 N 集，每集有独立的钩子与收尾，落成 `第X集/剧本.md`。长剧本分批输入时记录实际已读范围（已读的集/场清单），未读部分标「待补」——不凭梗概或前情假设声称读过全剧；源版本冲突以用户最新明确指令为准，无法判断的冲突列出来问，不静默选边。
2. **项目结构**：项目根放 `素材/`（人物/场景/道具参考图，全剧共用一套，文件名 = 素材 @ 引用名）；每集一个子目录 `第X集/`，固定三件——`剧本.md`（本集文本）、`分镜/`（蓝图、宫格 JSON、宫格分镜图、`尾帧.md`）、`成片/`（逐镜视频与拼接成品）。可用 `python scripts/init_project.py <项目目录> --episodes N` 一键生成结构。
3. **素材全剧共用**：人物/场景参考图与 @引用名全剧一套，只在造型变化时补新参考图；跨集一致性靠同一批素材 + 同名 @引用。开剧先锁定画幅（短剧投放主流 9:16 竖屏）与视觉风格词，全剧贯通不改；角色音色表同样全剧一套一次定（见 `references/audio-voice.md`），连续性靠台账记录（见 `references/continuity-log.md`）。
4. **逐集产出与衔接**：每集独立走路线 A/B 出分镜和逐镜视频，剪辑工具拼接成集；集与集之间用上一集成片尾帧作下一集首镜参考，也可用视频延长续写。每集产出后记一句尾帧画面描述（存 `分镜/尾帧.md`），下集首镜衔接直接引用。
5. **场景展示判断（每集写分镜前先跑）**：按观众看到的全剧剪辑顺序统一场景 ID，维护场景出场记录（首次出现场次 / 已出场次数 / 频率档），再选展示镜头——①全剧首次出现：安排大全景（或移动氛围镜，可合为一镜）交代空间规模、出入口与人物位置，开场钩子可以先出，但首次交代不能一路拖进人物特写；②已出现且全剧低频再现：用动作特写带出辨识细节，不重复完整大全景；③高频复用场景：直接进入人物戏，必要时才补方位。判断要有来源（已读到哪些集/场），本集首次 ≠ 全剧首次，未读部分不计为零，只有片段时注明假设；回忆/插叙按「首次看见」判断。本轮用户明确指定的镜头范围与拍法优先。记录表与字段见 `references/continuity-log.md` 场景出场记录节。

## 对标参考流程（有参考视频时）

用户想「照着这条做一版」时，先对标再进路线 A/B——把参考拆开、明确拿什么不拿什么，避免做出来「又像又不像」或直接照抄。对标产物=一张两栏清单 + 1-2 个差异化方案。

1. **拆维度**（逐项记录，不看整体印象）：结构（开场方式 → 推进顺序 → 收尾方式）、节奏（总时长、平均镜头时长、情绪峰位置、卡点方式）、钩子（前 2 秒抓住人的是什么：悬念/冲突/视觉奇观/利益点）、字幕样式（出现方式、排版位置、关键词强调手法）、素材穿插（特写与 B-roll 的插入时机和密度）。
2. **填两栏清单**：**保留栏**=可学的形式要素（节奏结构、钩子手法、字幕方式）；**更换栏**=必须替换的内容要素（人物、台词、产品、素材、音乐）。红线：**学结构不抄内容**——不逐帧复刻、不承诺还原度、不使用无权素材与音乐、参考文案只作结构参考不直接复用。
3. **出差异化方案**：按保留栏的形式，做 1-2 个与参考有明确差异的内容方案，进路线 A/B 执行。真人出镜一律用本技能的人物参考图 + 路线 C 处理，不直接提取参考视频里的人脸形象（素材授权与人脸拦截是两道独立的坎）。

拆不动参考视频时（拿不到原片、只有截图）：按可见维度（结构、字幕样式、素材穿插）能拆多少拆多少，节奏类维度注明「凭观感估计」，不虚构精确数值。

## 平台硬约束（写蓝图前先核对）

**先锁两件再动笔**：目标模型版本（2.0 / 2.5——两版契约不同：时长上限、参考图规则、首尾帧有无、声音符号，禁混写）与画幅（竖/横，开剧一次定、全剧贯通）。用户未指定时一次问全再动笔，不默认选版、不中途换版。

| 约束 | 口径（2.0 实测为主；2.5 已 CLI 实查，详见 `references/jimeng-seedance-2.5.md`） |
|---|---|
| 参考图 | 2.0：≤9 张/次（人物 + 场景合计，最重要的放前面）；同框 ref ≤2，红线和替代法见 `references/asset-workflow.md`。2.5（CLI 实查 2026-10-10）：图 ≤30 / 视频 ≤10 / 音频 ≤10、素材总量 ≤50；多视图主体参考须拆单角度单图（一图一人，可作身份参考） |
| 参考视频/音频 | ≤3 条/次，总时长各 ≤15 秒（可用于运镜/动作/音乐参考）；2.5 支持仅传音频 |
| 生成时长 | 2.0：4–15 秒档位；2.5：4–30s（步进 1s）；单镜 1–4s 均可容纳 |
| 分辨率 | 2.0：480p–720p；2.5：480p / 720p / 1080p |
| 真实人脸 | 含真实人脸的参考图会被拦截，规避见路线 C |
| 画幅 | 短剧投放主流 9:16 竖屏，横屏备用；开剧一次定，素材/分镜/成片贯通 |
| 提示词长度 | 精确优先不堆砌；单条提示词经验上限约 1300–1500 字符（2.0 编测，超 1600 失败率显著上升）；2.5（CLI 实查）上限 15000 字符，仍建议精确不堆砌；超长时拆分镜头分次生成；长提示词（1400 字量级）单跑防限流，短提示词可并发 |
| 2.0 实测注意 | 时序整体偏晚约 2s（拍点写早或改分段）；15s 内状态变化 ≤4 个（超载会整段跳过）；参考图会覆盖文字描述的构图 |
| 2.5 其他实测 | 支持视频延长 / 片段编辑（按时间戳改局部）/ 秒级时间戳分段 / 白模参考；积分约为 2.0 的 1.85 倍（5s 720P 约 130 分/条，发布期实测量级，以生成时界面为准） |

以上为编写时点的公开口径，随平台版本会变；与实际不符时以实测为准并回改本表。

## 成本与确认纪律

- **先图后视频（两层）**：素材层——参考图定稿后再进分镜；镜头层——每镜先出 1–4 张候选分镜图、选优作该镜首帧，再出该镜视频（图成本约视频段 1/15–1/20）。构图问题永远在图上改。
- **逐集解锁**：多集项目一集一集产出确认，不一次全量生成；先出高曝光镜头样片验证风格，再批量。
- **重生预算**：单集重生段数控制在 ~10% 以内；超了停下检查素材与提示词的系统性问题，别硬刷。
- **批量/付费动作前与用户确认（估算 → 确认 → 记账）**：①估算——批量前按「镜数 × 单条积分」算总量给用户（单条积分参考 `references/jimeng-seedance-2.5.md`，重试余量另计）；②确认——先出 1–2 镜样片给用户看，拿到明确同意再批量提交、整集生成、扩大规模；③记账——生成后按批汇总一行（镜数、成功 / 失败 / 重试条数，口径见 `references/continuity-log.md` 第三节），让实际重生率可查、可对账。
- **交付形态先定、按名交付**：「只要提示词 / 只要分镜 / 只诊断 / 按原结构改写」是输出约束——只交付被点名的成品，不代做下游、不夹带修改未点名的文件。缺失的次要参数用**标注默认**补齐（普通新片无时长按 15s、画幅无指定按 9:16，均注明「补充默认」）；只有真歧义（素材身份、编辑目标、延长方向）才提问，且一次问全。
- **视觉验收纪律（防假验收）**：未实际查看生成的图/视频，不得声称视觉验收通过——文件有效（JSON 过机检、文件存在、能打开、拼接命令 exit 0）不能替代视觉去看；段缝量化与同源核对用 `scripts/qa_batch.py`（量化只做粗筛定位，内容仍以逐镜视觉验收为准）。实际结果逐镜检查：写实形态查身份/肤质/光影/手指，动画形态查造型/头身比/线条/色板/人数；发现问题给具体的重生成提示词，不改口说没问题。剧本侧同理：只声称读过实际读到的部分。
- **交付版本管理（旧版自动归档）**：docx 成品交付（剧本/脚本/方案等一切文档）遵循「当前版在交付根目录、旧版在归档子目录」；每次新版交付后把旧版移入 `<交付路径>/_旧版归档/`（移动非删除、可回滚，不主动删除旧版），纳入交付固定流程——执行 `python scripts/archive_old_docx.py <交付路径> "<当前版文件名.docx>" [更多保留名] [--dry-run]`（`--selftest` 自检）；多版本长交付项目（逐镜脚本、多集剧本等）一律启用。
- **发布包装（成片交付最后一步）**：①封面帧——从成片挑**最佳帧**（画面完整、主体清晰、能代表内容）单独导出作封面图（抽帧命令见 `references/transition-editing.md` 第十节）；平台若只能从视频首帧取封面，剪辑时确保首帧可看（不留黑场或过渡帧入点）。②分享文案——1-3 句，说清这条视频是什么 + 一个具体看点；忌「激动地宣布」类套话，多平台可给变体。

## 排障速查（生成结果不对时先查这里）

本表与全技能提示词均为编写时点的实测经验，平台行为会漂移；与实际不符时先按表调整提示词，反复失效再回改本技能。

| 症状 | 首修 |
|---|---|
| 人脸中途漂移/换脸 | 加一张正脸特写参考图并 @引用，提示词加"角色面容全程与参考图一致"；三视图素材若被读成多人，改用单视角正脸图 + 服装图组合（见 `references/face-workarounds.md` 方法 4） |
| 同一角色出现两个 | 每次提及都带 @角色名；提示词加"无重复人物，每个角色仅出现一次" |
| 冒出没要过的字幕/文字 | 提示词加"画面中不出现任何文字与字幕"；横构图比竖构图更稳 |
| 冒出水印/标志 | 提示词加"不生成任何水印与标志"；成图上的水印用去水印工具处理 |
| 风格漂向真人实拍 | 提示词明确风格标签；更稳的做法是先把参考图转成目标风格再上传 |
| 拼接处跳帧 | 后期剪掉上一段末尾数帧和下一段开头 1 帧再接（帧精确裁剪与拼接命令见 `references/transition-editing.md`「本机落地命令」节；本机已装 ffmpeg） |
| 动作崩坏/肢体错误 | 把复杂动作拆成更简单的单动作镜头重抽；或引用参考视频的动作编排 |
| 生成失败但无明确报错 | 先分三类根因：提示词超字数 / 内容审核 / 网络限流——看完整返回信息再处置，别一律当审核改词 |
| 提示词报参数/节点类错误（如 InvalidNode） | 多为提示词超字数——压到 1400 字符以内重提；改写与压缩要点见 `references/frame-industrial.md` |
| 长提示词批量失败/大面积超时 | 长提示词与并发不可兼得——单跑或并发压到 ≤4 并带退避重试；短提示词（<400 字）可常规并发 |
| 提示词被内容审核拦（非人脸） | 反派词换氛围词（sinister→moody、menacingly→缓动作、dark X→deep X）；面部特写+红晕/暧昧词高频触发，替换样本：blush on cheeks→rose tint、extreme close-up（面部）→medium shot、warm glow→soft ambient light；中文「反派」类词删除 |
| 多角色同框脸盲/换脸 | ref 数量超载（3+ 主角一致性 <50%）：1 个主角 ref + 其余文字描述或剪影；单镜 ref ≤2 |
| 画面文字乱码/叠字 | 必要文字显式声明 `clear legible Chinese characters「XX」, no garbled text`；弹幕只写 1 处出现+滚动描述，写 N 次会画出 N 个；小字/枚举列表易错（只画一部分）——重要文字走后期 |
| 拍点整体偏晚/镜头被跳过 | 时序偏晚约 2s：把拍点写早或改用「阶段+末态」分段；15s 内状态变化超 4 个会整段跳过——缩短每段或拆成多次请求 |
| 写明的运镜被忽略 | 把该运镜改写成这一镜的**主要意图**（而不是并列描述之一），或接受结果重新构图 |
| 写了「不要 X / 不出现 X」，X 照样出现 | 否定失效：被禁词根（光效/表情/空镜这类高关联概念）留在提示词里就会被当画面词渲染——按「否定失效三改法」换词（词根零出现）/ 主体优先句式 / 移除触发器（见 `references/prompt-craft.md`） |
| 多段生成的段间衔接生硬、人物消失又出现 | 段缝连续性：模型每段零记忆，段缝不设计必跳——给每段【接续状态】写具体末帧画面，并按「段缝衔接三方案」选衔接方式（末态双保险 / 换机位硬切 / 空镜过渡，见 `references/continuity-log.md`） |
| 想改已有视频局部/加长 | 编辑与延长有专门写法（唯一母版/范围写两遍/末态衔接），见 `references/transition-editing.md`；「禁止硬切」只在延长续写场景开 |
| 成片声音不对（配音/音乐/音量） | 四轨设计与音色表见 `references/audio-voice.md`；台词清晰度要求高走后期 TTS，氛围音用模型原生 |

## 参考文件与脚本索引

| 文件 | 何时读 |
|---|---|
| `references/agent-prompt.md` | 走路线 A 时；或需要完整转场/词库表、人物与场景九宫格提示词模板时 |
| `references/grid-storyboard.md` | 走路线 B 时；或用户给了剧情梗概要快速出片时 |
| `references/face-workarounds.md` | 人物参考图被人脸审核拦截、或用户主动问怎么绕人脸限制时 |
| `references/asset-workflow.md` | 做人物/场景素材时；保角色一致性时（锚点法 / ref 数量红线 / 候选图选择 / 把关清单 / 文字入图规则 / ref 库规模标准） |
| `references/frame-industrial.md` | 出每镜关键帧时；三层工艺分离 / 8 段式写法 / 非人形主角偏置对策 / 4 模选档 / 长提示词并发限流 |
| `references/prompt-craft.md` | 提示词打不准/漂移时；多素材绑定、作用域与末态法则、时间粒度、否定失效三改法、模型实测档案 |
| `references/transition-editing.md` | 规划转场（剪辑做还是模型做）、缝的类型命名与帧级切点对齐、编辑已有视频、向前/向后延长、集间延长衔接、接龙 |
| `references/continuity-log.md` | 多集项目一致性管理：连续性账 / 段缝衔接 / Take 记录 / 提示词版本账 / 证据分级 |
| `references/audio-voice.md` | 配音/旁白/BGM/音效设计：四轨规划、角色音色表、台词标注公式、Edge TTS 落地、混音检查 |
| `references/jimeng-seedance-2.5.md` | 用即梦 Seedance 2.5 出片前：能力规格、素材上限、积分参考、提示词规则、审核限制、复测判定（CLI 实查档案） |
| `references/facs-micro-expression.md` | 写实形态表情写不准、角色表情反复崩时；微表情四区写法、真假笑、强度三档、常用情绪配方 |
| `references/emotion-beat-curve.md` | 分镜前给剧本做情绪体检、规划开场钩子时；12 节拍曲线、钩子模式库、2 秒结构模板 |
| `references/action-previs.md` | 写打戏/动作段时；强度三档（R1-R3）、15 秒结构、11 环动力链、镜头五要素、防守三态 |
| `scripts/validate_storyboard.py` | 宫格分镜 JSON 产出后机检（数量/词数/字符上限/必含排除词/禁用句式/编号重复/否定词根·并列主体·抽象形态告警）；门日志 `--stats` 汇总「哪道检查最常响」 |
| `scripts/make_grid.py` | 本地拼宫格（4/6/9/25：`--cols 2/3/5`），替代在线拼图工具 |
| `scripts/check_refs.py` | 素材与引用核对：@引用名 vs `素材/` 文件名——断链引用（Error）/ 待补标注（Warning）/ 闲置素材（Warning）；`--bindings` 多素材绑定自检 |
| `scripts/init_project.py` | 多集项目脚手架：一键生成「根 `素材/` + 各集三件目录」结构 |
| `scripts/archive_old_docx.py` | docx 交付版本管理：旧版自动移入 `_旧版归档/`（保留清单 / `--dry-run` 预览 / 占用容错） |
| `scripts/sync_entity.py` | 技能实体同步：备份 → 差异扫描 → 同步 → md5 复核一条链（`--dry-run` 预演 / `--prune` 清多余） |
| `scripts/check_double_root.py` | 技能双根核对与补链（`.zcode`+`.agents` 双根部署）：内容 md5 + 硬链 samefile 逐件核对；只修「内容相同非硬链」（`--fix`），不一致只报告 |
| `scripts/check_seams.py` | 成片接缝质量量化检测：对相邻分镜「上一段尾帧 vs 下一段首帧」计算 SSIM／亮度差／色相差／饱和差／运动持续性五维指标＋综合偏差排序（模式 A：分镜目录两两成缝；模式 B：拼接成片＋切点列表）；阈值经人工判定样本校准，用于定位与复核视觉上「不顺」的缝 |
| `scripts/qa_batch.py` | 一键验收管道：分镜目录 → 接缝量化（复用 check_seams）＋清单同源核对 → 底账 Markdown；混源与超阈一次列清（`--json` 供机读） |
| `scripts/manifest.py` | 分镜生成清单：记录每段视频的提示词版本/参考图/定稿状态；`verify` 核对「相邻两段是否同源」（混源是接缝跳跃的常见结构性来源） |
| `scripts/trim_clips.py` | 分镜统一裁切：按帧级规则裁至整拍时长（默认 5.000 秒）；帧精确（默认）/流复制（`--fast`）双模式，默认干跑、`--apply` 执行 |
| `scripts/gen_script.py` | 脚本/文档版本生成引擎（单引擎＋数据文件）：按数据里的替换清单逐项校验命中数再写新版；`--verify` 回放验收、`--all` 全量回归（替代逐版复制的快照脚本） |
| `scripts/fix_table_pagination.py` | docx 分页修复（排版后处理）：表格行不跨页＋跨页表头重复、加粗标题与标签行防孤行、表头行与首数据行同页、操作顺序类短段防页界切半 |

## 更新记录

- 2026-10-02 初版：三路线落地（A 智能体分镜 / B 宫格直生 / C 人脸规避五法），SKILL.md + 3 个 references。
- 2026-10-02 通用化一轮：正文品牌词与出处字样清零，Seedance 去版本号。
- 2026-10-02 排障与工程层：新增排障速查、平台硬约束、声音符号、首尾帧接力、首镜钩子、validate_storyboard.py、make_grid.py，description 加故障触发词。
- 2026-10-02 结构层：新增多集工作流、行为时效标注与本更新记录。
- 2026-10-02 触发面：新增触发示例 10 条，description 补长剧多集/JSON 校验/拼图/衔接触发词。
- 2026-10-09 v1.1 行业实践更新：素材锚点法与 ref 数量红线（新增 `references/asset-workflow.md`）、台词语速折算、时间轴式提示词、视频延长衔接、内容审核排障与敏感词替换、成本与确认纪律、画幅锁定；机检扩至 4/6/9/25 宫格；修复 `scripts/validate_storyboard.py` CLI 调用路径缺陷（缺 pathlib 导入，selftest 已覆盖该路径）。
- 2026-10-09 v1.2 工程化补齐：`validate_storyboard.py` 中英双语适配（排除词中英任一命中即过、中文提示词跳过英文词数检查）＋字符数上限检查（--max-chars）＋编号重复检测＋GBK 编码回退；新增 `scripts/check_refs.py`（@引用与素材文件名双向核对，把「@名称须与素材名一致」铁律变成机检）与 `scripts/init_project.py`（多集项目脚手架）；多集项目结构澄清（根 `素材/` 全剧共用 + 每集三件）；front-matter 补 version；新增 CHANGELOG.md。
- 2026-10-09 v1.3 三块升级：①提示词工程层（新增 `references/prompt-craft.md`：三作用域法则 / 末态法则 / 时间粒度 / 多素材绑定 / 复查顺序 / 2.0 实测档案与 2.5 探测清单）；②衔接与后期（新增 `references/transition-editing.md`：转场「剪辑做还是模型做」决策 / 禁止硬切的正确作用域 / 受限菜单法 / 编辑四件套 / 向前向后延长 / 接龙）；③连续性台账（新增 `references/continuity-log.md`：连续性账 / Take 记录 / 提示词版本账 / 证据分级，多集项目轻量落地）；④声音模块（新增 `references/audio-voice.md`：声音四轨设计 / 原生音频与后期 TTS 决策 / 角色音色表 / 台词标注公式 / Edge TTS 与 ffmpeg 落地 / 混音检查）；平台表补 2.0 实测注意与 2.5 口径；排障表扩至 16 类。
- 2026-10-09 v1.4 分镜图工艺更新：新增 `references/frame-industrial.md`——三层工艺分离铁律（素材=身份证/分镜图=首帧/视频段=动作，参数互不套用，双污染方向防护）、镜头级先图后视频（每镜 1–4 候选→选优作首帧，候选数分配与成本判据）、分镜图 8 段式写法（第三种提示词格式 + 完整示例）、非人形主角拟物化偏置对策（选材/否定子句/重做判据）、视频 4 模选择矩阵（图生视频/首尾帧/多帧一镜/全能参考）、长提示词并发限流规律、失败三分辨与出图复查顺序；路线 A 流程升级（新增第 4 步逐镜关键帧）；铁律区补「三层工艺分离」、写法扩为三种；排障表增 2 类（超字数报错/长词并发）；asset-workflow 补 ref 库规模标准与非人形指针。
- 2026-10-09 v1.5 落地闭环与画风适配（全量审查后 P1-P3 优化落地）：①`references/transition-editing.md` 新增「本机落地命令」节——抽尾帧/首帧、掐头去尾（快档 -c copy / 准档 trim 帧精确两方案）、无损拼接，全部经 30fps 测试片实测（含中文空格路径）；②`references/agent-prompt.md` 质量词按画风二选一（写实向/动画向分列 + 写实词整组替换说明）；③agent-prompt 补 frame-industrial 与抽帧命令互引；④排障表暧昧词替换具体化（blush on cheeks→rose tint 等样本）；⑤路线 B 补候选图环节（1–2 张选优再放大）；⑥黄金节奏补 onlyshot-drama 长叙事节奏互引；⑦`scripts/make_grid.py` 目录扫描支持递归子目录（selftest 增嵌套用例）；⑧README 增「快速上手」最小示例节。
- 2026-10-09 v1.5.1 定位说明修正（技能名不变）：技能说明从「漫剧制作技能」修正为「AI 短剧创作工作流」——本技能覆盖动态漫/漫剧、写实风等全部短剧形态，并非仅漫剧；路线 A 更名「分镜智能体」（原「漫剧智能体」）；画幅表述「漫剧投放主流」→「短剧投放主流」；description 中英双语同步改写。技能名/目录名/GitHub 仓库名保持 ai-short-play-video-creation 不变。
- 2026-10-10 v1.6.0 即梦 Seedance 2.5 实查收录：新增 `references/jimeng-seedance-2.5.md`（CLI 实查：能力规格 / 素材上限 / 积分参考 / 提示词规则 / 审核限制，含三层来源分级与时效注明）；平台硬约束表 2.5 口径由「发布材料未实测」升级为「CLI 实查」（参考图 ≤30、时长 4–30s、分辨率至 1080p、提示词上限 15000）；`references/prompt-craft.md` 的 2.5 段规格回填、行为四探测标注为待跑；`references/asset-workflow.md` 新增「真人素材作首帧：重构图规范」（首帧四要素 / 重构图工序 / 验收三查）。
- 2026-10-12 v1.7.0 同业技能实践吸收（三块）：①多人戏调度——铁律区新增预排四步（俯视站位/走位链/视线目标/反打检查），`references/agent-prompt.md` 系统提示词新增「多人场景预排」节与自检补项；②场景展示判断——多集工作流新增三分法（首现交代/低频带出/高频直入），`references/continuity-log.md` 新增「场景出场记录」节与记录表；③验收与接收纪律——成本纪律新增「视觉验收纪律」（文件有效不替代视觉验收、按形态逐镜检查、只声称读过实际读到的部分），多集工作流分集补「已读范围」纪律；触发示例扩至 16 类，description 补触发词。
- 2026-10-14 v1.8.0 更新（参考同业技能，第一、二批）：①机检扩充——`scripts/validate_storyboard.py` 新增 C8 否定式高关联约束 / C9 并列主体句式 / C10 抽象过程形态词三条告警检查 + 门日志与 `--stats` 汇总（哪道检查最常响=最该改措辞）；②引用核对升级——`scripts/check_refs.py` 断链区分「显式待补」（行内标注待补→降级为警告）+ `--bindings` 多素材绑定自检；③段缝衔接——`references/continuity-log.md` 新增第五节（三方案：末态双保险/换机位硬切/空镜过渡；接续状态末帧画面纪律），`transition-editing.md` 补集间延长衔接用法；④否定失效三改法——`references/prompt-craft.md` 新增第七节（词根敏感性/换词/主体优先句式/触发器移除/栏目纪律）；⑤前置锁定与交付纪律——平台硬约束补「先锁两件再动笔」、成本纪律补「交付形态先定、按名交付」；⑥复测判定——`references/jimeng-seedance-2.5.md` 行为复测判定节（reproduced/degraded/failed + 样本数）；排障表 2 行（否定失效/段缝衔接）；description 补触发词；README 同步。
- 2026-10-14 v1.9.0 更新（参考同业技能，第三批·新做法模块）：①面部表演工艺——新增 `references/facs-micro-expression.md`（FACS 四区写法、真假笑、强度三档与起-hold-落、常用情绪配方、结果词禁令与投喂翻译纪律）；②情绪节拍与开场钩子——新增 `references/emotion-beat-curve.md`（12 节拍情绪曲线体检表 + 三条判定 + 钩子模式库 + 2 秒结构模板）；③打戏预演——新增 `references/action-previs.md`（R1-R3 强度档 / 15 秒完播结构 / 11 环动力链 / 镜头五要素 / 防守三态 / 物理反馈分级）；④后期工具路线对照（`transition-editing.md`）：ffmpeg 与剪映草稿路线的适用边界与去重提示；description 补触发词（微表情/打戏/情绪节拍/开场钩子）；README 与索引表同步。
- 2026-10-14 v1.9.1 收尾同步与工程优化：①触发示例补 5 类新能力话术（段缝衔接/微表情/打戏/情绪钩子/否定失效，16→21 类）；②description 精简至 1024 字符规范内、front-matter 补 `license: MIT` 字段；③`references/agent-prompt.md` 轻度同步——序列自检补四项（段缝衔接/表演真实/约束有效性/打戏段）、写法说明区补三条新工艺指针；④新增 GitHub Actions CI（五脚本 selftest + 样例项目端到端回归）；⑤新增 `examples/demo-multi-ep/` 样例项目（质量基准与回归夹具，不入实体）；⑥`validate_storyboard.py` 门日志加行数轮转（默认 2000 行上限，防无限增长）。
- 2026-10-14 v1.9.2 收尾补件：①新增 `scripts/sync_entity.py`——技能实体同步一键化（安全检查 → 差异扫描 → 备份 → 同步 → md5 复核；`--dry-run` 预演 / `--prune` 清多余；排除承载与仓库级资产，列表维护在脚本顶部常量），selftest 覆盖全路径（含排除根级文件与备份防重名两处修复）；②脚本索引表补录 `archive_old_docx.py`（v1.7.1 加入时遗漏）与 `sync_entity.py`；③README 补「样例与自动检查」指引（examples 与 CI）；④AGENTS/project-info/CI/CHANGELOG 六脚本口径同步。
- 2026-10-15 v1.9.3 双根维护配套：新增 `scripts/check_double_root.py`（双根核对与补链——内容 + 硬链逐件核对，只修「内容相同非硬链」，默认双根由脚本位置推导；`sync_entity` 双根场景的固定收尾步）；七脚本口径同步（AGENTS/README/CI/project-info/CHANGELOG）。
- 2026-10-15 v1.10.0 更新（参考四个开源项目）：①对标参考流程（OpenMontage 参考驱动 + Hypit 复刻纪律）——五维拆解 →「保留 / 更换」两栏清单 → 差异化方案，红线=学结构不抄内容、不逐帧复刻；②成片机检三查（OpenMontage 渲染后自审轻量化）——ffprobe 参数对账 / blackdetect 黑帧检测 / volumedetect 音频电平，落 `transition-editing.md`，三条命令经本机实测（含黑帧与无音轨对照组）；③发布包装（Brag 海报帧工艺）——最佳帧作封面 + 分享文案忌套话，落成本与确认纪律区；④词锚定迭代原则（Hypit）——改词/多语言保持词序骨架、时间轴按语速折算重新流动，落 `prompt-craft.md` 时间粒度节；⑤预算三步账（OpenMontage 预算治理轻量化）——估算 → 确认 → 记账，强化成本纪律「批量确认」既有条目；⑥代码渲染路线指针（HyperFrames）——落 `transition-editing.md` 第十节；触发示例 21→22 类、description 补触发词（参考视频对标 / reference-video benchmarking）。
- 2026-10-15 v1.11.0 接缝量化检测与排版修复工具：新增 `scripts/check_seams.py`（相邻分镜尾帧/首帧的四维量化分与综合偏差排序，阈值经人工判定样本校准）与 `scripts/fix_table_pagination.py`（docx 分页修复四项，带 selftest）；九脚本口径同步（AGENTS/README/CHANGELOG/CI/project-info）。
- 2026-10-15 v1.12.0 缝的类型与帧级切点对齐：`references/transition-editing.md` 新增同名节——转场命名四类（序幕缝/机位缝/动作缝/落点缝，各带意图与验收点）＋帧级切点对齐三步（拍长网格换算、裁齐整拍时长、切点 N＝N×整拍时长）；节号顺延（九/十/十一→十/十一/十二）与 `SKILL.md` 内引用同步。
- 2026-10-17 v1.13.0 接缝检测运动持续性指标：`scripts/check_seams.py` 新增第五指标「运动持续性」——切点两侧各取「接缝帧与其前 tail 秒帧」的帧间运动量（灰度平均绝对差），比值的 log10 偏差归一化（0＝两侧运动量相近；一侧骤停或骤起时升高）；阈值 0.55 经真实样本校准（正常缝 0.013-0.45 自然分布、极端缝 0.64）；JSON 输出含两侧运动量原始值（me_tail/me_head），`--no-flow` 可关闭退回四维；selftest 扩至 8 项。
- 2026-10-17 v1.14.0 批量生成与验收配套工具（项目实践回流）：新增四件——`scripts/qa_batch.py`（一键验收管道：接缝量化＋清单同源核对＋底账）、`scripts/manifest.py`（生成清单与同源核对）、`scripts/trim_clips.py`（统一裁到整拍时长，帧精确/流复制双模式）、`scripts/gen_script.py`（版本生成引擎：单引擎＋数据文件＋逐字节回放，替代逐版复制快照脚本）；四件均带 selftest（trim_clips/qa_batch 无 ffmpeg 时自动跳过）；十三脚本口径同步（AGENTS/README/CI/project-info）。做法来源：商业短片项目承载层优化（生成器 21 份快照收敛为 16 版数据、回放 16/16；一键 QA 底账与既有手工底账数值逐项一致）。