net-new-video-editor

全新视频剪辑

从新录制的素材制作可逆的首版剪辑。将创意决策保存在 JSON 中，并使用随附的渲染器处理像素操作。

前言

如果存在可选的共享遥测辅助工具，请从仓库根目录运行：

python3 telemetry/version_check.py 2>/dev/null || true
python3 telemetry/telemetry_init.py 2>/dev/null || true

远程遥测为选择加入，且绝不包含内容、文件路径、仓库名称或凭据。

建立软件包

阅读 references/project-contract.md。找到确切的源录制素材、转录文本、创意卡片或简报、证明素材和屏幕录制。绝不要替换为其他录制素材、品牌、账户或素材库。

仅当目标位置明确时，才初始化新项目：

python3 scripts/net_new_video_editor.py init --project <project-dir>

仅将用户授权的输入复制到生成的软件包中，或指向这些输入。保留原始素材。

编辑前检查

运行：

python3 scripts/net_new_video_editor.py inspect --project <project-dir>

检查 intake-report.json。如果软件包中没有可播放的片段、所请求的目标与提供的素材不符，或缺少必需的外部素材，请停止。

制定剪辑计划

使用转录文本和简报创建 edit-plan-clean.json。以口播开场钩子和论点边界为事实依据。

• 明确选择一个源片段。
• 合理安排片段顺序，时间戳不得超出源素材时长。
• 仅在剪辑仍然自然时，去掉明显的说错重来、长时间空白和孤立的填充词。
• 保留有助于理解的呼吸声。
• 开场钩子的屏幕显示时间不得超过 5 秒。
• 使用简短易读的字幕短语。
• 仅在提供了相关素材时添加证明内容或屏幕插入画面。随附的渲染器负责基础合成；复杂叠加层应在单独记录的流程中添加。
• 标准化语音音量，避免削波。

制作第二个版本时，将计划复制为 edit-plan-aggressive.json，并且只进行明确标注的留存率调整。不得悄然更改事实性论点。

验证每个计划：

python3 scripts/net_new_video_editor.py validate --project <project-dir> --plan <plan.json>

确定性渲染

从此技能目录运行渲染器：

python3 scripts/net_new_video_editor.py render \
  --project <project-dir> \
  --plan <plan.json>

渲染器会修剪配对的音频和视频、串接选定片段、创建中心安全的 9:16 画面、使用 Pillow 栅格化字幕和开场钩子卡片、使用 FFmpeg 合成画面、标准化音频、写入 H.264/AAC MP4，并创建 3 张 QA 帧和 qa-report.json。

使用 --dry-run 检查 FFmpeg 命令。仅在确实要替换对应的派生导出文件时使用 --force。

检查输出

检查导出的 MP4、全部 3 张 QA 帧、qa-report.json 以及各版本计划之间的差异。确认：

• 每次剪辑后，音频与嘴部动作仍保持同步；
• 没有单词突兀地开始或结束；
• 字幕与口播内容一致，且位于安全边距内；
• 裁切画面让发言者保持可见；
• 开场钩子清晰易读，并在视频中得到兑现；
• 响度一致，峰值不会造成失真；
• 每个证明插入画面和数值论断都有提供的来源；
• 除非简报要求其他格式，否则导出格式为 1080x1920 H.264/AAC。

返回计划、导出路径、QA 证据以及任何需要补录的内容。未经当前明确批准，绝不要发布、上传、删除原始素材或覆盖已批准的母版。

完成状态

• DONE：渲染和 QA 均通过，且审查文件齐全。
• DONE_WITH_CONCERNS：草稿可用，但仍存在已明确指出的创意或来源问题。
• NEEDS_CONTEXT：缺少片段、转录文本、简报或已批准的素材。
• BLOCKED：FFmpeg、源素材访问或格式验证问题导致无法安全渲染。