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/video-chapters.md

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

# 分章节

> 用户要给视频分章节、加章节或时间轴目录、按作者给的时间大纲生成章节,或调整章节的粗细时用:在自然的话题转换处分章,每章一个标题和一句话摘要,写进视频的章节。需要视频的转写。不用于只想在简介里列出已有章节(用起标题与写简介),也不用于给文章分节。

章节是给观众跳着看用的:拖进度条的人看一眼章节名,就知道要去哪一段;看过的人想回头找某个地方,也靠它。所以章节的标题要说清这一段讲什么,起点要落在话题真正开始的地方,一个章节对应一个话题。

最容易做坏的样子有两种。一种是按时间平均切:每五分钟一章,起点落在一句话的中间,标题是「第一部分」「继续讨论」,观众看了等于没看。另一种是标题太像总结:一章一句长话,章节列表反而读不动。章节名是路标,不是摘要;摘要另有一句话的位置。

## 1. 取材料

1. 用 `baocut videos inspect` 看视频:时长、已有的章节(chapters)、文档。没有转写(kind 为 speech 的文档)时先转写,告诉用户转写在进行。从链接导入的素材另有 `assets[].source`:`chapters` 是作者的章节(平台给的结构化章节,或从简介里的时间戳大纲解析出来的),没有时是 `[]`;`description` 是截断的简介。
2. 带时间码的文稿:`baocut export`(kind `transcript`、format `md`、timestamps `true`;有几份文稿时按它列出的候选用 documentId 指定),`baocut jobs inspect` 等到 completed,读 outputs 里的文件。它按段落给出剪辑后时间线上的时间,章节的时间就取段落开头的这个时间码,不要自己估算。
3. 视频已经有章节时,先问用户是要替换、调整还是保留;用户只说「加章节」而已有的章节是新的,不要覆盖。

## 2. 有作者章节或用户给了大纲时

作者自己分过的章节通常比你分的更贴近他的意图,照它来,不自己分,也不手工对时间。来源素材自带章节(`assets[].source.chapters` 不为空),或用户贴来一份带时间的大纲(`0:00 开场`、`1:02:03 问答` 这类)时,用 `baocut chapters adopt`:

- 作者章节:给 `video`(素材不止一个时给 `asset`,有几份转写时给 `document`)。用户贴的大纲:给 `outline`,可以是 `[{ at, title }]`,也可以是贴来的原文。不确定时先带 `dryRun` 看回执,再正式写。
- 它把每一条吸到文稿里最近的段落或句子起点(段落优先,其次句子、字幕条、词),清洗标题后整份写进视频的章节(替换已有的;已有章节要先按第 1 步问过用户)。
- 读回执的 `sourceChapters`:`entries` 共几条;`matched` 吸到了起点;`ambiguous` 附近有几个起点、取了离作者时间最近的那个(同样近取靠后的);`snapped` 时间挪动过;`unanchored` 对不上、保留了原来的时间。`rows` 逐条给标题、写入的时间 `at`、原来的时间 `sourceAt` 与状态;带 `offTimeline` 的条目对应的地方不在时间线上(比如剪掉了)。交付时说清对上几条,把 ambiguous、unanchored、offTimeline 的条目逐条列给用户:这些是他要自己看一眼的地方。
- 带 `untitled: true` 的章节(作者章节或回执的 `rows` 里):平台只给了分界,`Untitled Chapter N` 是下载工具填的占位名,不是作者的标题。读这一章到下一章之间的转写给它起标题(语言照第 4 步),连同其余各章用 `outline`(`[{ at: sourceAt, title }]`)再调用。不带 `dryRun` 直接采用会返回 `UNTITLED_SOURCE_CHAPTERS`,照错误里的 `rows` 补上标题即可。
- 返回 `NO_SOURCE_CHAPTERS`:素材没有作者章节,按下面的做法自己分。返回 `ASSET_NOT_PLACED`:素材不在时间线上,先放上去。
- 用户要你自己写的章节,或想要和作者大纲不同的粗细时,才走下面的做法自己分,作者的大纲当参考:转写和它吻合的地方沿用它的分界和标题(保留作者的措辞,语言照第 4 步),只在转写明显不同的地方增、并、删章;大纲的时间只是大致的,章节的起点仍取文稿里段落的时间码。

## 3. 分几章

按粗细定一个大致的目标章数,不硬凑:

| 粗细 | 大约多长一章 |
| --- | --- |
| 粗 | 约 10 分钟 |
| 适中(默认) | 约 5 分钟 |
| 细 | 约 2.5 分钟 |

目标章数 = 时长 ÷ 每章时长,取整;至少 2 章,最多 20 章,超过一小时的录音上限按每小时 20 章放大。有作者大纲当参考、用户又没指定粗细时,目标章数取大纲的条数。话题真正的转换比这个少时,少分几章没关系:目标章数是个大概,不是指标。

