video-forge

name: video-forge description: > 视频制作全链路：素材入库 → 剧本冻结 → 全局配音 → 对齐 → 渲染 → 审查 → 交付。 Use when: 做视频、做 showcase、做教程视频、录屏剪辑、video review、节奏审查。 Not for: 纯代码开发（用 worktree/tdd）、纯文档写作（直接写）、PPT（用 ppt-forge）。 Output: schema 驱动的视频成片 + 多猫审查通过 + 可发布。

Video Forge — AI 视频生产线

关联 Feature: F138 Video Studio 技术收敛纪要: 2026-04-05 三猫收敛

核心原则

视频不是一只猫的活，是多猫流水线 + 铲屎官素材。 角色按当前 roster 可用猫分配。

• 主执行猫（当前持球猫）：video-spec 编排 + Remotion 渲染 + 对齐集成
• QA/审查猫（跨 family）：音画同步 QA + 事实审查 + schema review
• 视觉把关猫（跨 family）：节奏/调性审查 + 字幕/排版设计 + retiming 风格把关
• 铲屎官：素材录制 + 粗标时间点 + 剧本确认 + 审片

铁规矩

1. 全局音频，不段级切碎 — TTS 拿完整剧本一口气读完，保住情绪和呼吸感（KD-12）
2. 不赌 TTS 原生 timestamps — forced alignment 出时间戳（KD-10）
3. 拒绝暴力慢放 — 画面不够时：FREEZE_STYLIZED > B_ROLL > SLOW_MO（KD-14）
4. Contract 和 Renderer 解耦 — video-spec JSON 是真相源，Remotion/FFmpeg 是可替换渲染器

两条生产路径

两条路径共享同一套 segment contract + 渲染层。

开局参数（必须声明）

没有开局参数 = 审查没有标准。开工前必须和铲屎官确认。

场景路由（路径 B）

审查 Gate（F 场景）

F1: 音画同步审查（QA/审查猫）

F2: 节奏/调性审查（视觉把关猫）

F3: 内容审查（铲屎官）

素材管理规范

目录结构

docs/videos/{project-name}/
├── asset-markers.md       ← 素材标注表（铲屎官 + 主执行猫共同编辑）
├── video-spec.json        ← segment contract（主执行猫生成）
├── voice-script.md        ← 配音剧本（主执行猫草稿 + 铲屎官确认）
└── assets/                ← 原始素材（gitignore, 仅本地）
    ├── 1-xxx.mov
    ├── 2-xxx.mov
    └── ...

素材压缩标准（入库前）

ffmpeg -i input.mov -c:v libx264 -crf 23 -c:a aac -b:a 128k output.mp4
# 目标：1080p, CRF 23, AAC 128k

粗标格式（铲屎官填）

时间 | 画面内容
0:00 - 0:50 | 铲屎官在打字
0:50 - 1:20 | Ragdoll开始回复，1:20 Maine Coon跟上

retiming 策略优先级

当配音长度和画面长度不匹配时，按以下优先级选择策略：

绝对不允许 <0.7x 的慢放。 如果需要填充超过 30% 的时间差，必须用 B_ROLL 或 FREEZE_STYLIZED。

常见错误

技术栈

Next Step

路径 B 完整流程跑通后 → quality-gate（自检）→ request-review（QA/审查猫审音画，视觉把关猫审节奏）