JimLiu/baocut / skills/baocut/built-in-skills/explainer-video
explainer-video
Verified做知识讲解、科普、教学类视频时读的手艺页:把一个概念、一条新闻、一篇论文或一份资料,讲成没有背景的人也看得懂、愿意看完、看完能复述。给的是判断与手法,不是模板与流程:从观众的疑问找讲法,给这期找一个贯穿全片、自己会讲道理的主体,画面与旁白由同一份事实驱动,核实事实,像审片人一样看一遍;每一版交付成片、封面图与发布稿。制作照 video-production 与 narration。分步操作教程、剪口播不用。
| File | Kind | Size |
|---|---|---|
| .baocut-meta.json | config | 2.5 KB |
| SKILL.md | skill md | 22.1 KB |
| references/3d.md | markdown | 5.7 KB |
| references/footage.md | markdown | 9.3 KB |
| references/length-and-pace.md | markdown | 6.4 KB |
| references/script.md | markdown | 14.4 KB |
| references/subject.md | markdown | 12.3 KB |
references/script.md
View on GitHub# 脚本:从观众出发
`SKILL.md` 第 2、4、6、10 节的细则,是参考,不是规定。目录:1 调研与核实 2 先列观众的疑问 3 讲法(3.1 论证里好用的几样工具) 4 钩子 5 讲解的写法 6 适合朗读(6.1 配音后核对读音 6.2 字幕断行) 7 另一种语言:针对那种语言的观众重写
## 1. 调研与核实
- 涉及新闻、产品、数据、政策的,搜索并读一手来源:官方公告、论文、文档。二手报道只用来找线索。
- 每个要用的数字、日期、引述,记下出处和原文说法。原文说「约 80%」,旁白就说「八成左右」,不写成精确的「80%」。
- 自己换算、估算出来的数,旁白里用「大约」「左右」,交付时标明是换算或估算。
- 分清「某方自己说的」和「独立验证过的」:公司自己公布的测试,旁白里就说是它自己公布的。
- 讲原理用的比方和实际实现不完全一样时,稿子里要有一句交代(「实际的做法更精细,但思路相通」)。
- 封面和钩子可以简化,但不能和正文矛盾;简化掉的限定条件,正文里要补上。
- 没查证的说法不写进稿子。实在想用,交付时单独告诉用户哪一句没核实。
- **讲开源项目、软件、工具时读源码**,不只读 README:克隆或打开仓库,读文档、示例与测试,看它实际是怎么做的。README 的一句概括常和实现有出入(「直接把代码翻译成网络」实际是用一组积木把程序重写一遍)。观众会问的「数据存在哪」「会不会上传」「怎么调试」,以代码为准,顺手查一下有没有存储、上传、联网的代码。
## 2. 先列观众的疑问
这是调研工具,不规定片子的结构:动笔之前,站在受众的位置,把他们会问的问题多列一些(十个上下),再挑最想问的几个,片长决定能答几个。挑出来的问题可以成为片子的骨架,也可以只是写稿时的清单;按 `SKILL.md` 第 3 节定下的形态来用。可以从这几个方向找:
- **和我有什么关系**:会不会影响我?我要不要做什么?
- **真的假的**:这靠谱吗?有没有漏洞?能不能绕过去?
- **代价**:会不会变慢、变贵、变差?
- **边界**:什么情况下不管用?
- **顺着原理自然冒出来的**:讲完「怎么加上去」,观众马上想问「那我去掉呢?」
- 用户在需求里点名要回答的问题,全部进入。
挑的标准:观众真会问,而且答案具体(有数字、有例子、有明确结论)。答案是「不行」「分不清」「目前做不到」的问题往往最有价值,不回避。
## 3. 讲法
讲法从内容里长出来。下面几种常用,可以混用、改造,也可以另起炉灶:
- **从误解讲起**:先把大多数人的直觉答案认真摆出来(「你可能会想……」),再一步步推翻,给出真正的答案。适合常识类、「为什么」类的问题。
- **跟着一个东西走一趟**:一束光、一笔钱、一个数据包、一口食物,从起点走到终点,路上遇到的每件事就是一个知识点。适合过程与系统。
- **一个小实验**:观众在家就能做的,或者一个思想实验;先让观众猜结果,再看结果,再讲为什么。
- **发现的故事**:人们一开始怎么想、卡在哪里、谁怎么想通的。适合科学史、技术史,也能让抽象的结论有来处。
- **一连串追问**:一个问题的答案引出下一个问题,一层层往里剥,观众一直有想知道的东西。
- **对比**:两样相似又不同的东西放在一起,差别就是要讲的。
- **新闻 → 原理 → 和你的关系**:有新闻由头时常用:发生了什么、背后的原理、对观众意味着什么,再答观众的疑问。
多数讲法里会出现的东西:一个抓人的开头、一个身边的例子、一步步的原理、观众的疑问与回答、一个能复述的收尾(一两句话或一个好记的比喻)。这是检查清单,不是段落顺序:按内容取舍、调顺序,有的片子只要其中两三样。
短的片子(一两分钟)通常只讲透一个点:一个钩子、一个例子、一步原理、一两个疑问、一句收尾。
收尾的目标是观众能复述给别人听,写法不止一种:回扣开头的那个问题、一个总的比喻、一句话加一个画面、几条编号的要点。用户不想要套路化的总结时,就别每期都落到「记住三句话」。
### 3.1 论证里好用的几样工具
下面这些是在一段讲解里让观众「服气」的办法,按要回答的问题挑,一期用上两三样就够。它们不是段落表:别把「奇观 → 提问 → 排除 → 原理 → 粗算 → 泼冷水」当成每期都走一遍的固定结构。
- **排除法**:观众心里已经有现成的解释时(「冬天冷是因为离太阳远」),把它摆出来,用一条证据否掉(「南半球这时候正是夏天」),再说剩下的答案。比直接给出答案更让人信。
- **一级一级搭上去**:从一个最简的模型,到一个身边的类比,到一个观众听说过的真实应用,最后落到主题上。讲疫苗可以是:一张通缉令 → 小区门口贴的照片 → 以前打过的某种疫苗 → 这一种新疫苗。每一级只多一样新东西。
- **换成手感**:把数换成身体感觉得到的单位(「一个大气压,相当于每平方米压着十吨」「这块芯片上的晶体管,比地球上的人还多」),能的话再拿它核对来源里的一个数,观众会觉得结论是自己算出来的。
- **自己算一笔,把假设摆出来**:来源没给、观众又最想知道的答案(能撑多久、一年要花多少、要排多少年队),用公开的数字粗算。旁白说明是粗算、假设是什么,画面标上「粗算」,最后说偏乐观还是偏保守。能让过程看得见更好,比如余量条一路降到零、计数器一路跳到头。
- **从奇观落到用处**:讲完炫的部分,回答「那这有什么用」。演示里最抓眼球的那一下常常不是日常用处,照实说,再讲真正有用的那一面。
- **泼一点冷水**:说明哪些数字是公司自己公布的、还没人实测;和它以前的承诺对一对;留一个以后能检验的问题(明年能不能上市、价格会不会降下来)。
- **收在一个转折上**:结尾可以回到一段历史或开头的画面,换一个角度再看一次,比把要点再念一遍好记。讲青霉素的可以回到那只没洗的培养皿:开头它是个意外,看完它是一个人留意到了别人会扔掉的东西。
## 4. 钩子
第一句决定观众留不留:
- **说到观众自己**:一件他们刚做过、正在用的事,和这期的主题扯上关系。
- **反常识**:一个和直觉相反、又站得住的事实。
- **刚发生的事**:新闻由头放第二三句,第一句仍然先说和观众的关系。
- **一个具体的小场景**,不用大词。
- **先放画面**:有震撼的真实画面时,第一句可以直接说画面里发生了什么,接着两三句把观众的疑问摆出来,说明这期要回答哪几个;后面按这几个问题往下讲。
「大家好,今天我们来聊聊……」「随着……的发展」「你知道吗?」这类开头容易让人划走。第一句短一点,一口气念得完。
## 5. 讲解的写法
写给聪明但没有背景的人:
- **一句一个意思**,短句;一句太长就拆。
- **术语第一次出现就用人话解释**,或者干脆换成人话;必须保留的名字(产品名、技术名)照写,画面上同时标出。
- **论证靠它成立的术语,把它怎么起作用讲出来**:「上线前可以用功能开关」「出了问题能很快回滚」这类句子,观众要知道开关是什么、为什么关掉它就安全,回滚是退回到哪、为什么能很快,才明白这一步好在哪里。只报个名字,这一步就讲空了。
- **数字要有参照**:「抛 200 次硬币,出来 140 次正面」比「显著性很高」好懂;分数、百分比用口语里的说法。
- **例子具体到能画出来**。写不出画面的句子,观众也想不出画面。
- **直接说**。少用「不是……而是……」的句式与「值得注意的是」「总的来说」这类垫话,直接说结论更有力。
- **转述不加戏**:来源没说的动机、情绪、评价不补。
- **有来有回**:替观众把问题问出来(「那它藏在哪?」),再回答。
- **承认局限**:做不到的、不确定的照实说,观众反而更信。
- 语气像一个懂行的朋友在讲,不卖弄,不居高临下,不喊口号。
受众不同时:给孩子,例子换成游戏、零食、班级里的事,一期只讲一个道理;给从业者,可以省掉基础铺垫,但「从疑问出发、先结论后证据」不变。
「普通人听得懂」可以这样自查,写完逐条过一遍稿子和分镜:
- 每个陌生概念第一次出现前,先有一个观众见过的例子接住它。
- 画面上出现的每个数字(参数量、层数、百分比、坐标),旁白都说清它是什么、大还是小。
- 第一个例子不是代码或公式;代码与公式放在观众已经懂了思路之后,当作「它在电脑里长这样」。
- 核心比喻在每个例子里都用上一次,点明哪里对应比喻的哪一部分。
## 6. 适合朗读
稿子既给语音合成念,也是字幕。按 `narration` 第 2 节写(一句一行、数字写成读法、读音标注、怎么说与说什么分开),讲解视频另注意:
- 不出现念不出来的东西:链接、Markdown 符号、括号里的补充说明。
- 算式与运算里的数字也写成读法(「减二」「乘以三」「大于四」),不写「减 2」「a > 4」:混着阿拉伯数字与符号的短算式容易被读错,转写反推时也对不上。
- 一行旁白是一个动画节拍,也是一段连续的话:长档中文约 5–60 字,英文约 8–35 词;短档、中档更短,见 `references/length-and-pace.md` 第 1 节。
- 竖版字幕一条放不下长句:句子里多用逗号断开,字幕才断在自然的地方。
- 画面上有几样东西要依次出现,旁白里就让它们依次被说到;画面要对上的关键词(数字、术语)在旁白里完整出现,节拍才取得到那个词的时刻。
### 6.1 配音后核对读音
`SKILL.md` 第 6 节「读音核对」的做法:用 transcribe 转写旁白素材(模型选法同 `narration` 第 4 节:词时间为 `native`、收提示的那只;语言断言为稿子的语言,提示里放专名),把识别出的字与稿子逐句比对。
- 同音字、标点、数字写法的差异是识别器的问题;专名、外文词、数字、多音字对不上的,可能是真读错:在稿子里改成读法写法(`narration` 第 2 节),或重配那一句(模型收 seed 时换一个 seed,不收时直接再配一次),再核一次。配两三次还读错或总被听错的词,换一个说法(「官方」总被听成别的字,就写出是谁说的)。
- 换第二个识别器再转一次时,先用 artifacts_save 把旁白素材存成文件,再 transcribe 给 `file` 与 `noVideo`(只出文稿,不新建视频、不替换对齐用的文稿)。两三次识别都不同的词,在交付里写明时刻,请用户听。
- 读对了、只是字认错的(同音字、专名的写法),建字幕前用 edits_apply 的 `updateWords` 把这份转写文稿改回稿子的写法(只传改过的词,时间不动;做法用 `skills_read` 读 `baocut-catalog-subtitles` 的「润色写回」),字幕从改好的文稿建,别拿识别出的错字上屏。
### 6.2 字幕断在词中间、折成两行
`SKILL.md` 第 7 节审片时常见的两种字幕问题:
- 字幕把一个词从中间断开(「修程|序崩溃」):切条已经按词边界断(拉丁字母的单词整词走,中文按词典分词,到宽度上限时延长到词尾),还会断开的是词典不认识的专名、新词,或长到超出余量的词。看到了就改那一条的断句,或在转写文稿里那个词前面加个逗号(`updateWords`,时间不动)再重建字幕,或在稿子里把这句写短。
- 烧进画面的字幕一条超过一行(竖版约 9–10 个汉字)会折成两行:折点先找标点、空格与中文词边界,各行尽量一样长,词典不认识的词(专名、新词)仍可能被折开。export 的 `maxCharsPerLine` 只管字幕文件,不管画面。想要每条只占一行,在转写文稿里给长句加标点,或改句。
## 7. 另一种语言:针对那种语言的观众重写
主版本确认之后再写。目标是那种语言的观众看了觉得「这就是给我做的」,而不是一份翻译稿。
**不变的**
- 事实、数字、结论,回答的那几个观众问题,核心比喻。
- 主版本选的讲法与大的段落顺序。段落可以合并、拆分或调顺序,行数不用和主版本对应。
- 用户在主版本上确认过的取舍(讲什么、不讲什么、简化到什么程度)。
**要重写的**
- **钩子**:换成那种语言观众的处境,第一句同样要短、和观众有关。
- **身边的例子**:换成他们身边的东西(他们用的钞票、平台、学校里的场景)。只对原语言观众有意义的内容(某地的规定、某地平台的标签)删掉,或换成对等的东西;换上的内容同样要核实来源。
- **来源的说法用原文**:来源本来就是这种语言时,术语、产品名、引述直接用原文措辞,不从主版本再译回去。
- **句子**按这种语言的口语写:短句,一句一个意思,不带原语言的句式与成语硬译;找不到自然说法的比方就直说。
- **数字和日期**按这种语言的习惯写成读法。
- **长度**按这种语言的实测语速重新算预算(`narration` 第 1 节),不需要凑到和主版本一样长。
- 用户给的固定片头、片尾口播用用户给的那种语言的版本;没给的,问用户,不自己翻。
**自查**
- 把新稿单独读一遍:如果不知道有主版本,会不会觉得它是翻译的?有这种感觉的句子重写。
- 逐条核对数字、日期、限定条件与主版本、与来源一致。
- 列出和主版本不一样的地方(换了哪些例子、删了什么、加了什么),交付时告诉用户。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |