1实现原理 · 为什么它能做到

把解说片定义为「论证」而非功能巡回：动任何流水线步骤之前先锁死叙事，且要求能压成一句话的核心主张——压不出来就砍范围，而不是缩小它。

skills/explainer-video/SKILL.md

An explainer is an argument, not a feature tour.

这一条是后续「script-first」「先痛后解」「一喻到底」等全部约束的来源。

script-first：VO 是脊柱，画面只解释正在被说出的那句；先写词并计时，再画 storyboard 与动画。

skills/explainer-video/SKILL.md

Write and time the words before you storyboard or animate — it is far cheaper to cut a sentence than a built scene.

把「改一句词」与「重做一场景」的成本差写成流程顺序约束，是这条 skill 最核心的工程判断。

叙事弧拆成五拍并各给观众内心台词（Problem→Stakes→Solution→How→Payoff/CTA），并要求比喻唯一、取自观众世界，禁止中途换喻。

skills/explainer-video/SKILL.md

| Problem | Name the pain in their words | "That's me." |

「观众内心台词」这一列把抽象结构变成可检验的写作目标。

流水线是六步固定序列（Script → Storyboard → Build scenes → Narration & captions → Edit → Polish），storyboard 阶段规定一场景一想法、每条 VO 行映射一个视觉意图。

skills/explainer-video/SKILL.md

2. **Storyboard** — one idea per scene.

六步之间不设回路，隐含「先定词后建场」的成本观。

时长由 VO 数学推导：约 2.3 词/秒（140 wpm）为基线、技术句降到 ~2.0，场景长度 = 词数/语速 + 呼吸量；参考值 30s≈69 词、60s≈138 词、90s≈207 词。

skills/explainer-video/references/script-to-screen-workflow.md

`scene_seconds = line_words / pace + 0.4` (breathing room).

把「视频多长」从感觉问题变成可先算再建的量。

字幕被视为必需品（默认静音自动播放），规定 ≤2 行、≤42 字符/行、屏上 ≥1.0s，并要求在 Remotion 里与切点共用同一计时数组以免漂移。

skills/explainer-video/SKILL.md

In Remotion, drive captions from the same timing array used for scene cuts so they never drift.

「单一计时源」是它防字幕漂移的具体机制，不是原则式提醒。

交付是 Remotion 工程 + 逐帧渲染的 MP4：全部动效帧驱动（禁 Date.now / Math.random / timer），时长依赖 props 时用 calculateMetadata 计算；验证走 still → inspect → encode。

skills/explainer-video/SKILL.md

A Remotion project with the composition registered (`<Composition>` + zod `schema` + `defaultProps`), all motion frame-driven (no timers / `Date.now()` / `Math.random()`).

帧驱动纪律是它与「网页动效」分层的关键：渲染器快照离散帧，墙钟动画会闪或冻。

2核心能力

01五拍叙事弧 + 各拍节奏配方（问题/赌注快切、方案一击、机制最慢、结尾卡停留）

02VO 计时数学与场景长度推导（2.3 w/s 基线、视觉节拍 ≥1.0s、按目标时长反查词数）

03可填写的 storyboard 模板（时间码 + VO + 视觉 + 关键动效 + 转场落词 + 资产清单）

04场景级内联技法：图解渐进揭示、动能关键词、柱生长 + 计数

05字幕工程：SRT/VTT 规则、每行字符与行数上限、屏上最小时长，以及 Remotion 单一计时数组驱动

06跨场景风格系统锁定（一套字阶、一套颜色语法、一条缓动曲线，spec sheet 含 SAFE 区）

07Remotion 渲染与验证回路：still 三帧（用真实 props 而非 defaultProps）→ 人眼核 → 再 encode

08README 演示 GIF 顺带产出（--codec=gif 复用同一次渲染能力）

3外部依赖

Kind	Dependency / Endpoint
cli	npx remotion still / render / compositions（帧渲染与编码）
package	Remotion + zod（composition 注册与 props schema）+ React
cli	ffmpeg / ffprobe（contact-sheet.sh 与 probe-mp4.sh）
cli	npx -y playwright（仓库根 seek-shot.sh，网页层兄弟 skill 用）
api	无第三方业务 API；配音由用户自备或宿主侧 TTS 产出，skill 只要求把 VO 作为本地静态资源挂载

4管控建议与判定依据

建议配套管控措施

面向 Agent

分级或逐次授权，建议在沙箱运行

面向管理者

审批流程、可回滚、全程审计

判定依据（文件路径与关键语句摘要）