## 4. 怎么分

先用 `baocut speech topic-boundaries`(`video`;有几份转写时给 `documentId`)找话题转折。它按意思比较前后几段讲话,给出话题明显变了的地方。它默认最多给 24 章的候选;超过一小时的录音按第 3 步的上限传 `maxChapters`(比目标章数多留几章的余地,最多 200),用户要的章节很短时把 `minChapterSec` 调小:

- `mode` 为 `topic`:章节只落在 `first`(第一段的起点)与 `candidates[].at` 上,不在别处新开;`before` / `after` 是转折前后的原文,对照文稿确认这里确实换了话题。候选比目标章数多时按第 3 步的粗细合并:先合掉 `depth` 明显小的(多半是小插曲或举例),属于同一个更大话题的相邻几处合成一章。候选带 `visualShift`(这部视频建了画面索引)时,`depth` 相近、拿不准留哪处时,留画面也换了的(`visualShift` 明显大:换场景、换幻灯片、换演示对象);它只作佐证,不单凭它新开章节。候选的时间已经落在段落或句子的开头,直接用。
- `mode` 为 `model`:没有候选(`reason` 给原因:没装语义模型、文稿太短,或为 null 时没找到明显的转折),照下面的做法读文稿自己找。
- 用户要的粗细比候选更细(候选比目标章数少很多)时,可以在候选之间按文稿再分,但起点仍取文稿里段落的时间码,并在交付时说明哪几章是你另分的。

动手前先通读文稿(有候选时重点读候选前后),列出话题在哪里转换:说话人换了题目、从问题转到做法、从一个案例转到下一个。章节就落在这些地方。

- 每章从一段话的开头开始;时间取文稿里那一段的时间码。不编造时间,不把章节放在一句话的中间。
- 第一章通常从 0 秒开始。
- 每章一个标题和一句话的摘要(不超过约 20 个词,说清这一章讨论什么)。标题是观众扫一眼就懂的路标,用这一段的内容本身,不用「第一部分」「继续」「其他」这类说了等于没说的词;摘要补一句这一章具体讲到什么。
- 标题和摘要不能为空,彼此不同,风格一致。语言默认跟转写;用户要别的语言,或调用它的流程写明用观众的语言(音频转视频译成观众的语言时,画面上的章节跟着译文字幕走)时,用那种语言。作者的章节也照此:先带 `dryRun` 看回执的 `rows`,再用 `outline`(`[{ at: sourceAt, title }]`)写入换了语言的标题,和第 2 节补无标题的章节一样。
- 录音很长时分几部分读:每部分先列出话题单元(各自的起点段落、标题和摘要),再把它们合成最终的章节。单元比目标章数多时,把属于同一个更大话题的相邻单元合成一章,起点取合并后第一个单元的起点,标题和摘要覆盖合并后的整段;分部分的接缝处尤其要合并,那里一个话题常被人为切开。不是第一部分时,开头可能接着上一部分的话题,不必在这一部分的第一段强加一章。

对比一下(只是示意):

不好:`05:00 第二部分` / `10:00 继续讨论模型` / `15:00 其他`

好:`04:37 为什么蒸馏后效果掉得厉害` / `11:02 混合方案怎么配` / `16:48 上线后的三个坑`

后一种每个起点都落在话题开始的那一段,标题看一眼就知道要不要跳过去。

## 5. 写进视频

用 `baocut edits apply` 的 setChapters 一次写入整份章节列表(at 是上面取到的秒数,按时间严格递增;title、summary 照写)。只改一两章时用 upsertChapter 或 removeChapter。章节固定在时间线的时刻上:剪口播(addCuts、接受剪辑建议、恢复剪口)会让章节跟着内容走,别的剪辑(移动、删除片段、波纹删除)不会,这类剪辑改了时长时提醒用户章节可能要重新对一遍。

## 6. 要避免的

- 不要按时间平均切,不要把起点放在一句话中间,不要自己估算时间。
- 标题不要写成「第一部分」「继续」「其他」,也不要写成一整句摘要。
- 素材有作者章节时不要自己重分;用户已有章节时不要不问就覆盖。
- 不要硬凑目标章数。

## 7. 交付

- 列出写进去的章节:时间(时:分:秒,不到一小时写分:秒)、标题、摘要。
- 说明用的是作者的大纲还是自己分的,粗细与章数;自己分时说明边界是否来自话题转折候选(`baocut speech topic-boundaries` 的 `mode`),另分的几章点出来。用了作者大纲时报吸附统计:共几条、对上几条;ambiguous、unanchored、offTimeline 的条目逐条列出。
- 分章失败不影响转写和其他结果:如实说明原因,最多重试一次,不反复重试。
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