video-script

1## 1. 定位
2 
3只改宣发标题、封面、花字或回填外部文案时，直接读 `references/promotional-copy.md`，
4按当前短片的观看理由和兑现位置处理指定文字层，不重做下述策划/旁白链。
5普通解说写作不因此增加平台调研或包装任务。
6 
7本技能负责创作方向、画面与声音计划、旁白写作及校验。Agent 依次从以下五个角度作出决定：
8 
91. 导演
102. 故事编辑
113. 画面剪辑师
124. 声音/旁白编辑
135. 第一次观看的观众
14 
15Agent 先记录简洁决定，再写时间线产物。`validate.py` 负责对理解索引做机械校验，从不改写 Agent 的稿子：段落顺序、数量、时间、文本、停顿和扩展元数据原样保留，只依据现有声音证据回写实测的 `overlaps_speech`。文本装不下时间窗、段落未按时间排序等问题以 error 退回给 Agent 修改。
16 
17下面的 `scripts/...` 均相对于本技能目录。若执行器从仓库根目录启动，请给脚本路径加上本技能的绝对目录。
18 
19### 1.1 创作控制模式
20 
21先根据用户要求和 `work_dir` 判断本轮创作控制模式。它与 `full|cut|dub` 渲染模式分别选择：
22 
23- **CREATE**：首次创作。比较至少两个真正可行的故事/剪辑假设后再选择。
24- **DIRECTED**：用户已指定结构、镜头、台词或表达。忠实落实，不为满足“创作流程”虚构替代方案。
25- **REVISION**：用户针对已有版本看片修改。最新反馈是当前事实来源；未点名部分默认冻结。
26 
27REVISION 先明确本轮修改项与冻结项，再编辑对应层：表达、口语节奏、字幕反馈更新 `style_card.json`；镜头、入出点、表演和声音分工更新 `visual_audio_board.json`；只有观众承诺、POV、主线或 beat 改变时才更新 `recap_story_plan.json`。被删除的镜头、原声或文案也要从相关计划中删除，不能保留过期锚点。不要把看片修改重新做成一次 CREATE。
28 
29## 2. 远程调用与数据外发
30 
31本技能只有一个脚本会联网：`review.py`（§7.1 的建议型语义评审）。其余全部在本地运行：`validate.py` 及其 lint、去 AI 味检查只读写 `work_dir` 里的文件，不发任何网络请求；策划与写稿由 Agent 直接读写 `work_dir` 完成。
32 
33`review.py` 发给谁：
34 
35- MiMo 的 OpenAI 兼容 chat 接口 `<MIMO_API_URL>/chat/completions`，用 `MIMO_API_KEY` 认证，模型为 `MIMO_MODEL`（默认 `mimo-v2.5`）。未设 `MIMO_API_URL` 时，按量计费 key 发往 `https://api.xiaomimimo.com/v1`，`tp-` 开头的 Token Plan key 发往 `MIMO_TOKEN_PLAN_CLUSTER` 选定的 token-plan 集群（默认 `https://token-plan-cn.xiaomimimo.com/v1`）。
36- 未设 `MIMO_API_KEY` 时直接退出，不构造也不发送任何请求。
37 
38`review.py` 发送什么（只有文字，不发视频、帧图片或音频文件）：
39 
40- `narration.json` 全部旁白段的时间与文字。
41…