winterwindwang/super-video-cut

super-video-cut 是做什么的？

定位

将每一次剪辑工作视为带有证据链的工程交付，而不是凭感觉堆叠的片段集合。本技能提供可重复的客观测量、逐项论证的评估、可复用的时线模板、交付前质量控制，以及贯穿全流程的版权边界。

references/ 目录存放了按能力领域划分的深度资料（约 50 份文档，大部分为 100–250 行的参数表和规范）。请勿预先全部阅读——按照下文的路由，仅阅读当前阶段所需的 1–3 份文档。

本文件中使用的卷号缩写：09/02 表示 references/09-material-memory/02-*.md。

三条红线

违反其中任意一条，则不得交付。

1. 参考风格：先评估，后剪辑。 当用户提供参考视频时，必须完成三维度评估（编辑工艺 / 声音 / 场景），每个条目附带逐项论证，并在获得用户确认后方可操作时线。未经确认就进行剪辑视为返工。
2. 素材：在调用模型前先检查缓存。 在分析任何视频素材前，运行 material_cache.py lookup。如果命中，直接读取素材描述卡——禁止再次调用视频模型查看；只有在未命中时才进行一次完整分析并注册。
3. 合规和质量控制优先。 不制作版权风险未定的计划，不交付未通过 qc_scan.sh 的完成文件。法律卷是参考资料，而非法律建议；对于商业或高风险项目，告知用户应请法律顾问审查。

主要工作流 M0–M6

阶段	目标	必须阅读	产出
M0 需求接收	锁定可执行参数	本文件	简报
M1 素材入库	永远不用支付两次相同的令牌费用	09/02 + scripts/material_cache.py	素材描述卡或缓存命中
M2 风格评估	将“感觉”转化为参数	08/02 + 08/03 + scripts/reference_probe.sh	评估表 + 指纹 + 单页结论
M3 剪辑计划	指纹 → 时线	08/04 + 匹配的类型卷	秒级计划
M4 制作	剪辑 / 配音 / 字幕 / 调色	根据需要阅读 01 / 02 / 03	粗剪和工程文件
M5 交付质量控制	技术 + 合规通过	06/01 + 06/02 + 06/03	QC 报告 + 检测日志
M6 反馈	只产出候选方案，从不自动更改规则	08/05	自我改进记录

M0 需求接收：询问缺失参数，最多 3 个问题

必须获取：平台和宽高比（决定安全区域和时长）、总时长、是否需要配音/旁白、是否为商业用途、交付规格（分辨率 / 码率 / 封装格式）。

根据已有信息可推断的内容请自行推断并陈述，不要逐项质问用户。作品是否为商业用途直接决定了可使用的音乐和素材——如果这一点不明确，您必须提问。

M1 素材入库：五种状态的操作为硬编码

SK="$HOME/.workbuddy/skills/super-video-cut"
export MDC_HOME="$PWD/material-cache"     # 将缓存放在项目内，绝不放在技能目录内
python "$SK/scripts/material_cache.py" lookup "<素材路径>"

状态	操作
HIT	不要调用视频模型。 读取 $MDC_HOME/cards/<MID>.yaml 并进行主题适配即可
MISS	本地 E1 探测 → 一次完整分析请求（使用 references/09-material-memory/templates/model-analysis-prompt.md）→ 填写卡片 → validate → register
STALE	素材已变更；将旧卡片标记为 superseded 并按 MISS 重新处理
HIT_BLOCKED	权利状态未清除；切勿使用——先解决权利问题
终止开关	当 _config.json 中 cache_enabled=false 时，全部视为 MISS；禁止绕过

描述卡有三层：L0 身份（哈希 / 规格）、L1 素材描述（画面内容 / 拍摄地点 / 风格 / 可用性）、L2 主题适配（该素材的哪些秒数用于哪个主题，以及其叙事角色）。“非常适合作为主题 X 的开场”仅属于 L2——放入 L1 会污染所有其他主题。

地点字段是硬规则：如果没有屏幕文字、地标或拍摄记录，则设置 place_name: null。绝不要从“有大海和棕榈树”推断城市。

