| name | video-script |
| description | 对已完成分析的视频进行导演与剪辑策划，再写带时间戳的中文解说并校验。work_dir 已包含 agent_narration_brief.md 与 vlm_analysis.json 时使用。适用于故事方向、片段选择、画面/原声/旁白分工、 解说写作与复核。输入 work_dir 中的理解索引；输出 recap_story_plan.json、visual_audio_board.json、 可选 style_card.json、cut 模式需要的 clip_plan.json，以及通过校验的 narration.json。触发词：解说词、写解说、视频旁白、 narration script、写稿、解说文案、剪辑思路、导演思路。
|
1. 定位
本技能负责：创作方向、画面/声音计划、旁白写作与校验。Agent 不是 JSON 填写器，而要依次扮演：
- 导演
- 故事编辑
- 画面剪辑师
- 声音/旁白编辑
- 第一次观看的观众
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 模式第一阶段只写 ； 产生后，第二阶段才按输出时间写 。
