ai-videos

# AI 短剧全流程编排（ai_videos__全流程编排） 把一部 AI 短剧从脑洞走到**标准化 AI 分镜 Prompt**，分**六阶段**，每阶段先问你、再生成、再过 QC 关卡。是 `task_type=ai_video` 的唯一入口，取代 agent_team（仅视频侧）。完整设计见同目录 `BLUEPRINT.md`；各阶段细则见 `playbooks/ai_videos__stageN_*.md`；输出规则见 `agent_refs/project/ai_video.md`。 ## 何时用 - 用户要做/开始/继续一部短剧；说"立项/世界观/人设/大纲/剧本/分镜/出 prompt/做短剧"。 - 恢复某个半成品短剧（从文件系统判断进度续跑）。 ## 六阶段（本期 1–6，出 prompt 即止；阶段 7 渲染剪辑暂不做） | # | 阶段 | playbook | 产物落点 | QC 关卡（审查 skill） | |---|---|---|---|---| | 1 | 核心创意立项 | `ai_videos__stage1_立项` | `ai_videos/{name}/1_立项/concept.md` | 人工确认 | | 2 | 世界观+锁定人设 | `ai_videos__stage2_世界观人设` | `2_世界观人设/{world.md, characters/, scenes/, props/, casting.md, style_guide.md}` | `ai_videos__格式契约` | | 3 | 分集大纲 | `ai_videos__stage3_大纲` | `3_大纲/arc_outline.md` | `ai_videos__剧情连贯` + `ai_videos__全剧序列` | | 4 | 文学剧本(台词) | `ai_videos__stage4_剧本` | `4_剧本/episodes/epNN/{script.md, dialogue.md}` | `ai_videos__台词大师` + `ai_videos__白话大师`（白话口语化专项，台词仍书面时再过）+ `ai_videos__剧情连贯`（P7 规格-配重·人物 beat 闭环） | | 5 | 分镜运镜设计 | `ai_videos__stage5_分镜` | `5_6_分镜与prompt/episodes/epNN/{shotlist.md, shots/shotNN/shotNN.md}` | `ai_videos__站位朝向`+`ai_videos__运镜`+`ai_videos__动作表演`+`ai_videos__光线色调`+`ai_videos__时长节奏`（+ 含打斗的 shot 跑 `ai_videos__武打设计`；+ 涉超自然视觉的 shot 跑 `ai_videos__特效设计`） | | 6 | 标准化分镜 Prompt | `ai_videos__stage6_prompt` | 各 `shotNN.md` 五层 prompt + `台词配音` + `all_shot_prompts.md` | `ai_videos__格式契约` + 出片前全 `ai_videos__审查总编排` | > 阶段 5、6 产物**合一在 shotNN.md**（先写运镜设计、再校五层 prompt 契约）。 ## 单片/MV 模式（sub_type=short，2026-07-26） 3–10 分钟精致单片（经典 IP MV / 伪预告片 / 古诗词 MV / 人物一生蒙太奇等）**不走多集流程**，六阶段做如下替换，其余机制（QC 关卡、update 复核、反馈进化、归因三问）不变： - **阶段 1 立项**：额外锁定 单片体裁（MV/伪预告/蒙太奇）、BGM/配乐结构（若 MV：歌曲段落 intro/verse/chorus/bridge 时间轴）、总时长目标（180–600s）。 - **阶段 2 世界观人设**：同多集版（人物灵魂可按单片深度裁剪——只写与本片情绪弧相关的维度，但锁定描述符/voice_id/ref 图契约全量保留）。改编经典 IP 时人设走「神似不形似」：还原服化道/气质/配色，角色面部为原创设计，casting.md 记录致敬来源。 - **阶段 3 大纲 → 结构脚本**：产物改为 `3_大纲/structure.md` —— 按 BGM 段落/情绪 beat 的对位表（段落 | 时间轴 | 情绪 | 画面内容 | 对应原作场景），取代 arc_outline.md。QC 只跑 `ai_videos__剧情连贯`（P 系按段落理解），**跳过 `ai_videos__全剧序列`**（无跨集）。**原创主题曲歌词契约（2026-07-26 follow-up xianjian_yi_mv/002）**：歌词每段落须逐句绑定对位表该段的具体剧情 beat 与专名锚点（场景/物件/事件名），禁止可套在任何剧上的泛情歌句；副歌钩子句结构可复用，但每次变奏的意象须来自对应叙事段画面内容。 - **阶段 4–6 目录扁平**：无 `episodes/epNN/` 层——`4_剧本/{script.md, dialogue.md}`（MV 无台词时 dialogue.md 可省，script.md 按段落写）、`5_6_分镜与prompt/{shotlist.md, shots/shotNN/shotNN.md, all_shot_prompts.md}`。 - **MV 特有约束**：镜头时长跟音乐 beat 对齐（副歌区间密集短切 3–6s、主歌区间抒情 6–12s）；无台词镜不出 `台词:`/`## 台词配音 prompt` 块（格式契约按"纯视觉镜"豁免）；全片渲染样式/色调曲线在 style_guide.md 里按段落锁定。 - **敏捷原则映射**：多集版"逐集滚动" → 单片版"逐段落滚动"（先出 chorus/高潮段跑通闭环，再补 verse）。 ## 外部资料导入工序（2026-07-27 follow-up xianjian_yi_mv/010·默认强制） 导入任何外部资料（用户提供的文档、下载的原著/剧本/设定集、联网考证产物）到 `0_原作资料/` 时，**先留原版底本、再做演进层**，两层并存： 1. **`_raw/` 原版层**（只读·gitignored·`ai_videos/*/0_原作资料/**/_raw/`）：原始文件字节级副本 + 机械转换的纯文本平行档（仅剥格式标签，全文与顺序原样保留，不编辑不重排）。**它是基准线**——演进层与之不符时以 raw 为准。 2. **演进层**（同目录上级）：在原版之上加工的结构化产物（场景级转述、要点归纳、可用度标注等）。每条须可回溯到 raw 的原文位置（章名/场景名可 grep 定位），并在索引 README 写明两层结构与回溯方法。 先产演进层却不留底本＝返工项：用户失去比对与再加工的基准。（用户自有文档留本地底本 ≠ 对外分发，与版权口径不冲突；对外产物仍守「详实转述+少量直引」。） ## 每阶段执行循环（interactive 默认） 1. **读**：该阶段 playbook + 上游产物 + `agent_refs/project/ai_video.md` + 相关审查 skill 准则。**（stage 5/6 分镜/prompt·2026-07-12 铁律：写/改任一 shot prompt 前，额外必 load ① 上一集的 shot prompts〔尤其边界镜站位/末帧/衔接/情绪/动作〕② 下一集剧情/大纲——保跨集 站位/剧情/情绪/动作 连贯；渲染样式/负向仍从 `style_guide` byte-identical、不照抄可能 stale 的邻镜。语速超标默认拆镜、不删台词。）**（2026-07-19 空间核验 must-have：再必 load 本集前后各 ≥2 镜 + 对应剧本段，逐 beat 推演 机位/人物位置朝向轨迹/object 在框态/说话窗几何，落 `空间核验:` 行·守 S1–S5 写法铁律〔说话窗时序/同角色唯一/画外奇观零具名/巨物全高或全无/背景由机位反推〕·见 ai_video.md 空间核验 amendment + 站位朝向 C19 + 格式契约 K33。）** 2. **问**：用 `AskUserQuestion`（多选题）问该阶段 playbook 的「内建提问清单」（重要阶段多问、多角度）；用户可说"这段自动"跳过提问。 3. **做**：用答案 + 锁定的全局默认（见 BLUEPRINT §4）生成该阶段产物，落固定阶段目录。 4. **审**：跑该阶段 QC 关卡（对应审查 skill）；**blocker 清零才进下一步**（严格度=严）。不过则回修。 5. **续**：进下一阶段；状态从文件系统派生（阶段目录里产物在=该阶段 done），支持断点续。 ## 三大机制（贯穿，务必执行） 1. **每步 QC 关卡**：每阶段末强制过审，blocker 清零方可进下一步。 2. **每次 update 复核**：任何对已有产物的改动/重生，默认跑受影响范围的 `ai_videos__审查总编排` + 在 `specs/ai_video/{name}/changelog.md` 记一条（沿用 ai_video.md 2026-06-17 amendment，扩到"每次 update"）。 3. **反馈→进化**：用户每条实战反馈 → surgical 更新对应 playbook / 审查 skill / `agent_refs` + 记一条"教训"（带来源镜号/反馈引用）。落点=审查 skill 准则表 + agent_refs。**流程越用越强**。 4. **反馈归因三问 + 流程提案（2026-07-05 user 定调·每条反馈强制）**：收到用户任何一条实战反馈，除 surgical 修复外，**必须自问并向用户回答三问**——① **为什么这个问题之前没被发现**（归因到具体层：生成时规则缺失 / 规则有但生成时没执行 / 审查 skill 没有该准则 / 审查有准则但没跑 / 机械关没卡）？② **流程上有什么值得改进**（能否把这类问题变成生成时默认 + 审查准则 + 机械校验的一次性修复）？③ **若有改进空间 → 给用户 2–4 个流程改进选项（interactive 用 AskUserQuestion 让用户选择）**，用户选定后当场落地。目标＝**同类问题只犯一次、prompt 一次就过**。归因结论（漏在哪一层）随该条反馈一起记入 changelog。三问不可跳过——"只修不归因"即违反本机制。 ## 敏捷原则（2026-06-18，务必遵守） **大方向先定，每集剧情边拍边改**——不一次性把全剧剧情写完再拍。 - 阶段 1–3 只确立**全剧大方向骨架 + 前几集细纲**；后续各集**留松**，推进到该集时（阶段 4–6）再细化。 - **不绑死**：根据实拍 feedback 随时改剧情 / 设定走向；每次改动走"每次 update 复核 + 反馈→进化"机制。 - 默认**只先做前几集**（用户指定范围），跑通"立项→出 prompt"小闭环，再逐集滚动推进。 ## 锁定的全局默认（节选，全表见 BLUEPRINT §4） 古风仙侠复仇为首要赛道 · 单集 90–120s · 篇幅自适应 · 9:16 多平台(红果/抖音/海外) · **藏锋·无外放** · 人设面部+服化+声口全锁 · 起承转钩四段 · 强口语白话/OS仅关键 · 鎏金极简系统 UI · 三声线解耦后期 mux · 情绪→运镜映射 · 单镜 4–15s 按 beat·动作不过缝缝落静止(衔接契约v2) · Seedance+Kling · 影视写实仙侠 · **负面词块必填** · prompt 零字幕后期加 · 锁定描述符+voice_id+Seedream ref图+turntable · 多角色同框同角色只具名一次。 ## 项目文件夹结构（阶段编号目录，一眼看出属于哪步） ``` ai_videos/{name}/ ├── 1_立项/concept.md ├── 2_世界观人设/{world.md, characters/, scenes/, props/, casting.md, style_guide.md} ├── 3_大纲/arc_outline.md ├── 4_剧本/episodes/epNN/{script.md, dialogue.md} └── 5_6_分镜与prompt/episodes/epNN/{shotlist.md, shots/shotNN/shotNN.md, all_shot_prompts.md} ``` 新项目默认用此结构；已有项目（如 wushen_juexing）保留原结构、可选迁移、不强制。 ## 硬约束 - 本期范围阶段 1–6；阶段 7（渲染+剪辑）暂不做。 - 审计写 `.audit/adhoc_agents/{date}/{task_id}/`（沿用 CLAUDE.md 契约）。 - 不静默跳过 QC；缺失 skill 显式记录。