Skip to content
cccskills
FreePublished on GitHub

explainer-video

做知识讲解、科普、教学类视频时用:把一个概念、一条新闻、一篇论文或一份资料,讲成没有背景的人也看得懂、愿意看完的讲解成片。给的是思路、手法与常见的坑,不是固定模板:从观众的疑问出发找讲法,找一个贯穿全片的视觉比喻,用生成的图片与代码动画一起把画面做丰富,核实事实,按需出另一种语言或画幅的版本与发布文案。

制作流程照 video-production 与 narration。分步操作教程、剪口播不用。

The English summary is being prepared. Showing the original description.

See how to install

Files included (11)

  • SKILL.md16.5 KB
  • .baocut-meta.json2.2 KB
  • references/production-scripts.md7.4 KB
  • references/script.md9.4 KB
  • scripts/align.mjs9.3 KB
  • scripts/assemble.mjs14.8 KB
  • scripts/build.mjs4.5 KB
  • scripts/captions.mjs5.9 KB
  • scripts/explainer.example.json964 B
  • scripts/lib.mjs7.6 KB
  • scripts/voice.mjs2.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

知识讲解视频

好的讲解视频没有标准形状。讲清楚天空为什么是蓝的,可以是一个在家就能做的小实验,可以跟着一束阳光穿过大气走一趟,也可以先把「天空映着大海」这个误解摆上台再推翻;好不好,看观众有没有真的懂、愿不愿意看完。这份 skill 记的是做讲解时值得想的问题、常用的手法和容易踩的坑,帮你把自己的判断做好:里面的结构、风格与数字都是起点和参考,这期的内容和受众需要别的讲法时,照你的判断来,交付时说一句为什么这样选。

建视频、出画面、配旁白、混音、导出这些制作步骤照 video-production 与 narration,这里不重复。开始前用 skills_read 读 video-production;写稿、配旁白时用 skills_read 读 narration。

1. 什么样算讲得好

拿来检验想法、稿子和画面,不必逐条套用:

  1. 从观众出发。 讲他们感兴趣、关心、用得上的,不讲这个主题「应该」讲的。没说受众时,默认是聪明但没有背景知识的普通人(大约高中生水平);指定了受众,例子、用词、画面都跟着换。
  2. 第一句就让人想听下去。 和观众自己有关,很快立起一个想知道答案的问题。
  3. 接到见过的东西上。 陌生的概念先找一个观众见过的东西来接。
  4. 一次一步。 一次只引入一个新东西,后一步踩在前一步上。
  5. 回答观众真想问的。 包括答案是「不行」「不确定」「目前做不到」的。
  6. 看完有收获。 观众能用自己的话复述给别人听。
  7. 画面让看不见的东西看得见。 重的效果留给真正关键的几下;处处都炸等于没有重点。
  8. 事实要准。 可以简化,不能说错。

2. 弄清要讲什么

  • 从对话里取:主题、资料或新闻、受众、看完能做到什么、时长、画幅、成片语言、风格偏好。能推断的不问,缺的按 video-production 第 1 节合成一轮问。没说时长时按内容定:一个点讲透通常一两分钟,完整讲一个概念几分钟;装不下时先删,不靠念快。用户放宽了时长(「时间不限」)就按内容需要来,不再按惯常的长度劝删。
  • 涉及新闻、产品、数据、政策的,读一手来源(官方公告、论文、文档),二手报道只用来找线索;用户给了资料的以资料为准。用到的数字、日期、引述记下出处,交付与正文要用。核实与简化的分寸:用 skills_read 读本 skill 的 references/script.md 第 1 节。

3. 找讲法、写稿

  • 先替观众提问。 站在受众的位置把他们会问的问题列出来,挑出最想知道、答案最具体的几个;用户点名的都答。这份问题清单常常就是片子的骨架,也值得给用户看。
  • 再选讲法。 讲法从内容里长出来:从一个误解讲起、跟着一个东西走一趟、一个小实验、一段发现的故事、一连串追问……references/script.md 第 3 节列了几种常用的,可以混用,也可以另起炉灶。同一系列连着几期,别每期都落到同一个顺手的结构。
  • 稿子按句分行,一行一个画面节拍;长度按 narration 第 1 节的实测语速估,首稿用 skills_read 读 baocut-catalog-voice-language-rates。钩子、讲解与朗读的写法:用 skills_read 读本 skill 的 references/script.md 第 2–6 节。
  • 配音前给用户看稿:旁白、预计时长、讲法与视觉比喻、每段想回答观众的哪个问题、来源与做了哪些简化。能出画面时附上风格样张、封面与几段按估算时长取的样帧:只看文字,用户很难说出「开头太难」「例子太少」这类具体的意见。配音与出画面都花时间与额度,稿子一改就得重做;用户说过「直接做」时不停下,把这些附在交付里。
  • 「直接做」之后用户又追加或小改(加一段、改几句):只重做受影响的段落(重配、重新对齐、重新导入那几段),直接做完,不再停下来确认;改动动到了讲法、结构或风格时,先说一声再做。

