video-script

1. 定位

本技能负责：创作方向、画面/声音计划、旁白写作与校验。Agent 不是 JSON 填写器，而要依次扮演：

1. 导演
2. 故事编辑
3. 画面剪辑师
4. 声音/旁白编辑
5. 第一次观看的观众

Agent 先记录简洁决定，再写时间线产物。validate.py 负责对理解索引做机械校验；full 模式还会把旁白对齐到安静窗口。

下面的 scripts/... 均相对于本技能目录。若执行器从仓库根目录启动，请给脚本路径加上本技能的绝对目录。本技能不从其他技能目录读取参考文件或辅助脚本；外部输入只来自显式路径与 work_dir 产物。

1.1 创作控制模式

先根据用户要求和 work_dir 判断本轮模式；它不是 full|cut|dub 渲染模式：

• CREATE：首次创作。比较至少两个真正可行的故事/剪辑假设后再选择。
• DIRECTED：用户已指定结构、镜头、台词或表达。忠实落实，不为满足“创作流程”虚构替代方案。
• REVISION：用户针对已有版本看片修改。最新反馈是当前事实来源；未点名部分默认冻结。

REVISION 先明确本轮修改项与冻结项，再编辑对应层：表达、口语节奏、字幕反馈更新 style_card.json；镜头、入出点、表演和声音分工更新 visual_audio_board.json；只有观众承诺、POV、主线或 beat 改变时才更新 recap_story_plan.json。被删除的镜头、原声或文案也要从相关计划中删除，不能保留过期锚点。不要把看片修改重新做成一次 CREATE。

2. 读取素材并确认状态

首先阅读：

• work_dir/agent_narration_brief.md：场景、时长、安静窗口与字数预算。
• asr_writing_chunks.json：长对白的写作分块。
• timeline_fusion.json：判断某段是否有对白或静音槽。
• vlm_analysis.json / asr_result.json：核对具体画面与原声证据。
• brief 顶部列出的 contact sheet：不要只依赖场景摘要；反应、走位、静止和台词前后的具体时刻常常更重要。

full 模式使用原片时间。cut 模式第一阶段只写 clip_plan.json；edited_source.mp4 产生后，第二阶段才按输出时间写 narration.json。

写任何创作产物前，直接读取 work_dir 判断当前阶段：

• recap_run_manifest.json：确认 edit_mode、源视频和本轮设置。
• full 模式：没有 narration.json 时进入写稿；存在时先复核再校验。
• cut 第一阶段：尚无 clip_plan_validated.json / edited_source.mp4，只写 clip_plan.json。
• cut 第二阶段：两者都存在，按 clip_plan_validated.json.clips[] 中的 source_start/end 与 output_start/end 核对映射，再写输出时间的旁白。

必须确认旁白没有跨越错误剪辑边界，也没有落进已删除区间。整个判断只依赖 work_dir 产物。

3. 制定创作方案

先阅读 references/creative-editing-playbook.md，再按创作控制模式写或更新工作产物：

1. recap_story_plan.json：导演意图、CREATE 中至少两个剪辑假设、选定的 POV / 主线，以及由“变化”定义的 beats。DIRECTED / REVISION 不强行新增假设。
2. visual_audio_board.json：每拍的画面任务、具体表演/反应、入点/出点、audio_owner、原声锚点与 narration_job。
3. style_card.json（适用时）：用户当前认可的声音、口语节奏、字幕阅读姿态和明确禁忌。收到表达或字幕反馈后更新原文件，而不是只改最终文案。

只记录决定、证据锚点、被放弃的备选方案和简短理由，不写冗长思维过程。

3.1 导演判断

锁定：

• 观众承诺
• POV
• 戏剧问题
• 起始与结束情绪
• 隐瞒与揭示
• 结尾余味

3.2 故事编辑

CREATE 比较两个真正可行的结构后选择一个；DIRECTED / REVISION 沿用用户指定或已确认的结构，除非最新反馈明确改变故事方向。每个 beat 至少改变一项：知识、权力、目标、关系、情绪或风险。若删除后因果、人物和情绪都没有损失，该 beat 通常不应保留。