- name
SKILL.md
Файл навыка остаётся в репозитории издателя.
Вставьте скопированную команду в терминал. Она установит этот SKILL.md в выбранного агента.
npx skills add JimLiu/baocut --skill production-scripts -a cursor -yВставьте скопированную команду в терминал. Она установит этот SKILL.md в выбранного агента.
npx skills add JimLiu/baocut --skill production-scripts -a claude-code -yВставьте скопированную команду в терминал. Она установит этот SKILL.md в выбранного агента.
npx skills add JimLiu/baocut --skill production-scripts -a codex -yВставьте скопированную команду в терминал. Она установит этот SKILL.md в выбранного агента.
npx skills add JimLiu/baocut --skill production-scripts -a grok -yОтправьте скопированное сообщение в чат Grok Bot. Бот загрузит этот SKILL.md с GitHub и добавит его к навыкам, общим для всех ваших ботов.
Install this skill: https://github.com/JimLiu/baocut/tree/HEAD/skills/baocut/built-in-skills/production-scriptsОт издателя
一条旁白片做到后半程,重复的活都长一个样:每段旁白合成一次、转写拿字时间、把这一段的画面打成代码包、按整帧排到时间线上、按稿子建字幕、把实拍片段剪好放上去、改一段时把后面的东西一起挪。本 skill 的 scripts/ 把这些写成了脚本,只调 baocut CLI(配音、转写、导入、修改都走它),不碰 API Key;内容相关的设定都在一份配置里,有命令行环境时拷进工程就能用。
它是工具,不是形态。 脚本假定的只有一件事:旁白按段配,每段配一个代码包,首尾相接排在一条视觉轨与一条音频轨上;代码包可以是整段的画面(动画打底,实拍叠在上面),也可以是透明的叠层(实拍铺在下面一条轨上当底,包里只画卡片、标注)。这期片子的底是什么、讲法是什么,由组合入口(用 skills_read 读 video-production)与相应的手艺页定;定下的形态和脚本不合(整片一条旁白不分段、画面是一条长录屏、你有更顺手的做法)时,照 video-production 用 BaoCut 的工具或 CLI 自己做,不为了用脚本把片子做成脚本的形状。没有命令行环境,或者段落、实拍片段与卡片都定好了只差摆上时间线时,也不用脚本:edits_assemble 按一份计划一次放好,重跑只动变了的;计划的格式用 skills_read 读 baocut-catalog-editing「一次放好制作计划」。
目录:1 计划文件 2 按顺序跑 3 改一段 4 量一遍 5 自检
脚本读的东西合起来就是这部片子的制作计划,先把它写全,再跑脚本:
计划定下后,剩下的就是把它摆上时间线:assemble.mjs 摆旁白与代码包,captions.mjs 建字幕,overlay.mjs 摆实拍、来源标签、原声字幕与水印(都写在时间线上,不剪文件、不烧字)。改计划只重做受影响的段(第 3 节)。摆的这一步也可以交给 Runtime:把段落(代码包、旁白、对齐结果)、实拍片段、卡片与水印改写成 edits_assemble 的计划,一次放好,重跑只动变了的;来源标签与原声的双语字幕仍由 overlay.mjs 放。
scripts/ 整个拷进工程(例如 <工程>/tools/):能直接读到文件时拷目录,读不到时用 skills_read 读本 skill 的 scripts/ 下每个文件原样写进去。脚本都 import 同目录的 lib.mjs,要拷全;*.example.json 是配置样例。依赖 Node 18 以上与 baocut CLI;切段转写、留白压停顿、量原声响度、拉平老录音、拼小屏样张要本机有 ffmpeg。
要画代码场景时,本 skill 的 scene-kit/ 可以拷进工程的 shared/ 当起点(读不到文件时用 skills_read 读本 skill 的 scene-kit/ 下的文件)。它在浏览器里跑,不和 scripts/ 放在一起。scene-kit.js 只有机制、没有配色:颜色与字体由场景调用 K.style() 给,拷过去照这期的需要改、删掉不用的;它读 build.mjs、quotes.mjs、sources.mjs 写进 window.TIMING 的数据(lines[].chars、clips、words、credits、ambient),另有相机、对数缩放、阻尼弹簧与环境时钟(K.cam、K.lens、K.zlerp、K.spring、K.ambient),默认手感见 video-production 代码场景细则第 4.1 节。geo110.js 是 Natural Earth 1:110m 的陆地轮廓(公有领域)。scripts/explainer.example.json 在工程根目录写配置(脚本从当前目录往上找它,也可以 --config <文件>),有实拍时照 scripts/clips.example.json 写 clips.json。每一步的参数、配置字段、烘焙走指令还是截图、WebGL 的段、产物被清掉怎么办,以及还没建视频时的备选预览页(preview.mjs):用 skills_read 读本 skill 的 references/pipeline.md。
改了稿子或画面只重做那几段:改旁白是 voice.mjs <id> → align.mjs <id> --fresh →(有留白时)gaps.mjs <id> → build.mjs <id>;只改画面是 build.mjs <id>;插一段是加进 order 与稿子后照常做这一段;给已有的视频补片头时配置写 prepend,第一次排时间线时正片与章节一起后移。然后 assemble.mjs --dry 看它打算怎么挪:帧数变了带 replace.ripple 换包,后面各轨一起挪;插入的段先 insertRange 腾位置;旁白换了先删旧的再放新的;之后 captions.mjs 重建变过的段的字幕,overlay.mjs --check 核对实拍位置;有主播时再跑 host.mjs,时长或口型变了的贴纸重放。细则在 references/pipeline.md 第 4 节。
node tools/coverage.mjs(在工程里,自动读配置判断哪些代码包是透明叠层;也可以 node coverage.mjs <videoId> 不带配置,透明包用 --alpha 告诉它;--from <videos inspect --limit 1000 --json 存下的文件> 不连 Runtime;--json 出机器可读结果)。它报每一帧最上面铺满的是实拍、代码画面还是空的各占多少、画中画占多少,镜头数与中位长度、最长一个镜头、最长一段没有实拍,实拍片段数、带原声的几段、同一素材用了几次,再按分钟列一条实拍占比。它只报数不判对错:对不对看这期定的形态要的是什么(实拍打底的片子通常实拍八九成、中位镜头 3–6 秒;代码画面打底的讲解片代码画面八成以上是设计使然)。
bake.renderer:该走指令的包回退成 browser-pixels 时按 video-production 代码场景细则第 2.1 节改好再烘其余各段;烘全片前先算时间与磁盘。videos inspect 核对各段首尾相接、总长等于各段帧数之和;assemble.mjs --verify 补后台烘焙的结果并核对。frames.mjs --cuts 看一遍每段的首尾帧(第 0 帧是不是封面、段与段相接处有没有空帧),frames.mjs --still 报出的每一处对着旁白看过。有命令行环境、旁白按段配、画面按段上时间线的片子(讲解、解说混剪、旁白片、歌词视频……)要跑脚本时用:配音、对齐字时间、把场景代码打成代码包、按段摆上时间线并处理变长变短的波纹、按稿子建字幕、剪实拍与水印叠上去或垫在底下、量画面占比。脚本是一条省事的路,不规定片子的形态;形态和它不合时用 baocut CLI 自己写。只是加一段动效图形或配一句旁白时不用。
---name: production-scriptsdescription: 有命令行环境、旁白按段配、画面按段上时间线的片子(讲解、解说混剪、旁白片、歌词视频……)要跑脚本时用:配音、对齐字时间、把场景代码打成代码包、按段摆上时间线并处理变长变短的波纹、按稿子建字幕、剪实拍与水印叠上去或垫在底下、量画面占比。脚本是一条省事的路,不规定片子的形态;形态和它不合时用 baocut CLI 自己写。只是加一段动效图形或配一句旁白时不用…---# skills/baocut/built-in-skills/production-scripts/SKILL.mdFAQ
Скачайте skills/baocut/built-in-skills/production-scripts/SKILL.md у издателя или скопируйте путь и откройте репозиторий. PlugMCP только показывает навык в каталоге и не хранит файл.
Издатель хранит его в https://github.com/JimLiu/baocut.
Claude, Cursor, Codex и Grok Build могут читать SKILL.md, который вы добавляете из репозитория издателя. Grok Bot устанавливает его, когда вы отправляете в чат ссылку на папку навыка на GitHub.
| 实拍与水印 | overlay.mjs --dry,再 --place | 每个原片链接导入一次,每个镜头一个视频片段(原片区间、裁剪、取景、原声音量与淡变都是片段字段,响度按实测换成音量),转场是时间线转场;来源标签是标签轨上的文字片段,原声字幕是单独样式的双语字幕层(带说话人);footage.layer 为 under 时实拍轨挪到代码包轨下面当底 |
| 主播出镜 | host.mjs --dry,再 host.mjs | 配置了 host 时:按各段的逐字时间与配音算口型,连着出镜的几段拼成一条动作轨、放一个角色贴纸,不出镜的段(host.skip)前后各自成段;口型算法在 virtual-host 的 scripts/,拷到 tools/virtual-host/。重跑只动变了的贴纸 |
| 看合成后的画面 | frames.mjs <秒或段 …>、--cuts、--every <秒>;--still | 取帧只有素材画面,这里走导出预览:贴纸、文字、字幕、主播与还没烘焙的代码画面都在,几个时刻拼成一张图;--cuts 看每段的第一帧与最后一帧;--still 报出画面连续几秒不动的地方,对着旁白看是停下来让人读、还是该动却空着 |
| 给用户看 | baocut web review --video <videoId> | 在宿主的浏览器面板里打开链接、整条给用户(见 baocut 说明书 web 页「请用户审片」);用户说可以之前不烘焙、不导出,用户说过自检后直接导出时,照这期手艺页的自检清单查过再往下做,链接照给;改了哪段照第 3 节重做,再 assemble.mjs --live,请用户刷新 |
| 定稿烘焙 | assemble.mjs --bake ops,再 assemble.mjs(不带 --live) | 用户说可以之后(用户要自检后直接导出的,自检过之后):live 的段原地换成烘焙过的包。先 --bake ops 只走指令(几秒一段),画不出的段列出原因、视频不动;改不了的再不带它退回截图。之后再导出 |
| 交付字幕 | srt.mjs --dry,再 srt.mjs | 片头旁白、正片、原声片段的字幕是几份文档,导出一次只取一份:逐份导出,按语言合并成一个 SRT |