4. 画面

画面的通用做法(选风格、贯穿全片的视觉主意、封面与版式、效果的轻重、生成的图片与代码一起用、竖版与横版)在 video-production 的画面细则里:用 skills_read 读 video-production,按它第 2 节「画面设计」一条读。讲解片在上面多想几件事:

  • 一个贯穿全片的视觉比喻:把这期的核心概念变成一个看得见、能动的东西,封面上就出现。问自己:这个概念里「看不见的东西」是什么?什么颜色、形状、角色能让它看得见?这是一期讲解片最出彩的地方。
  • 比喻是一把尺子:后面每个例子都拿它量一次,画面与旁白点明这个例子里哪里对应比喻的哪一部分;只在开头讲一遍、结尾提一句,观众到中段就忘了。
  • 比喻要有血有肉:比喻里的角色与物件(一个小光子、一个分子、一枚硬币)用图片生成画成一套贴图,在代码里换姿势、移动、变形;图解、数字与要读的字仍由代码画。只有几何图形和字的讲解片讲得清,但不好看、不好记。
  • 资料自带的图优先:来源里已经有一张把道理排清楚的图(流程图、分层图、时间线),这部分就用它的结构做主线,画面按它重画,讲解跟着它一步步走。比喻只用来帮观众接上其中一两个陌生的环节,不把整段硬套进比喻;比喻和原图讲的顺序不一样时,跟原图走。用户给了原文配图的,构图(竖着叠还是横着排、谁在前谁在后)先照原图。
  • 说到哪亮到哪:一屏一个重点,画面上的字是旁白的提炼,整句留给字幕;问答部分在角上留个小页眉(「问题 2|……」),观众随时知道在回答哪个问题。
  • 把误解画出来再推翻:直觉上的错误答案先认真画出来,再用一个动作否掉(扫掉、划掉、碎掉),比只用嘴说更让人记住。
  • 带路的角色按需:需要一个讲解员或吉祥物替观众把问题问出来、指着图解讲时再加,一期一个就够。
  • 效果有轻有重:重的冲击只留给最关键的结论,落在旁白说出那个词的时刻。好看主要来自好的比喻、干净的排版与跟语音对齐的节拍。
  • 风格从主题和受众里来,同一系列连着几期别落到同一套顺手的样式。

5. 制作

