- name
SKILL.md
Tệp skill vẫn nằm trong kho mã của nhà phát hành.
Dán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add JimLiu/baocut --skill history-video -a cursor -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add JimLiu/baocut --skill history-video -a claude-code -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add JimLiu/baocut --skill history-video -a codex -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add JimLiu/baocut --skill history-video -a grok -yGửi tin nhắn đã sao chép trong cuộc trò chuyện Grok Bot. Bot sẽ lấy tệp SKILL.md này từ GitHub và thêm vào bộ skill mà mọi Bot của bạn dùng chung.
Install this skill: https://github.com/JimLiu/baocut/tree/HEAD/skills/baocut/built-in-skills/history-videoTừ nhà phát hành
一段几十年前的录音直接放,多数观众一分钟就走:不知道说话的是谁、当时发生了什么、这番话为什么要紧。历史视频是两部分:前面几分钟的背景,让观众很快弄明白人物、处境和这次讲话的分量;后面是完整的原声,配原文与译文字幕、分好章节。背景不是一堂课,也不是一页页幻灯片:它要让观众在最短的时间里看见那个处境,然后带着它去听原声。
本 skill 给判断、手法与工具,不给模板。同一批材料里,这一期是 1920 年代只有录音的演讲,下一期是有新闻片的战时讲话,再下一期是一位作家的访谈:讲法、画面的主干、色板与版式都该不一样。系列感交给固定的东西(署名、水印、音色、片头的位置、交付物,写在 BRAND.md),不交给同一套版式。
references/sources.md)。references/forms.md)。用户只给一句话(「把某某那次演讲做成历史视频」)时,先查后问,写一页简报请用户确认再动手(第 8 节,细则 references/brief.md)。
explainer-video)或解说混剪(clip-montage)。subtitle-workflow 与 baocut 说明书 workflows 页的「音频做成视频」做。本 skill 叠在它之上:正片照那条路做,背景照这里做。能查到、能推断的不问,缺的合成一轮问:
BRAND.md、全局的 BRAND.md 的先后来,那里写了的不再问,没写的不发明。会话里自动带着;命令行面用 library_list(library 为 brand)找品牌文件再读。品牌库是空的时,在交付目录所在的仓库或用户给的目录里找 BRAND.md,找不到就问;不拿本机的或缺省的音色顶替品牌规定的音色。BRAND.md 的规定;没有规定时用中性、可核实的写法(人名、公历日期、机构的通行简称),拿不准就问,不替用户选立场。动手写稿之前先把材料找齐,写进工作目录的 research.md 与 sources.json:
translate-subtitles),交付时注明是 AI 辅助、有没有人工校对。找哪里、怎么判断许可、sources.json 怎么写:用 skills_read 读本 skill 的 references/sources.md。
这一节最要紧。
video-production 第 2 节写一段风格说明(色板的色值、字体、质感、动效节奏),这一期的所有场景照它。不沿用上一期的色板与版式。video-production 画面设计细则的第 4.1–4.3 节(用 skills_read 读 video-production,再按它「画面设计」一条读);风格说明里写明有几级字(每级的像素、字重、颜色)、每个颜色给谁用,再写场景与正片版面。这类片子常见的毛病:章节摘要、图说当成小字,排成 30 px 上下的灰字;全片一族楷体、一种强调色,年份、地名、标签与字幕分不出轻重;配图框、馆藏号、许可一直占着画面,要读的字反而挤在一边。年代感从纸色、字形与质感来,不靠把字缩小、调淡。反过来,好看和看得清一样要紧:字放大了,留白和版面就跟着重新设计。不要每样都放大、塞满一屏,也不要删到只剩一条字幕带。各种表现手法适合什么、怎么在代码画面里做、哪些会让烘焙退回逐帧截图:用 skills_read 读本 skill 的 references/forms.md。
BRAND.md;没有时按 narration 选,全片一个音色。语速与字数按 narration 第 1 节估。正片在前,片头在后:正片定了,片头才知道交到哪里。
baocut export <旧版> --kind portable --format baocut --dir <目录> 打成便携包(素材全在包里,旧版的素材有多大,包就有多大),再用 baocut videos import-package <包> --name <新名> 打开成新视频。没有字幕视频时照 subtitle-workflow 做:转写、按讲稿校对、翻译、双语字幕、分章(video-chapters)。skills_read 读本 skill 的 references/old-recordings.md。production-scripts 的脚本(用 skills_read 读 production-scripts):配置里写 prepend(带一章 chapter,例如「背景」),片头按段配音、对齐、写场景代码打包;assemble.mjs 在第 0 帧腾出整个片头,正片的画面、声音、字幕与章节一起后移(--dry 先打印这一步)。两件事要先想好:正片里写成文字的章节序号(01)因为多了一章会都加一,要保留原序号就换成每章一段的静态文字;片头的原声引用按响度量过,正片录音沿用旧音量,两边差几个分贝时调正片录音片段的音量,切过去才不会突然变小;调到上限还差,就照上一条修录音。正片的角落水印从正片起点开始,片头上没有:BRAND.md 要角标时给片头另放一条,颜色按片头的底色选;片头最后一拍换了底色,就分成两段,各用各的颜色。字幕不逐字高亮,用 KTV:念到哪里,哪里的颜色变深,颜色跟这期配色走。片头旁白字幕在配置的 captions.style 里给 fontColor(没念到)与 sungColor(念过),正片字幕用 setCaptionStyle 改:style 写 textMotion: {"karaoke": {"color": …}},颜色取正片底色上的强调色,当前词跟着换成 none(写法见 motion-graphics 的 audio-backdrop 参考第 4 节「字幕的念到效果」),两边一个手法。clips.json 里只有声音的片段:asset 写正片录音的素材 ID,after 把它放在段尾、hold 留出它的长度,words: true 与 said(原话)、text(译文);quotes.mjs 对出逐词时间,build.mjs 写进这一段的 TIMING.clips,场景照它点亮每个词。clips.json 放成铺满或画中画,画中画框的位置在 TIMING.clips[].box,场景在框下画底板、框旁写说明。sources.json 一份;sources.mjs 查漏、写 sources.csv;画面上的出处行从 TIMING.credits 取,不在场景里另写一遍。BRAND.md,或过不了第 4 节「看得清、分得出轻重,也要好看」时(先把旧版抽几帧缩小看一遍,见 references/self-check.md 第 1 节),在正片的时间线上重新排;排什么、怎么排,按这期的材料与风格说明定,做法见 baocut 说明书 workflows 页的「音频做成视频」。四件事常出错:
assemble.mjs --live 摆上去、正片排好以后,先自己照自检清单的第 1 节看一遍(用 skills_read 读本 skill 的 references/self-check.md),改掉看到的问题,再用 baocut web review --video <videoId> 把审片页开在宿主的浏览器里(本机装的字体审片页也能用,和导出一致),整条链接交给用户,说清请用户重点看哪里。baocut --help 把 web 列在本机管理命令下,但 web review 只开审片页、不改设置,照常跑。用户说可以之前不烘焙、不导出;改哪段只重做哪段,再请用户刷新。assemble.mjs --bake ops 试:指令烘焙几秒一段;画不出的段列出来,按代码场景细则改,改不了的(照片滤镜多的)不带 --bake ops 退回逐帧截图,1080p 每秒两三帧,在进度更新里告诉用户要等多久(不等回复)。--purpose deliverable,带 --loudness(缺省 -16 LUFS;同一系列各期用同一个值)。几十分钟、带声波这类每帧现画的层时,导出每秒只有二十帧上下,五十分钟的片子要一个多小时:放在后台跑,先估好时间写进报告。导出后照自检清单第 3 节抽帧、量响度、查字幕。成片写在 --dir 给的目录里;那块盘空间不够时导出以 EXPORT_INSUFFICIENT_SPACE 拒绝,就导到空间够的盘上,再拷进交付目录。字幕导出成片语言(片头旁白加正片译文)与原话语言两份:片头每段旁白各是一份字幕文档,用 production-scripts 的 srt.mjs 逐份导出、按语言合并。一行的宽度照旧版字幕给 --max-chars。assets prune 列出,确认都是自己换下来的再用 removeAssets 删掉记录;用户导入的素材不动。BRAND.md 有清单就照它):成片、字幕文件、sources.csv、说明(原声出处、字幕与译文怎么来的、AI 用在哪里)、讲稿原文、译稿、片头解说稿、发布文案(titles-and-description,章节时间按成片的章节)。讲稿原文以录音为准:用校对过的正片字幕按句拼、按章分段,附一张存疑表,列出拿不准的字词、在成片的哪里、猜的是什么。片头解说稿里的画面备注(@ 行)按场景代码或导出的帧重写:做的过程中画面一改再改,稿子里的备注常常没跟上。用户常常只说一句话。这时先查:录音在哪、是哪一次讲话、人物与时代的基本事实、能找到哪些画面;再把第 2 节的缺项一轮问齐;然后写一页简报给用户确认:材料清单(带许可)、片头时长与分段、选定的主干与一段风格说明、钩子用哪句原声、出处与许可的风险、交付物。简报就是这期的提示词:用户改一改就能交给任何一个会话去做,下一期照同样的方法另写一份,不复制上一期的风格。
问什么、简报写哪些项、几种材料情况下的简报示例:用 skills_read 读本 skill 的 references/brief.md。
把历史录音、演讲、访谈、广播或档案影像做成观众看得懂的成片:先用几分钟讲清这个人、那个时代、这次讲话为什么要紧,再放完整的原声(原文与译文字幕、分章节)。讲法与画面由手上的材料定(只有录音还是有影像、照片多少、单语还是双语),不套模板;当时的照片、新闻片、报刊、地图与当事人的原声优先,生成的图只画没有真人的示意。只给录音配字幕、排版面走 subtitle-workflow;讲一个历史话题、没有一段
---name: history-videodescription: 把历史录音、演讲、访谈、广播或档案影像做成观众看得懂的成片:先用几分钟讲清这个人、那个时代、这次讲话为什么要紧,再放完整的原声(原文与译文字幕、分章节)。讲法与画面由手上的材料定(只有录音还是有影像、照片多少、单语还是双语),不套模板;当时的照片、新闻片、报刊、地图与当事人的原声优先,生成的图只画没有真人的示意。只给录音配字幕、排版面走 subtitle-workflow;讲一个历史话题、没有一…---# skills/baocut/built-in-skills/history-video/SKILL.mdTổng quan
把历史录音、演讲、访谈、广播或档案影像做成观众看得懂的成片:先用几分钟讲清这个人、那个时代、这次讲话为什么要紧,再放完整的原声(原文与译文字幕、分章节)。讲法与画面由手上的材料定(只有录音还是有影像、照片多少、单语还是双语),不套模板;当时的照片、新闻片、报刊、地图与当事人的原声优先,生成的图只画没有真人的示意。只给录音配字幕、排版面走 subtitle-workflow;讲一个历史话题、没有一段要完整放的原声时走 explainer-video 或 clip-montage。
Câu hỏi thường gặp
Tải skills/baocut/built-in-skills/history-video/SKILL.md từ nhà phát hành, hoặc sao chép đường dẫn và mở kho mã. PlugMCP chỉ liệt kê skill và không lưu trữ tệp này.
Nhà phát hành duy trì nó tại https://github.com/JimLiu/baocut.
Claude, Cursor, Codex và Grok Build có thể đọc tệp SKILL.md mà bạn thêm từ kho mã của nhà phát hành. Grok Bot cài đặt skill khi bạn gửi liên kết thư mục GitHub của skill trong cuộc trò chuyện.
setCaptionStyle 给正片字幕定好,再跑 captions.mjs。正片字幕还没有自己的样式文档时,captions.mjs 建旁白样式会把它一起挂上,两边就成了一个样子。sources.json 对得上。片尾卡是截图做的,就改它的 HTML,再用 baocut compositions preview <视频> --path <片尾卡目录> --at 0 截成图,用 replaceItemAsset 原地换图。fonts.mjs 按稿子与场景里的字裁子集;定稿后改字会让引用这些字体的段全部重烘,改用已有的字更省。稿子或场景加了字,先重跑 fonts.mjs 再打包;build.mjs 报 fonts lack … 就是子集里缺字,烘焙会退回截图。video-production 的代码场景细则(单个画布、每帧清屏、不读回像素、不用 filter 与 letterSpacing)。这类片子最常撞上的是照片上叠了好几层半透明层、中文字体排年份,细则第 2.1 节写了怎么避开,烘焙才走得了指令。场景的骨架与地图数据用 skills_read 读 production-scripts,拷它的 scene-kit/(references/forms.md 第 3 节)。