本文へ移動
cccskills
無料GitHub で公開

explainer-video

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

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

日本語の概要は準備中です。原文の説明を表示しています。

インストール方法を見る

含まれるファイル(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(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

知识讲解视频

好的讲解视频没有标准形状。讲清楚天空为什么是蓝的,可以是一个在家就能做的小实验,可以跟着一束阳光穿过大气走一趟,也可以先把「天空映着大海」这个误解摆上台再推翻;好不好,看观众有没有真的懂、愿不愿意看完。这份 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 画面细则里竖版与横版、另一种语言的两节排。
  • 两版共用:风格、核心视觉比喻的画法与贴图、音色与语气说明、事实与资料来源。另一版建成一部新视频,主版本不动。
  • 交付另一版时说明它和主版本哪里不一样(换了的例子、删掉或新增的内容)。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

baocut

無料

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

日本語の概要は準備中です。原文の説明を表示しています。

JimLiu/baocut1,0592026年10月18日 更新

baocut

無料

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

日本語の概要は準備中です。原文の説明を表示しています。

JimLiu/baocut1,0592026年10月18日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

JimLiu/baocut1,0592026年10月18日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

JimLiu/baocut1,0592026年10月18日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

JimLiu/baocut1,0592026年10月18日 更新

design

無料

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

日本語の概要は準備中です。原文の説明を表示しています。

JimLiu/baocut1,0592026年10月18日 更新

JimLiu のスキルをすべて見る

このスキルの問題を報告する