脚本写作方法
本文档沉淀脚本写作的方法原则。方法,不是作者口头禅或固定句式。
核心结构 · PPT-Script 1:1
脚本的 section 数 = PPT 的 slide 数,严格对应。
每段开头必须有切页标记:
**【PPT 切到 Slide N · 页名】**这个标记是本 skill 的核心约定:
- 录屏时作者一眼知道何时翻页
- 剪辑时可用作章节锚点
- 音频-视频对齐的参照
文件头部的同步说明
script.md 开头(frontmatter 之后)加一段:
---
title: "..."
date: "YYYY-MM-DD"
duration: "~X 分钟"
platform: "..."
---
# {标题}
> **PPT 同步说明**:每段口播对应一张 PPT 页。录屏时"翻到下一页"= "进入下一段"。PPT 地址:`./ppt/index.html` · 共 N 页。
> **写作说明** · {受众定位一行 · 如"面向 AI 爱好者,不是学术专家"}
## Section 1 - ..."受众定位"那行提示作者自己:写的时候语言深度往哪个目标群体对齐。
语言方法
A. 术语处理
规则 —— 术语首次出现时,同句或邻句必须用"人话"解释。
反例:
V4 用了 mHC 替换 HC,让信号传播更稳定。
正例:
V4 的做法是给这个神经网络的每一层加了数学约束 —— 每层都不能把上层的信号放大,只能原样传下去或缩小。这样深层网络再堆高也不会崩。
写作时可以保留术语名(让有基础的观众对得上),但必须配一句"其实就是..."的人话版本。
B. 每段必须有"对受众意味着什么"落脚
每个 section 的技术段落后必须点出这件事对受众来说意味着什么。
常见句式(按语境选用,不要固定只用一种):
- "对你的影响是 —— ..."
- "翻译成你能感受到的场景 —— ..."
- "对{受众群体}来说的意义 —— ..."
- "这件事最终变成你能用到的能力是 —— ..."
写不出"意味着什么"的 section,要么简化,要么重新考虑这页有没有必要单独成页。
C. 比喻作为降低理解成本的工具
复杂技术概念用类比 / 比喻处理。本 skill 不规定具体比喻库 —— 由作者根据当期主题和受众选择。
好比喻的标准:
- 受众生活里熟悉的事物(不是另一个技术概念)
- 能呈现核心机制,不是只"像"个名字
- 用一次就够,不过度扩展(避免比喻比本体还复杂)
作者可以自己维护一个"用过的好比喻"列表作为资产,但本 skill 不在这里预置。
D. 数字要带参照系
裸数字对观众没信息量。每个数字都要加参照:
- "1.6 万亿参数" → "1.6 万亿参数 · 跟 ChatGPT 同级别"
- "Codeforces 3206 分" → "Codeforces 3206 · 相当于全球前 25 名真人选手"
- "省 70% 算力" → "省 70% 算力 · 相当于 API 价格能打下来一大截"
E. 避免"行业体"
删掉:
- "里程碑式"、"重新定义"、"XX 时代"、"令人瞩目"、"颠覆性"
- "打响了第一枪"、"吹响了号角"
换成:
- 具体变化是什么
- 跟上一代 / 同类对比差别
- 用户能多做什么事
Section 结构骨架
每段大致:
## Section N - {一个钩人的小标题}
**【PPT 切到 Slide N · 页名】**
{1-2 句开场,引入本段要讲什么}
{主体 2-4 段 · 展开说明 · 带类比 · 术语配人话}
**{受众视角落脚句}** —— {对受众意味着什么}长度参考:60-90 秒一段(约 200-350 字)。
- 太短(< 60s) → 页面信息量可能不够,考虑合并
- 太长(> 120s) → 页面塞太多,考虑拆页
Hook 段 · 第一段的常见形态
第一段(Hook)通常需要承担两件事 —— 抓住注意力 + 设立定位。常见结构:
## Section 1 - Hook
**【PPT 切到 Slide 1 · 封面】**
{直接抛最抓人的点 · 1-2 句}
{作者自称 + 定位 · 告诉观众"我是谁、这期讲什么、不讲什么"}
{对这期长度 / 节奏的预告}
**【PPT 切到 Slide 2 · {下一页名}】**
{一两句过渡到 Slide 2}注意 —— Hook 段可能覆盖 Slide 1 + Slide 2 开头一小部分,所以一段里可以有两个切页标记。这是合理的。
收尾段 · 不固定句式
收尾方式因视频调性而异。不要钉死固定结尾句 —— 作者有自己的口头禅就保留,没有就让语气自然。
常见收尾组件:
- 三句话总结(N 页内容压缩成 3 个 takeaway 论点)
- 延伸方向(这期没讲到的,后续要深入的)
- 收尾语(作者习惯用的结束语)
结尾语保持自然,不强求格式化。
品牌 / 个人元素处理
作者可能有:
- 自称(主播昵称)
- 固定口头禅(好了今天就聊到这里)
- 频道品牌(频道名 / 节目名)
这些是作者的个人资产,不是 slides-video 的 skill 属性。
处理方式:
- 第一次使用作者资产时,从用户那里收集(
video-plannerskill 会引导) - 保存到 auto memory 的
video-promo.md - 后续自动复用
本 skill 不硬编码任何作者特定元素。如果看到前版 references/ 里还有作者昵称 / 频道品牌类硬编码,应该清理掉。
不要做的事
- ❌ 假设受众懂术语就直接用
- ❌ 每段只讲技术不讲价值
- ❌ 用"里程碑 / 重新定义"这类套话
- ❌ 裸数字不给参照
- ❌ 钉死作者口头禅或频道品牌(留给作者资产层)
- ❌ 把脚本写成"课件" —— 要写成"口语"