Skip to content

JimLiu/baocut / skills/baocut

baocut

Flagged

用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。

FileKindSize
SKILL.mdskill md46.5 KB
built-in-skills/README.mdmarkdown9.6 KB
references/catalog/editing.mdmarkdown24.4 KB
references/catalog/export.mdmarkdown6.6 KB
references/catalog/media.mdmarkdown45.1 KB
references/catalog/models.mdmarkdown7.9 KB
references/catalog/music.mdmarkdown17.1 KB
references/catalog/subtitles.mdmarkdown20.8 KB
references/catalog/system.mdmarkdown9.6 KB
references/catalog/voice-gemini-tts.mdmarkdown2.6 KB
references/catalog/voice-language-rates.mdmarkdown6.5 KB
references/catalog/voice.mdmarkdown12.3 KB
references/catalog/web.mdmarkdown10.9 KB
references/conventions.mdmarkdown16.1 KB
references/craft/.gitkeepother0 B
references/craft/README.mdmarkdown480 B
references/craft/character-animation.mdmarkdown6.8 KB
references/craft/character-animation/examples/mini-film/art.example.jsonconfig918 B
references/craft/character-animation/examples/mini-film/index.htmlother628 B
references/craft/character-animation/examples/mini-film/scene.jsscript2.1 KB
references/craft/character-animation/references/art.mdmarkdown4.6 KB
references/craft/character-animation/references/checks.mdmarkdown2.6 KB
references/craft/character-animation/references/rig.mdmarkdown5.3 KB
references/craft/character-animation/references/style-and-story.mdmarkdown5.0 KB
references/craft/character-animation/references/timing-and-sound.mdmarkdown3.1 KB
references/craft/character-animation/rig-kit/rig-kit.jsscript33.0 KB
references/craft/character-animation/scripts/cutout.mjsscript26.9 KB
references/craft/character-animation/scripts/jump-scan.mjsscript3.2 KB
references/craft/character-animation/scripts/place-sfx.mjsscript5.1 KB
references/craft/character-animation/scripts/rig-check.mjsscript8.9 KB
references/craft/clip-montage.mdmarkdown11.5 KB
references/craft/clip-montage/references/assembly.mdmarkdown5.0 KB
references/craft/clip-montage/references/sourcing.mdmarkdown6.3 KB
references/craft/clip-montage/references/structure.mdmarkdown3.8 KB
references/craft/cover-and-title.mdmarkdown5.6 KB
references/craft/cross-video-qa.mdmarkdown5.8 KB
references/craft/design-system.mdmarkdown18.5 KB
references/craft/design-system/references/cover.mdmarkdown6.9 KB
references/craft/design-system/references/craft.mdmarkdown8.8 KB
references/craft/design-system/references/demo.jsonconfig161.1 KB
references/craft/design-system/references/format.mdmarkdown18.6 KB
references/craft/design-system/references/from-code.mdmarkdown11.5 KB
references/craft/design-system/references/from-design-tool.mdmarkdown16.2 KB
references/craft/design-system/references/sample-seazar-tokens.jsonconfig11.0 KB
references/craft/design.mdmarkdown19.3 KB
references/craft/design/references/brand-colors.mdmarkdown2.4 KB
references/craft/design/references/brand-typography.mdmarkdown1.7 KB
references/craft/design/references/craft.mdmarkdown15.4 KB
references/craft/design/references/design-system-components.mdmarkdown11.8 KB
references/craft/design/references/diagrams.mdmarkdown10.1 KB
references/craft/design/references/format.mdmarkdown11.8 KB
references/craft/design/references/print.mdmarkdown5.6 KB
references/craft/design/references/questions.mdmarkdown4.7 KB
references/craft/design/references/view-state.mdmarkdown5.7 KB
references/craft/docs.mdmarkdown19.9 KB
references/craft/docs/references/comments.mdmarkdown4.4 KB
references/craft/docs/references/editing.mdmarkdown12.9 KB
references/craft/docs/references/tabs.mdmarkdown4.7 KB
references/craft/docs/references/uploads.mdmarkdown1.7 KB
references/craft/explainer-video.mdmarkdown23.4 KB
references/craft/explainer-video/references/3d.mdmarkdown5.9 KB
references/craft/explainer-video/references/footage.mdmarkdown9.6 KB
references/craft/explainer-video/references/length-and-pace.mdmarkdown6.7 KB
references/craft/explainer-video/references/script.mdmarkdown14.7 KB
references/craft/explainer-video/references/subject.mdmarkdown12.5 KB
references/craft/history-video.mdmarkdown20.6 KB
references/craft/history-video/references/brief.mdmarkdown5.1 KB
references/craft/history-video/references/forms.mdmarkdown11.2 KB
references/craft/history-video/references/old-recordings.mdmarkdown12.4 KB
references/craft/history-video/references/self-check.mdmarkdown5.3 KB
references/craft/history-video/references/sources.mdmarkdown5.9 KB
references/craft/motion-graphics.mdmarkdown17.3 KB
references/craft/motion-graphics/exemplars/big-number/16x9.htmlother11.4 KB
references/craft/motion-graphics/exemplars/big-number/9x16.htmlother11.5 KB
references/craft/motion-graphics/exemplars/callout-pin/16x9.htmlother11.6 KB
references/craft/motion-graphics/exemplars/callout-pin/9x16.htmlother11.6 KB
references/craft/motion-graphics/exemplars/keyword-caption/16x9.htmlother11.3 KB
references/craft/motion-graphics/exemplars/keyword-caption/9x16.htmlother11.3 KB
references/craft/motion-graphics/exemplars/logo-sting/16x9.htmlother12.1 KB
references/craft/motion-graphics/exemplars/logo-sting/9x16.htmlother12.1 KB
references/craft/motion-graphics/exemplars/lower-third/16x9.htmlother11.2 KB
references/craft/motion-graphics/exemplars/lower-third/9x16.htmlother11.2 KB
references/craft/motion-graphics/references/audio-backdrop.mdmarkdown22.9 KB
references/craft/motion-graphics/references/grammar.mdmarkdown11.1 KB
references/craft/motion-graphics/scaffold.htmlother9.0 KB
references/craft/motion-graphics/scripts/build-bundle.mjsscript25.2 KB
references/craft/narration.mdmarkdown11.1 KB
references/craft/polish-transcript.mdmarkdown13.8 KB
references/craft/production-scripts.mdmarkdown15.7 KB
references/craft/production-scripts/references/pipeline.mdmarkdown37.8 KB
references/craft/production-scripts/scene-kit/geo110.jsscript27.3 KB
references/craft/production-scripts/scene-kit/scene-kit.jsscript38.3 KB
references/craft/production-scripts/scripts/align.mjsscript11.6 KB
references/craft/production-scripts/scripts/assemble.mjsscript26.4 KB
references/craft/production-scripts/scripts/build.mjsscript18.1 KB
references/craft/production-scripts/scripts/captions.mjsscript18.6 KB
references/craft/production-scripts/scripts/clips.example.jsonconfig3.2 KB
references/craft/production-scripts/scripts/coverage.mjsscript10.0 KB
references/craft/production-scripts/scripts/envelope.mjsscript2.9 KB
references/craft/production-scripts/scripts/explainer.example.jsonconfig2.2 KB
references/craft/production-scripts/scripts/fonts.mjsscript7.0 KB
references/craft/production-scripts/scripts/frames.mjsscript7.7 KB
references/craft/production-scripts/scripts/gaps.mjsscript11.3 KB
references/craft/production-scripts/scripts/host.mjsscript14.8 KB
references/craft/production-scripts/scripts/legibility.mjsscript5.7 KB
references/craft/production-scripts/scripts/level.mjsscript9.2 KB
references/craft/production-scripts/scripts/lib.mjsscript19.3 KB
references/craft/production-scripts/scripts/overlay.mjsscript34.7 KB
references/craft/production-scripts/scripts/preview.mjsscript4.6 KB
references/craft/production-scripts/scripts/quotes.mjsscript7.4 KB
references/craft/production-scripts/scripts/sources.mjsscript6.2 KB
references/craft/production-scripts/scripts/srt.mjsscript5.8 KB
references/craft/production-scripts/scripts/voice.mjsscript7.7 KB
references/craft/shorts-segments.mdmarkdown30.8 KB
references/craft/slides.mdmarkdown13.8 KB
references/craft/slides/references/design-system.mdmarkdown6.3 KB
references/craft/slides/references/design.mdmarkdown9.3 KB
references/craft/slides/references/format.mdmarkdown12.2 KB
references/craft/slides/references/images.mdmarkdown4.2 KB
references/craft/speaker-labeling.mdmarkdown6.6 KB
references/craft/subtitle-workflow.mdmarkdown13.1 KB
references/craft/talking-head-cut.mdmarkdown9.3 KB
references/craft/talking-head-cut/references/picture-and-sound.mdmarkdown10.1 KB
references/craft/titles-and-description.mdmarkdown5.2 KB
references/craft/titles-and-description/references/description.mdmarkdown5.1 KB
references/craft/titles-and-description/references/titles.mdmarkdown5.5 KB
references/craft/titles-and-description/references/writing-baseline.mdmarkdown11.9 KB
references/craft/translate-subtitles.mdmarkdown13.4 KB
references/craft/video-blog.mdmarkdown17.1 KB
references/craft/video-blog/references/writing-baseline.mdmarkdown11.9 KB
references/craft/video-chapters.mdmarkdown9.7 KB
references/craft/video-production.mdmarkdown31.9 KB
references/craft/video-production/examples/bundle-preview.htmlother17.7 KB
references/craft/video-production/examples/post-fx.jsscript7.5 KB
references/craft/video-production/references/code-scenes.mdmarkdown31.9 KB
references/craft/video-production/references/shot-plan.mdmarkdown5.1 KB
references/craft/video-production/references/sound-design.mdmarkdown4.4 KB
references/craft/video-production/references/visuals.mdmarkdown19.7 KB
references/craft/video-summary.mdmarkdown22.8 KB
references/craft/video-summary/references/writing-baseline.mdmarkdown11.9 KB
references/craft/virtual-host.mdmarkdown14.9 KB
references/craft/virtual-host/examples/character-partmap.example.jsonconfig600 B
references/craft/virtual-host/examples/character.example.jsonconfig336 B
references/craft/virtual-host/references/art.mdmarkdown22.1 KB
references/craft/virtual-host/references/hosts.mdmarkdown4.4 KB
references/craft/virtual-host/references/lipsync.mdmarkdown10.1 KB
references/craft/virtual-host/scripts/lipsync.mjsscript39.8 KB
references/craft/virtual-host/scripts/pinyin-table.mjsscript83.2 KB
references/craft/virtual-host/scripts/puppet-build.mjsscript48.6 KB
references/craft/virtual-host/scripts/puppet-mask.mjsscript3.0 KB
references/craft/virtual-host/scripts/puppet/align.mjsscript4.1 KB
references/craft/virtual-host/scripts/puppet/brows.mjsscript17.2 KB
references/craft/virtual-host/scripts/puppet/edits.mjsscript4.3 KB
references/craft/virtual-host/scripts/puppet/expression-labels.jsonconfig1.1 KB
references/craft/virtual-host/scripts/puppet/expreyes.mjsscript35.9 KB
references/craft/virtual-host/scripts/puppet/eyes.mjsscript8.6 KB
references/craft/virtual-host/scripts/puppet/fill.mjsscript10.5 KB
references/craft/virtual-host/scripts/puppet/layers.mjsscript5.7 KB
references/craft/virtual-host/scripts/puppet/mapbuild.mjsscript50.4 KB
references/craft/virtual-host/scripts/puppet/ops.mjsscript7.4 KB
references/craft/virtual-host/scripts/puppet/pack.mjsscript10.2 KB
references/craft/virtual-host/scripts/puppet/partmap.mjsscript8.5 KB
references/craft/virtual-host/scripts/puppet/parts.mjsscript7.0 KB
references/craft/virtual-host/scripts/puppet/png.mjsscript5.8 KB
references/craft/virtual-host/scripts/puppet/seg.mjsscript21.6 KB
references/craft/virtual-host/scripts/puppet/segment.mjsscript26.6 KB
references/craft/virtual-host/scripts/puppet/zip.mjsscript2.0 KB
references/craft/virtual-host/scripts/visemes.mjsscript21.4 KB
references/craft/vlog-from-clips.mdmarkdown13.2 KB
references/craft/vlog-from-clips/references/footage-log.mdmarkdown3.3 KB
references/mcp.mdmarkdown8.9 KB
references/start.mdmarkdown6.3 KB
references/workflows.mdmarkdown29.8 KB

