mcpField
C
cut-mistakes

cut-mistakes

github.com/nateherkai创意与媒体2.3k191 次安装2 周前更新
代码仓库

关于 cut-mistakes

cut-mistakes 是用于视频剪辑的技能，可查找口吃、重复语句、未完成的开头和失误重录。它会先提供候选片段供人工审核，再应用获批的剪切，避免误删有意重复。

主要功能

  1. 01检测口吃和重复词语
  2. 02查找未完成开头和重录
  3. 03结合上下文审核候选片段
  4. 04应用获批剪切并重排时间轴

适用场景

  1. 01清理录制中的口误
  2. 02剪辑前审核重复语句
  3. 03接续 cut-silences 的剪辑流程

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nateherkai/herk-edit-kit --skill cut-mistakes

安装后在 Claude Code 中输入/cut-mistakes确认已加载。

附带文件scripts/apply-cuts.mjsscripts/find-cut-candidates.mjs

详细介绍

剪掉口误和重复内容（Pipeline Agent 2）

自动剪辑的第二步，在 cut-silences 之后运行。它会剪掉人工编辑者在第二轮会剪掉的内容：口吃（“the the”“I- I-”）、紧接着重复的词、说到一半又重新开始的错误开头，以及重录内容（重新录制的一句话——保留干净的版本，删掉出错的版本）。

判断哪些内容算错误，取决于判断，而非公式——强调重复（“never, never”）和修辞性重复（“the first piece is, is this…”）从机械层面看起来与口吃完全相同。因此，此 Agent 默认需要审核后才能处理：它会提供带完整上下文的候选项；由 Agent 和用户作出判断；只渲染获批的剪辑。

何时使用

  • “剪掉口误”“移除口吃／重复”“清理说错的内容”“保留最佳版本”“剪掉错误开头”
  • 作为主剪辑工作流的第二阶段，处理 cut-silences 的输出。

三步流程

1. 查找候选项（机械检测）
node .agents/skills/cut-mistakes/scripts/find-cut-candidates.mjs \
  <silence-transcript.json> --out-dir video-projects/<slug>/assets

通常以 Agent 1 的 <stem>.silence-transcript.json 作为输入，这样剪辑就会落在已经静音处理的时间线上。生成：

  • <stem>.cut-candidates.json——结构化的候选项（类型、置信度、建议的 cut 范围、removes／keeps 文本、上下文、建议）
  • <stem>.cut-candidates.md——可读的剪辑建议

候选项类型：stutter（紧接着重复单词）、retake（通过 Jaccard 相似度检测重复／近似重复片段）、false_start（说到一半放弃并重新开始的短语）。

2. 审核（把关步骤——必须执行）

结合上下文逐一查看候选项，并决定保留还是剪掉。机械检测器无法区分刻意强调／修辞与真正的口误，因此不要盲目相信 recommend——请阅读 removes 和 context。常见误报：强调重复（“it's never, never hands-off”）、系词后接疑问句（“the piece is, is this…”）、列举内容。

向用户展示候选项，并为每项给出建议；收集用户的批准结果。将获批的剪辑写入文件：

{ "cuts": [ { "start": 100.93, "end": 101.06, "reason": "I- false start" }, ... ] }

（start／end 是输入转录／视频时间线上的秒数。你可以扩大候选项的范围——例如，对于重录内容，可以从出错版本的开头剪到干净版本重新开始的位置。）

3. 应用获批的剪辑
node .agents/skills/cut-mistakes/scripts/apply-cuts.mjs \
  <silence-transcript.json> --cuts approved-cuts.json \
  --video video-projects/<slug>/assets/edited-silenced.mp4 \
  --output video-projects/<slug>/assets/edited-clean.mp4 --apply

生成 EDL、重新计时的 <stem>.mistakes-transcript.json（供动态图形 Agent 和 validate-beat-sync.mjs 使用）、决策日志；使用 --apply 时还会生成剪辑后的视频（通过 ffmpeg trim+concat 拼接，保持音视频同步）。移除 --apply 可进行试运行。

审核结果

使用共享审核工具检查剪辑效果，并抽查剪辑边界：

node scripts/build-edl-review.mjs <stem>.mistakes-edl.json \
  --original video-projects/<slug>/assets/edited-silenced.mp4 \
  --edited   video-projects/<slug>/assets/edited-clean.mp4 \
  --output   video-projects/<slug>/assets/mistakes-review.html
npx serve . -p 8080 -n

注意事项

  • 表达非常流畅的录制内容可能很少甚至完全没有真正需要剪掉的内容——这是正常结果；不要为了达到配额而剪掉自然表达。
  • 两个口语词之间的剪辑会形成硬切。剪掉口吃／错误开头时通常效果干净；如需更紧凑的音频，可在之后添加 20–30ms 的淡入淡出。
  • 将 mistakes-transcript.json 和干净的视频交给 Agent 3（动态图形／分层卡片）。

评论

支持 Markdown