wddxh 输入
文件读取
story/episodes/$ARGUMENTS[0]/outline.md— 必须读取（剧情骨架/信息传达/集尾钩子）story/episodes/$ARGUMENTS[0]/novel.md— 必须读取（视觉细节、动作、情绪、场景的来源）config.md— 必须读取（语言/风格/每集时长目标/每集分镜数）assets/**/*.md— 必须 Glob 列出所有现有资产文件名（决定复用 vs 新增）story/arc.md— 若存在则读取（跨集视觉/情绪连贯）- 上一集
story/episodes/ep{N-1}/keyframes.json— 续集模式必须读取最后一张关键帧（衔接校验） story/episodes/$ARGUMENTS[0]/keyframes.json— 仅在增量模式存在时读取story/episodes/$ARGUMENTS[0]/.review-keyframes-narrative.md— 仅增量模式必须读取（含本轮 review 意见）skills/director-keyframes/rules.md— 必须读取并严格遵循（schema 字段、composition 规则、数量规则、增量模式工作流）
Bash 调用
bash scripts/read-config.sh "每集分镜数"— 读取本集最大分镜数 N，用于关键帧数量校验
动态参数（$ARGUMENTS）
$ARGUMENTS[0]— 当前集数（如ep01）$ARGUMENTS[1]— 模式（可选，full或incremental，缺省为full）
职责描述
核心使命
把本集小说原文转化为剧情视觉节点序列：枚举本集所有不可省略的画面节点，为每个节点写完整描述，登记本集所有资产引用。不切分 shot、不规划镜头语言——shot 切分与运镜是 storyboarder 的职责。下游消费者是 director-review-keyframes-narrative（叙事评审）、creator-create-assets（出资产卡）、creator-keyframe-images（出关键帧图）、storyboarder-storyboard（消费关键帧并切分 shot）。关键帧不是"挑几张代表画面"，而是剧情节奏的视觉锚点——评审者凭关键帧序列就能判断本集剧情完整性、因果性、节奏张弛；下游图像/视频生成依赖关键帧作为参考图保证一致性。
工作思路
- 通读 outline + novel + arc，建立三层认知——剧情层（开场/发展/转折/高潮/收束）、信息层（本集需要观众接收的信息）、视觉层（每个剧情进展对应的画面想象）
- Glob 现有资产清单，建立"可复用资产 ID 池"——后续写 composition 时优先从池中选资产，无法复用才新增
- 读取 config 中的「每集分镜数」N，作为关键帧数量的硬下限，1.5×N 作为软推荐
- 枚举关键帧——不仅要覆盖 outline 的主要事件，还必须覆盖事件之间的铺垫和演进节点；任何画面状态发生不可省略的变化都应有关键帧（角色出场/换装/位置移动/情绪转变/道具出现或消失/光线变化）
- 每张关键帧写 11 个字段——composition 必须用
<资产名>包裹所有出场角色/场景/道具，便于下游扫描资产引用 - 聚合本集资产清单——遍历所有关键帧的 composition / characters / props / scene 字段，按"新增/已有"分类，沿用现有资产清单格式
- 校验剧情骨架完整——逐条对照 outline 的「主要事件」「本集信息传达」「集尾钩子」；同时检查事件之间是否有铺垫帧串起因果链
- 校验视觉因果链——按集内序号顺序读关键帧的 composition，确认前后两帧之间不存在"无法解释的视觉跳跃"（人物突然换位/道具突然出现/光线突变缺乏理由）
- 续集衔接校验——读取上一集最后一张关键帧的 composition，确认本集第 1 张关键帧合理承接（场景/角色状态）
- 增量模式：读取现有 keyframes.json 与
.review-keyframes-narrative.md（定位最后一个## 第 N 轮heading，用 grep^## 第 [0-9]+ 轮找最大 N 段，用该段内的意见列表作为变更依据），判断哪些 keyframes 需要修改/新增/删除，其他保持原样；变更后受影响的关键帧 id 不能被回收复用——新增帧必须用新 id（避免下游重抽误判）
常见误区
- 只覆盖大事件不写铺垫 — 把 outline 5 个主要事件画 5 张关键帧就交差，事件间没有铺垫帧 — 主要事件之间的过渡（角色到达/掏出道具/眼神交汇）也是关键帧；下游 storyboarder 需要这些铺垫节点才能切出有节奏的 shot
- 关键帧描述写运镜过程 — 关键帧是静态快照，写"主角推门走进房间"❌；写"主角站在门口右手扶门把，左脚已迈进室内"✅；运镜过程是 storyboarder 的事
- 首末帧用进行时态 — "他正要站起来"❌；"他半弯腰，双手撑在桌面"✅
- 画面字段污染剧情解读 — composition 写"<反派>正在密谋复仇"❌（密谋是抽象的）；写"<反派>背对镜头站在落地窗前，右手攥紧酒杯"✅；剧情含义靠音频字段或后续关键帧承载
- 画面字段写不可见元素 — 写"<反派>就在门后偷听"❌（门关着看不到反派）；要么写可见的暗示（"门缝下露出黑色皮鞋的影子"），要么这一帧不出现反派
- 资产凭空发明 — 写 composition 时引用了 assets/ 中不存在的资产名却没登记到资产清单 — 每写一个
<xxx>都要校验现有资产或加入新增清单 - 复用资产换名字 — 现有资产叫"张三"，新关键帧里写成"穿夹克的男人" — 优先从可复用资产池里精确选名
- 视觉跳跃缺铺垫 — 关键帧 N 主角站在天台、关键帧 N+1 主角在车里，中间无任何过渡帧 — 检查相邻关键帧的 composition，画面状态变化必须有视觉因果（要么补铺垫帧，要么变化本身就是剧情核心）
- 关键帧绑定 shot — 写关键帧时已经在想"这是哪个 shot 的首/尾帧" — 关键帧只关心"剧情视觉上有什么"，shot 怎么切由 storyboarder 决定
- 数量不足以支撑分镜 — 关键帧数量少于 config「每集分镜数」N，导致 storyboarder 无法保证每个 shot 至少引用 1 张关键帧 — 必须 ≥ N，推荐贴近 1.5×N
规则参考
skills/director-keyframes/rules.md— 必须读取并严格遵循
输出
文件操作
- 使用 Write 创建/覆盖
story/episodes/$ARGUMENTS[0]/keyframes.json（全量模式） - 使用 Edit 修改
story/episodes/$ARGUMENTS[0]/keyframes.json（增量模式） - 使用 Edit 在
story/episodes/$ARGUMENTS[0]/outline.md末尾追加（或更新）「本集资产清单」章节