references/craft/talking-head-cut.md

View on GitHub
<!-- 由 tools/sync-agent-skill.ts 从 skills/baocut/built-in-skills/talking-head-cut/ 生成,不要手改:改源文件后运行 npm run build:agent-skill -->

# 剪口播

> 一两个人对着镜头说话的录音要剪成能发布的视频时用:去掉口癖、长停顿、录废重来的部分和离题的话,在几遍重录里挑一遍,收紧句间停顿,把最有力的原话挪到开头,再按需要加放大强调、B-roll、竖屏取景和配乐闪避。需要视频的转写。只想从长视频里挑几段短视频时用切短视频。

用户录了一段对着镜头说的话,里面有口癖、有停顿、有说错重来的几遍。他要的是一条能直接发的视频:话顺、不拖、开头留得住人,而且他说过的意思一句没变。观众感觉不到剪过,才算剪好了。

最容易剪坏的样子有两种。一种是边听边剪:读到一句觉得多余就删,剪到后面发现它是后文的前提,只好回头补。另一种是剪得太狠:每次换气都剪掉,停顿全压到最短,听起来像机器在说话;或者为了开头抓人把一句话从中间截出来,意思变了。

口播视频里决定剪点的是**话**,不是画面:先让话顺下来,再处理画面。顺序:

1. 转写。没有转写,下面每一步都是瞎猜。没有 kind 为 speech 的文档时先转写,告诉用户转写在进行。
2. 按论点列出留 / 删清单,一次剪完(第 2 节)。
3. 收紧句间停顿(第 3 节)。
4. 定开头(第 4 节)。
5. **剪口定下之后**才加画面:放大强调、B-roll、文字;然后是取景、竖屏短视频的摆法与节奏、声音。做法在 [口播的画面与声音](talking-head-cut/references/picture-and-sound.md),要做这些时打开对应的页读;要插一段网上找来的画面或当事人原声(配旁白、压卡片),读 [`references/craft/clip-montage.md`](clip-montage.md)。
6. 验收(第 5 节)。

画面元素会跟着剪口走,但先剪话、后加画面仍然更省事:话没定下来之前,定不了放大落在哪一句、B-roll 给几秒。

## 1. 时间与剪法

这里有两个时钟,搞混了剪点就落错地方:

- 转写(`baocut documents read` 读 speech 文档)里词的 start、end 是素材自己的时钟,按 timescale 换成秒:秒 = 刻度 ÷ timescale。addCuts、proposeCuts 用的就是素材时钟上的秒。
- splitItem、moveItem、removeRange、导出的范围和 `baocut videos frames` 的 `at` 用时间线上的秒。素材上的时刻 t 在时间线上的位置 = 那个片段的 startSeconds +(t − sourceInSeconds)(`baocut videos inspect` 的片段里有这两个值;变过速的片段再除以速率)。不要凭感觉换算;拿不准就重新 `baocut videos inspect` 读片段。
- 口播的删减用剪口(addCuts):可以恢复(restoreCut),剪口集合是视频里 kind 为 cut-set 的文档。原文件不动。
- 转写跟不上的地方(没有转写的录屏讲解、大段不说话的演示)用 `baocut assets dead-air` 找空档,结果同样是素材时钟上的秒,核对后交给 addCuts。有转写的讲话仍按下面的留 / 删清单与 proposeCuts。

## 2. 留 / 删清单

读全文,不要边听边一句一句剪:

- **按论点列**:这段录音讲了哪几个论点,每个论点留哪几句。写成留 / 删清单(句子、留或删、理由),一次剪完;边读边剪,读到后面常发现前面删掉的一句是后文的前提。
- **该删的**:开拍前的准备、说错重来的那几遍、录完到停机之间的杂音、与主线无关的离题话。
- **口癖与长停顿**:用 `baocut edits apply` 的 proposeCuts(detect 里的 fillers 与 pauses)生成剪辑提案,用 `baocut documents read` 读提案,逐条看过,再用 acceptCutSuggestions 只接受该删的那些;要改区间的直接 addCuts 并把建议 ID 写进 ref。提案不检测重复的句子:录废重来、说了两遍的,先用 `baocut speech retakes` 列出几遍(装了语义模型时换了说法的重录也能找到,没装时只找文字相同的,`effectiveMode` 写明),按下一条挑哪遍,再按要删那一遍的 wordIds 在转写里查到素材时间用 addCuts 剪;`differ` 为 true 的几遍数字、否定词或名字不同,先弄清哪遍对,拿不准就问用户。它找不到的(隔得远、说法差得多)照常自己读转写找。
- **几遍重录挑哪遍**:看完整(意思说全了)、自然(不像背的)、节奏(不拖不赶)。后一遍通常更顺,但这不是规则;拿不准就都留着,请用户听了再定。
- **默认保持原来的顺序**。调序会改变论证;除了第 4 节的开头,其他任何挪动都先问用户。
- 按整句删:剪口的边界落在词与词之间的空隙里,取整句第一个词的开头到最后一个词的结尾,不切进词里。
- **清单定下后作为一笔修改提交**:每句要删的一个剪口,放进同一次 `baocut edits apply`。整笔是一步撤销:用户说「不要那一批」时,一次 `baocut edits undo` 就退回去。

