用途
mc-cut 用于视频剪辑项目的“cut（粗剪）”阶段，把 raw/ 目录下的原始拍摄素材整理为一份经过创作者批准的剪辑。它的产出物包括 cut/edl.json（剪辑决策表）、切点计划、编辑审查报告、预览渲染和编辑器时间线。
主要能力
- 素材预检：对 raw/ 中每个源文件运行 preflight.py，生成 CFR 主文件并做质量检查；源 QC 失败（退出码 3）是硬性停止。
- 转录与校验：选择转录通道（已发布素材用字幕而非本地 ASR），构建音频映射，并用 verify_transcript.py 证明转录完整性。音频映射是整个阶段的时间真相来源。
- 候选切点生成：cutplan.py 基于转录、音频映射和 voice-bible 找出机械候选切点，并将每个边界吸附到经音频验证的静音区间。访谈素材中，提问会被标为标记候选，保留回答。
- EDL 编写与校验：按 script.md 和 Production Bible 判断候选，写出 cut/edl.json，再由 verify_edl.py 校验每个边界是否落在音频验证的静音中，以及每段是否带有 quote 和 reason。
- 编辑审查：通过 edited_transcript.py 重建观众实际听到的内容，按 editorial-pass.md 进行编辑审阅，输出 cut/editorial-review.md；建议不会自动应用。
- 虚拟时间线：用 edl_to_ffconcat.py 生成预览拼接文件，可直接用 ffplay 播放，无需渲染文件；支持导出 FCPXML 并在 Resolve 中导入。
- 应用批准决定：把创作者决定写入 approved-spans.json，用 snap_spans.py 机械吸附，重写 EDL 并重新校验。
- 派生工件再生成：EDL 一旦改动，虚拟时间线、FCPXML、编辑后转录、预览、边界帧及 beats 锚点全部失效，必须按固定顺序整体重新生成。
- 时间码重映射：remap_timecode.py 支持源时间码与剪辑后时间码双向转换。
- 交付渲染：仅在确实需要文件时渲染（合成预览、上传分享或 gate-4 终版），并检查边界帧的黑帧与跨界问题。
使用方式
该技能以脚本命令驱动，依赖 studio 配置（modules.manticore）、project.json、script.md、Production Bible 和 Voice Bible。若配置缺失或两份 Bible 不存在，技能会提示并路由到 mc-setup 后停止。核心命令包括 preflight.py、analyze_audio.py、verify_transcript.py、cutplan.py、verify_edl.py、edited_transcript.py、edl_to_ffconcat.py、edl_to_fcpxml.py、snap_spans.py 等，均以 uv run 方式调用。转录窗口固定为 20 秒、重叠 3 秒；不得为提速调大窗口，因为长窗口会无报错地丢失整段内容。
适用场景
适用于已有原始拍摄素材、需要按脚本和品牌品味进行粗剪的视频项目，尤其是需要严格保证不切断词语、不丢失内容的剪辑流程，以及使用 Resolve 作为编辑器的工作流。
限制
必须依赖 mc-setup 完成配置及两份 Bible 文件，否则无法开始。转录未通过校验、源 QC 失败、EDL 校验失败均为硬性停止。三个事项无法由脚本检查，需人工负责：听预览中的拼接点、耳听未经吸附的区间、在首个项目上人工验证 FCPXML 同步。部分细节（如具体配置项取值）资料未完整给出。