M2 风格评估：当用户提供参考视频时的六步流程

S1 合规预检 → S2 客观探测 → S3 两次完整观看 → S4 逐维度评估
→ S5 单页结论 → S6 ★用户确认关卡★

• S1 仅分析，绝不复用其表达。开场/结尾标题、对话、音乐、动态文字、镜头调度均标记为 protected: expression。
• S2 运行探测脚本以获取可重复的数字（剪切点、镜头时长、响度、静音、色彩统计、联系表）。
• S3 完整观看两遍：第一遍只看画面，第二遍只听声音。快进会丢失节奏和停顿——这是最常见的方法论错误。
• S4 逐项评估三个核心组——A 编辑工艺 / B 声音 / C 场景（每组 10 个子项）——加上 D 字幕、E 叙事、F 平台上下文，以及 G 合规边界（必选）。
• S5 提供单页结论：3 个关键特征、3 个不可迁移项、总体置信度。
• S6 交给用户确认。未获确认不得进入 M3。

每项评估条目必须填写全部五部分；缺失任何部分则整个条目无效：

① 观察（时间码 + 具体现象）② 依据（证据 ID）③ 推理（为何如此设计）④ 行动项（本剪辑如何借鉴）⑤ 置信度（高/中/低 + 理由）

反例（绝不允许输出）：“剪辑很流畅，非常电影感。”——没有时间码、没有依据、没有行动项，毫无可执行性。

每个行动项必须附带迁移标签：transferable: parameter（节奏、时长、响度、景别序列——可学习）或 protected: expression（特定镜头、对白、音乐、动态文字——不可复制）。风格和公式属于思想领域可以借鉴；表达则不得抄袭。 这是本技能的版权底线，而非建议。

M3 剪辑计划：将指纹转换为秒级时线

阅读 08/04 中的映射规则，生成可直接执行的时线：每个片段的入/出点、景别、转场类型及时长（以帧计）、音效提示点、字幕入/出点、响度目标。

冲突解决顺序：用户明确要求 > 平台硬限制 > 参考视频特征 > 默认美学。当素材无法支持某项要求时，需直接说明——“参考视频使用了技巧 X；本项目无匹配素材，因此用 Y 替代”——不要强行使用。

M4 制作：每次操作只阅读一个卷

操作	阅读
节奏、转场、轴线	01/01、01/02
工程组织、代理、回批、交付	01/03
调色、Log/LUT、HDR	01/04
录音、交付、ADR	02/01
混音、响度、均衡/压缩	02/02
配乐、音效、声音设计	02/03
AI 语音、TTS、SSML	02/04
字幕布局及时长	03/01
SRT/VTT/ASS/TTML 格式	03/02
转录、对齐、烧录	03/03
多语言、CC/SDH、无障碍	03/04
特定类型剪辑方法	04/01–04/06

响度锚点（完整目标表见 02/02）：流媒体约 −14 LUFS、播客/Apple 约 −16 LUFS、广播 EBU R128 为 −23 LUFS，真峰值一般要求 ≤ −1 dBTP。以目标平台的官方文档为准；如有疑问，先测量，再决定。

M5 交付质量控制：先运行脚本，再人工判断

bash "$SK/scripts/qc_scan.sh" "<完成文件>" "<输出目录>"

一次运行可产出规格 JSON、解码完整性、黑帧/冻结检测、静音、响度、联系表。脚本只能发现技术异常——内容和合规必须手动检查表格：

• 06/01 技术规格清单（分辨率 / 帧率 / 色彩 / 码率 / 音轨 / 时长 / 命名）
• 06/02 内容与合规审查（事实、敏感内容、禁用广告用语、权利文档）
• 06/03 A–G 表填写模板（存档用）

QC 严重级别：阻断性（黑帧、缺失音轨、响度超差、侵权风险）必须修复；改进项可记录后交付；建议项等待下一版本。

M6 反馈循环：一条爆款视频从不改变规则