照 video-production 第 4–6 节做。讲解片常用到的:

  • 整镜整段由代码画时,按 video-production 第 5 节「代码画面」一条读它的代码场景细则(按段打包导入、确定性、字体与图层);生成的角色、物件与底图放进代码包里动起来。短的标注、关键词、大数字按 motion-graphics。
  • 讲真实的产品、人物、事件、地点时用真实画面、截图或用户的素材;生成的图只画比喻、示意与想象的场景,不冒充真实。
  • 比喻的画法写成可复用的部分:以原点为中心、带缩放、文字由调用方传入,同一个比喻能在不同镜头、画幅与语言的版本里复用。
  • 节拍跟着真实语音走:旁白量好、对齐拿到字时间后,画面元素的出场时刻取对应的词被说到的时刻,不按估算的比例;重新配音后按新的字时间重排。改稿后核对每个节拍用的关键词仍在对应那句旁白里(「it is」改成「it's」、换了个说法都会让它对不上),对不上的报出来改掉,不悄悄退回估算的位置。
  • 分段做、分段改:旁白按段配、按段对齐,代码画面按场景切包,每段的成果都留着。改一段或插入一段时只重做这一段(重配、重新对齐、重新导入那个包),没改的段落沿用原来的录音、字时间与画面,不整片重来。有命令行环境时用本 skill 的 scripts/:配音、对齐、打包、摆上时间线(某段变长变短时连字幕一起挪后面的片段)、建字幕五步都写好了,内容相关的设定放在一份配置里,拷进工程就能用;用法、配置字段与改一段的做法用 skills_read 读本 skill 的 references/production-scripts.md。
  • 读音核对:用 transcribe 转写旁白素材(模型选法同 narration 第 4 节:词时间为 native、收提示的那只;语言断言为稿子的语言,提示里放专名),把识别出的字与稿子逐句比对。同音字、标点、数字写法的差异是识别器的问题;专名、外文词、数字、多音字对不上的,可能是真读错:在稿子里改成读法写法(narration 第 2 节)或换 seed 重配那一句,再核一次。换第二个识别器再转一次时,先用 artifacts_save 把旁白素材存成文件,再 transcribe 给 file 与 noVideo(只出文稿,不新建视频、不替换对齐用的文稿)。两三次识别都不同的词,在交付里写明时刻,请用户听。读对了、只是字认错的(同音字、专名的写法),建字幕前用 edits_apply 的 updateWords 把这份转写文稿改回稿子的写法(只传改过的词,时间不动;做法用 skills_read 读 baocut-catalog-subtitles 的「润色写回」),字幕从改好的文稿建,别拿识别出的错字上屏。
  • 烘焙前先给用户看会动的画面:配好旁白、对齐之后,导入之前,把各段做成一个本机预览页给用户看(做法见 video-production 代码场景细则第 7 节「自检」:用 skills_read 读 video-production,再按它第 5 节「代码画面」一条读细则)。讲解片的意见多半落在某一段讲得清不清楚,在页面上改好再烘焙,比烘完整片再改快得多。用户说过「直接做」时照做,预览页附在交付里。
  • 第一帧就是封面(主 skill 的通用规则):0 秒时标题、一个观众的问题与这期的视觉比喻都已在位,缩成手机上的小图也看得清标题。字幕条从第一个字被说到的时刻开始,旁白从 0 秒就起时第一条字幕会压在封面上:封面先静止约 1 秒再起旁白,或把第一句旁白往后挪到标题读完。
  • 署名与品牌只照用户给的做:固定的片头、片尾口播、角标或水印逐字逐样照用户给的,不自己发明栏目名、口号或水印。BaoCut 没有自动插片头片尾口播或片尾卡的工具:固定口播写进稿子里当固定段,自己合成、自己做片尾卡。

6. 自己看一遍

用 compositions_preview 按段落取帧拼起来看,再导出预览按正常速度看。videos_frames 取的是最上层片段的素材帧,字幕与叠加的元素不在里面(结果的 composited 为 false):要看字幕的位置、压不压画面上的字,用 export 给 purpose: preview 与 range 导一小段,从导出的文件里抽帧看。拿每一帧和你想让观众这一刻看到、读到的东西比,问「观众这一秒看得懂吗」,别只看好不好看。讲解片里常见的问题,供你对照:

  • 封面不完整:标题、问题或比喻没到位,缩小后看不清。
  • 字和底色太近:浅底上的白字、浅色字,深底上的深色字,半透明的字糊在底上。
  • 空着的卡片、格子与条;依次出现的一组出齐后,最后一帧少了几项。
  • 字太小、出了安全区、压到字幕;竖版挤在上半屏、下半屏空着。
  • 数字和稿子、来源对不上(滚动的数字看终值)。
  • 换段时闪一下旧内容;一个画面很久一动不动,观众开始走神。
  • 画面上出现的数字(参数量、层数、百分比)旁白没解释它是什么。
  • 字幕把一个词从中间断开(「修程|序崩溃」):切条已经按词边界断(拉丁字母的单词整词走,中文按词典分词,到宽度上限时延长到词尾),还会断开的是词典不认识的专名、新词,或长到超出余量的词。看到了就改那一条的断句,或在转写文稿里那个词前面加个逗号(updateWords,时间不动)再重建字幕,或在稿子里把这句写短。
  • 烧进画面的字幕一条超过一行(竖版约 9–10 个汉字)会折成两行:折点先找标点、空格与中文词边界,各行尽量一样长,词典不认识的词(专名、新词)仍可能被折开。export 的 maxCharsPerLine 只管字幕文件,不管画面。想要每条只占一行,在转写文稿里给长句加标点,或改句。
  • 生成的图里冒出字、水印、变形的手与脸;同一个角色前后不像;抠图带着底色边。
  • 冲击效果太多,真正的结论反而不突出。
  • 另一种语言的版本里混进原文字、长词超宽被截断。
  • 和上一期像一个模子出来的。

读回与三栏报告照 video-production 第 7 节。

7. 发布文案

讲解视频多半要发出去,交付时一并给标题、简介与正文(文案的文字版),用户说不要就不给。标题与简介用 skills_read 读 titles-and-description 写,正文用 skills_read 读 video-blog(作者视角)写。讲解片的几个讲究:

  • 标题给一个推荐的,最多附两个备选:说清这期讲什么,再留一个让人想点开的问题或反差,通常是封面大标题加一个观众的疑问;关键词放前面。有限定条件的结论不在标题里说成普遍事实。
  • 简介第一句能单独成立(很多平台只显示前一两行):由头 → 这期讲明白了什么 → 回答了哪几个问题 → 一句话收获;写给还没看的人,不剧透全部答案;资料来源放在正文末尾。字数按发布平台,用户没说时中文约 300 字、英文约 100 词以内。
  • 正文以旁白为底稿,没看视频的人读完得到同样的信息:指向画面的话改写,只在画面上出现的信息(图表里的数、对比的结果)用文字补出来;为朗读写的读法改回书面写法;去掉固定开场、结尾的口播;按内容加小标题,问答部分直接用观众的问题做小标题;视频里简化掉的限定条件可以写完整,但不与视频矛盾;文末列资料来源(名称、发布方、日期、链接)。

8. 交付

照主 skill 的「交付」写任务总结。讲解片的用户要靠这些判断片子能不能发:回答了哪些观众问题、事实来自哪里(用户给的资料也写明)、做了哪些简化、有没有没核实的说法(有就单独列出哪一句);再说选的讲法、风格与视觉比喻,哪些画面是生成的。读音只靠转写反推时写明「没有人耳听过」,列出仍可疑的词与时刻。标题与简介贴在回复里,正文给文件并说明字数。

9. 另一种语言或画幅的版本

用户要两个版本(例如一个竖版、一个横版,或两种语言)时:

  • 先做主版本(简报里的语言与画幅),交付、用户确认后再做另一版,用户在主版本上提的修改带进另一版。用户一开始就说两版都直接做时,照用户的。
  • 另一种语言要针对那种语言的观众重写,不是逐句翻译:事实、结论、回答的问题与核心比喻不变;钩子、身边的例子、句子节奏按那种语言的观众重写,只对原语言观众有意义的内容删掉或换成对等的(换的同样要核实)。写法与自查读 references/script.md 第 7 节。
  • 另一种画幅要重新构图;另一种语言的画面也要重排(字宽不同、标签换成短词)。按 video-production 画面细则里竖版与横版、另一种语言的两节排。
  • 两版共用:风格、核心视觉比喻的画法与贴图、音色与语气说明、事实与资料来源。另一版建成一部新视频,主版本不动。
  • 交付另一版时说明它和主版本哪里不一样(换了的例子、删掉或新增的内容)。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

baocut

Free

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

The English summary is being prepared. Showing the original description.

JimLiu/baocut1.1KUpdated Oct 18, 2026

baocut

Free

测试用的说明书:用 BaoCut 转录、翻译、剪辑与导出视频。

The English summary is being prepared. Showing the original description.

JimLiu/baocut1.1KUpdated Oct 18, 2026

Release BaoCut Electron desktop apps through GitHub Actions tags by default; use local/manual packaging only when explicitly requested. Also handles App version bumps, release continuation and portable signing backups; excludes craft skills and legacy standalone CLI releases.

The English summary is being prepared. Showing the original description.

JimLiu/baocut1.1KUpdated Oct 18, 2026

用户要给视频做封面、要封面大字,或要标题和封面一起出时用:读文稿提炼卖点,给几组标题与封面文案,用户挑定后按视频画幅生成封面图,放进这个视频的候选素材。每句都由视频兑现。只要标题或简介、不要封面时用起标题与写简介。需要视频的转写。

The English summary is being prepared. Showing the original description.

JimLiu/baocut1.1KUpdated Oct 18, 2026

用户问「我哪一期讲过 X」「这几部视频里谁说过 Y」「X 在我的视频里是怎么讲的」「有哪些讲 X 的视频」这类要在多部视频里找答案的问题时用:按意思检索、按视频去重、按当前版本重新定位,只凭找回来的原话回答,每条论断注明视频与时间,覆盖不全时说明。不用于总结或改写一部视频(那是总结、博客),也不改视频。

The English summary is being prepared. Showing the original description.

JimLiu/baocut1.1KUpdated Oct 18, 2026

design

Free

用户要做界面、网页、海报、图表或信息图、示意图、原型这类视觉设计稿时用:在工作目录写一份设计稿(canvas.json 加每块画板一个 .dc.html),校验通过后线程里出现设计稿卡片,用户在功能区预览、编辑与标注。也用于按用户的意见或设计稿标注改已有的设计稿。幻灯片不用它(用 slides),视频画面里的字卡与动效也不用它(用动效图形)。

The English summary is being prepared. Showing the original description.

JimLiu/baocut1.1KUpdated Oct 18, 2026

See all skills by JimLiu

Report a problem with this skill