scripts/: 执行本地脚本或命令: npx remotion still / render / compositions（SKILL.md 与 scripts/README.md 指示）
网络端点: 声明外部网络访问: 若按同 pack 的 remotion-recipes 使用 @remotion/google-fonts，渲染时会从 Google Fonts 取字
本地工作目录: 文件读写与工件输出: out/*.mp4（成片）、out/*.gif、out/f-*.png（still 帧）

审计说明： 。判级对象是 skill 自身目录（skills/explainer-video/：SKILL.md + references/ + 0 字节 README.md；无自带脚本、无凭证读取、不写盘）。触发橙档的是执行链：输出契约要求用 `npx remotion still/render` 渲染 MP4，npx 会从 npm registry 拉取并执行 Remotion CLI 及 @remotion/* 系列包，并在本地 bundle + headless Chromium 中执行被渲染项目的代码——落入分级范式「依赖第三方插件、镜像、远程包」（同作者 pack 先例：remotion-video 同因判橙）。skill 本体不读凭证/env、无业务 API、无采集与绕过行为，故非红档。触发条件：只有真正渲染/导出时才发生（纯写脚本、只做 storyboard 不触发）；若项目已把 Remotion 锁在本地 node_modules 并离线渲染，接触面收敛为「本地执行项目代码」。

5第二遍独立确认

[ok] 外部依赖调用点复核（npx remotion / ffprobe / @remotion/google-fonts） — SKILL.md Verify loop 实际给出 `npx remotion still Explainer out/f-start.png --frame=0 --props='{...}'` 与 `npx remotion render Explainer out/explainer.mp4`；仓库根 scripts/probe-mp4.sh 确为 ffprobe 实现。@remotion/google-fonts 出现在同 pack 的 wrapped-video/references/remotion-recipes.md，本 skill 只写 `<Audio src={staticFile()}>`，故未把它记为本 skill 的行为。
[ok] 无凭证 / 无业务 API 反查 — SKILL.md 与 reference 中无密钥、无 endpoint、无上传动作；`staticFile()` 指向项目内静态资源而非远端。判橙依据仅为远程包依赖，非凭据读取。
[ok] 帧驱动纪律的内部一致性 — SKILL.md 的输出契约、Before-you-finish 第 4 条与另两份文档的「no Date.now() / Math.random() / timers」主张互相一致，并与 Remotion 的逐帧快照渲染模型相符（帧驱动才可 seek、可复现）。
[ok] VO 数学与叙事两张表的自洽性 — SKILL.md 五拍表（讲「为什么与顺序」）与 Script formula 表（Problem 20% / Solution 15% / How 45% / Payoff 20%，讲「占比预算」）口径可对齐：How 占比最大对应「slowest — hold each step to read」；60s≈138 词与 2.3 w/s 自洽（60×2.3≈138）。
[ok] 跨目录 / 跨 skill 引用可解析性 — 正文引用的 `scripts/contact-sheet.sh`、`scripts/probe-mp4.sh` 位于仓库根（单装本 skill 目录会悬空，需装整个 repo）；把单场景网页动效分流到同 repo 的 diagram-animation，该 skill 确实存在于本 repo 的 skills/ 下，引用可解析。
[ok] 功能声明 vs 实际能力 — frontmatter 宣称覆盖 script→storyboard→scene build→narration/caption sync→edit→polish 全链，正文六步流水线与 reference 的模板/计时表/字幕规范逐项兑现；未见夸大——未声称能自动配音或自动剪素材。

6结论

把「改一句话 vs 重做一个场景」的成本差固化进流水线顺序（script-first），是整条流程最值钱的工程约束

叙事结构带「观众内心台词」列，使抽象五拍变成可检验的写作目标

时长可先算后建：VO 语速 + 呼吸量的公式化推导，避免边做边砍

字幕漂移有机制解而非原则提醒：切点与字幕共用同一计时数组

适合： 适合 30–90 秒、有旁白、需要字幕的产品/概念/流程解说片：从一句主张出发，要一条能把脚本、storyboard、场景、字幕、导出串起来的可复现流水线；尤其适合需要批量重渲染（换数据/换语言）与「先估时长再开工」的制作方式。

不适合： 不适合无旁白的纯视觉短片（应走 diagram-animation / isometric-animation / whiteboard-animation 等单场景层）；不适合长片或多幕叙事（本 skill 明确锚定 30–90s 单信息）；也不适合只为炫技的风格实验——它的每条规则都服务于「把一句主张讲清楚」。

Install Agent-Ready

① Verified Mirror 2026-09-28

Option A · Direct DownloadDownload explainer-video.tar.gz

sha256: ae5f4f77121acf12…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit 3e2d411b72.