收到真实反馈后（完播率、转化率、客户意见），按 08/05 进行错误归因，并写入 08/case-library/<CASE-ID>/self-improvement-record.md。

硬规则：单个案例仅产出候选方案；只有在收集到 ≥5 个同方向样本、冻结回归集、人工签字确认、版本管理和金丝雀发布后，变更才能生效。自我改进引擎不得自动重写素材描述卡的 E1/E2 客观字段——否则缓存会将一次错误扩散到所有后续主题，而命中记录仍然看似正常。

触发后的最短路径

用户说	执行以下操作
“照着这个爆款视频的风格剪一个”	完整 M2 流程 → S6 确认关卡；不要开始剪辑
“帮我剪这个视频”	M0 询问平台/时长/商用 → M1 素材 → M3 计划
“这个素材能用吗？里面有什么？”	M1 lookup；命中直接回答，未命中才分析
“加字幕”	03/01 布局 + 03/03 转录和对齐；检查阅读速度和最短时长
“配音听起来不好”	02/01 录音 → 02/02 处理链 → 测量响度
“导出为抖音 / 视频号 / B站”	04/01 平台规格 + 06/01 交付检查
“这个剪辑会侵权吗？”	05/02 决策树 + 08/02 中的维度 G；给出风险等级而非结论性法律意见
“完成的剪辑没问题吗？”	qc_scan.sh + 06/01 / 06/02 逐项检查

脚本

脚本	用途	依赖
scripts/material_cache.py	素材指纹、缓存查询、注册、复用、验证、统计（8 个子命令）	Python 3，无需第三方包
scripts/reference_probe.sh	参考或素材文件的客观探测：剪切点、镜头时长、响度、静音、色彩、联系表	bash + ffmpeg/ffprobe
scripts/qc_scan.sh	完成文件的技术 QC：规格、解码、黑帧、冻结、静音、响度、联系表	bash + ffmpeg/ffprobe

首先检查环境：ffmpeg -version && ffprobe -version && python --version。如果没有 ffmpeg，则无法进行任何客观测量——这种情况需直接告知用户只能进行人工评估，无法给出可重复的指标。绝不要编造数字。

交付前自检

• 参考视频经历了 S1–S6 且用户已确认（如果使用了参考视频）
• 每段素材均可追溯至缓存中的来源和权利状态
• 评估和计划中没有出现“流畅”、“高级”、“有质感”等不可支持的措辞
• 响度已测量并在目标容差范围内；真峰值低于限制值
• 字幕未溢出安全区域，无拼写错误，满足阅读速度限制
• qc_scan.sh 未报告任何阻断项，且 A–G 表已填写
• 音乐 / 字体 / 肖像 / 素材库的权利文档完整，或已注明风险等级
• 交付文件命名、封装格式和码率符合平台要求

资料范围（必须向用户说明）

• 法律卷并非法律建议。 法规和司法观点会变化；对于商业或高风险项目，请咨询法律顾问并依赖最新官方文本。
• 平台参数会变化。 时长、码率、安全区域和响度目标在不同来源间存在冲突，因此始终标记为“以平台最新官方文档为准”——交付前请上传并预览以核实。
• 自我改进参数无行业标准。 卷 08 中的 η、δ、N_min 等是本技能库自身的初始值，仅用于使流程可运行，并非经过验证的最优值。
• 约有 190 个“待验证”项，分布于各文档正文或末尾，主要集中在 references/00-overview/sources-and-reliability.md（附有 A/B/C/D 证据等级和 P0/P1/P2 优先级）。引用前请检查该文件的证据等级。

路由和索引

• references/INDEX.md — 各阶段或任务的最短路径和最低阅读要求
• references/00-overview/knowledge-map.md — 完整能力领域映射和问题快速查找
• references/00-overview/sources-and-reliability.md — 证据等级、来源列表、待验证项
• references/00-overview/manifest.csv — 机器可读的文件索引

搜索大文件时，请通过关键词定位而非通读全文，例如 grep -n "LUFS" references/02-audio-and-voice/02-audio-post-and-mixing.md。