Communitygithub.com

TaherZiad/montage-crew

视频编辑流水线的第二个智能体。从人物出镜录音中查找并移除口语错误——结巴、重复词、假开头和重录音。在“静音剪辑”之后使用,当要求剪掉错误、移除结巴/重复/填充性重启、清理口误或保留最佳录制时调用。基于审核流程:它会为每一个剪切提出上下文和理由供审批,然后仅对批准的剪切通过 ffmpeg 渲染。需要字级转录。

montage-crew 是什么?

此智能体是自动化视频编辑流水线的第二阶段,紧随“cut-silences”智能体之后运行。它的核心功能是识别并从人物出镜录音中移除四种类型的口语错误:结巴(如“the the”或“I- I-”)、立即重复的词、假开头(一个被放弃并重新开始的短语)以及重录音(重新录制的台词——保留干净的版本,丢弃出错的版本)。由于机械检测无法区分真正的口误和有意重复(如强调性重复“never, never”或修辞性重复“the first piece is, is this…”),该智能体默认采用审核机制:它会列出一份候选剪辑列表,包含完整的上下文文本、原始内容与保留内容以及置信度,然后由用户或上级智能体逐项审批。仅已批准的剪辑会被应用,通过 ffmpeg 执行时间修剪和 A/V 同步连接。它需要由上游阶段生成的、带有时间戳的字级转录 JSON 文件作为输入,并输出一份重新调整时间轴的转录,供下一阶段(动态图形智能体)使用。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TaherZiad/montage-crew/tree/HEAD/skills/montage-crew/references/external/hyperframes-student-kit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

剪辑错误与重复(流水线智能体 2)

自动化剪辑的第二步,在 cut-silences 之后运行。它移除人工编辑在第二遍剪辑中会剪掉的内容:结巴("the the","I- I-")、立即重复的词、假开头(一个被放弃并重新开始的短语)以及重录音(重新录制的台词——保留干净的版本,丢弃出错的版本)。

判断什么算作错误是判断,而非公式——强调性重复("never, never")和修辞性重复("the first piece is, is this…")在机械上看起来与结巴完全一样。因此,默认情况下此智能体是审核机制:它展示带有完整上下文的候选内容;智能体(和用户)决定;仅批准的剪辑会被渲染。

使用时机

  • "剪掉错误"、"移除结巴/重复"、"清理口误"、"保留最佳录制"、"剪掉假开头"
  • 作为主编辑工作流的第二阶段,处理 cut-silences 的输出。

三个步骤的流程

1. 查找候选内容(机械操作)

node .claude/skills/cut-mistakes/scripts/find-cut-candidates.mjs \
  <silence-transcript.json> --out-dir video-projects/<slug>/assets

输入通常是智能体 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 .claude/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(供动态图形智能体和 validate-beat-sync.mjs 使用)、决策日志,以及(使用 --apply)剪辑后的视频(ffmpeg 修剪+连接,A/V 同步)。去掉 --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 + 干净视频传递给智能体 3(动态图形/分层卡片)。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

TaherZiad/montage-crew

Cut silences and dead weight (fillers, repeated takes, false starts) out of a talking-head video BEFORE building the edit - call the measured /auto-trim API instead of hand-rolling ffmpeg, review the dead-weight candidates it returns, and do the one job only a human/AI can do (spotting repeated POINTS). Read this when the brief enables "Tự động cắt ngắn video" (autoCut) or the user complains that the video still has dead weight/silences.

TaherZiad/montage-crew

Membangun motion graphic sinematik di browser (promo video, opener, intro, bumper, kinetic typography, explainer/video penjelasan bergambar 16:9 atau 9:16) memakai HTML + CSS + GSAP (+ Three.js bila perlu), dengan hasil yang bergerak seperti video sungguhan — bukan slide presentasi. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin merender animasi web menjadi file video MP4, atau ingin explainer kartun/animasi dibangun LANGSUNG di After Effects lewat bridge/MCP Higgsfield.

TaherZiad/montage-crew

Arabic short-video editor (any dialect). Edits talking-head videos and screen recordings, or builds an MG-led video from an idea with no footage - retakes and silences cut, Arabic RTL captions and hook, premium motion graphics, SFX, music, -14 LUFS master, cover - for 9:16, 16:9 or both. Delivers the MP4 plus a project for Resolve, Premiere, After Effects, CapCut or Final Cut. Asks a few questions on first use, keeps the user's brand kit, offers style cards, learns styles from videos, links and MG sites the user shows it, and learns the user's rules after each video. Use when the user asks to edit a video («منتجلي هذا الفيديو», «سوّي مونتاج», «أضف ترجمة», «قص الصمت», «بستايل …», "edit my video"), make a video from an idea («ما عندي فيديو، عندي فكرة», «فكرة فيديو عن…»), learn a style («تعلّم من هذا الفيديو», «هذا الموشن يعجبني»), save a brand («احفظ هويتي», «اقترح لي هوية») or change settings («غيّر إعداداتي»).

相关技能