## 3. 句间停顿

停顿的长短是视频的语气:压得太短像赶,留得太长像拖。

- 起点(不是规则,要听着调):句与句之间约 0.2 秒;节奏快的宣传类口播可以到 0.1–0.15 秒,讲道理或偏思考的 0.3–0.5 秒。语速慢、句子长的语言和说话人相应放宽。
- 用 proposeCuts 的 detect 表达:pauses 打开,compressTo 设成上面的目标,minPause、maxGap 不给时用默认值。先读提案看会动多少处,再接受。整片用同一个数之后,回头看转折、包袱和提问之后的地方:那里的停顿是内容,压短就丢了。
- **留住换气**:把每次换气都剪掉听起来像机器。剪的是空等,不是呼吸。
- **词要完整**:剪点落在词之间的空隙,不吃掉第一个音节,也不吃掉结尾的尾音。转写的词边界很紧时,在剪点留一点余量。
- 你听不到成片。停顿长短可以从剪口和片段读出来,但**顺不顺要人耳听**:用 `baocut export` 导出一小段(range 是时间线上的秒)给用户听,并在报告里说明哪些只是量出来的。

## 4. 开头

头几秒决定观众留不留。

- 头几秒要有一句让人留下来的话。全片最有力的一句**原话**可以挪到开头:用 splitItem 在这句话的首尾(时间线上的秒)切开,再用一次 moveItems 把它挪到最前、把原来在它前面的片段顺次往后挪(同一轨道上的片段不能重叠)。
- 挪的是原话;不重新配音,不拼半句。它原本带着的限定语一起带走(例如「在这种情况下」「对新手来说」,任何语言都一样);拿掉限定语会改变意思时,就不挪。

  对比一下(只是示意):原话是「对新手来说,这个方法第一周就能见效」。挪「这个方法第一周就能见效」到开头,意思从「对新手」变成了「对所有人」,不能这么挪;要挪就整句挪。
- 想清楚这句话在片子里出现一次还是两次,并告诉用户:挪动是**调序**,原来的位置就没有这句了;如果是预告、原位置也要保留,就不挪,而是在开头再放一份同一段素材(addItem 放同一个素材,再用 trimItem 裁到这句话的范围),并给它腾出位置。
- 挪片段时别的轨道上的东西不一定跟着走。所以先定开头,再加放大和文字;如果已经加了,挪完之后 `baocut videos inspect` 重新读,逐个核对。
- 没有能单独成立的原话时什么都不挪;按原来的顺序开始,把开场寒暄剪掉。
- 开头那句最好让观众带着一个问题看下去,片子在结束前答上它;片子里答不上的问题不放在开头。合适时结尾回到开头的那个画面,首尾呼应。

## 5. 验收

- 读回:`baocut videos inspect` 看片段与时长,`baocut documents read` 看剪口集合,对照留 / 删清单逐项核对:该删的删了,该留的还在。
- 要看画面时用 `baocut videos frames` 在时间线上的时刻取帧:它给的是那个时刻的素材画面,放大、字幕和叠加的元素不在里面;要核对合成后的效果,导出一小段成片给用户看。
- 剪过之后译文会过期:有译文时按翻译字幕的做法,只重译变了的句子。
- 报告分三栏写:**量出来的**(时长、剪口数、停顿改成了多少)、**看过的**(取了帧的写看了哪几处、看到什么;没看的如实写没看)、**要人听的**(剪点顺不顺、配乐音量)。开头那句挪没挪、原位置怎么处理,单独一句说明。

## 6. 要避免的

- 不要边听边剪,不要分几笔零散地剪。
- 不要把每次换气都剪掉,不要把转折、包袱后面的停顿压掉。
- 不要切进词里;不要为了开头拼半句、拿掉限定语。
- 不要不问就调序(开头那一句除外);不要替用户在几遍重录里硬选。
- 不要把素材时钟和时间线时钟混用。
- 不要把没听过的说成「顺」,把没看过的说成「没问题」。

## 同目录的文件

在 `references/craft/talking-head-cut/` 下,用到时再打开;代码与样例原样复制,按正文说的用法取用。

- [口播的画面与声音](talking-head-cut/references/picture-and-sound.md)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall