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外部依赖
| 类型 | 依赖 |
|---|---|
| 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风险提醒 风险提醒：橙色 · 评估后使用
风险提醒：橙色 · 评估后使用
- 渲染链依赖远程包并在本地执行项目代码 — `npx remotion …` 从 npm 取包并 bundle 执行；离线环境或私有 registry 场景需先本地锁定依赖，否则验证回路不可复现。
- 像素级验收仍靠人工 — 「字幕与当帧 VO 对齐」「文本不裁切」等均为视觉项，skill 只给检查单不给断言；批量产出时应自加帧级快照比对。
- 配音与素材来源在 skill 之外 — skill 只规定「VO 先写、计时进 props、用 `<Audio>` 承载」；实际 TTS/录音与版权归属由使用者负责，成片合规性不由本 skill 保证。
- 教学参数的锚定效应 — 2.3 w/s、20/15/45/20 占比、Inter 字阶是可复现起点，但套用到强节奏、无旁白或多语种场景会失真，需主动偏离。
- 同 pack 依赖悬空 — 验证脚本与另四个 skill 属同一 repo；单装本 skill 目录时 `scripts/` 与兄弟 skill 交叉引用都不可用。
风险提醒：橙色，评估后使用。判级对象是 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结论
适合：适合 30–90 秒、有旁白、需要字幕的产品/概念/流程解说片：从一句主张出发，要一条能把脚本、storyboard、场景、字幕、导出串起来的可复现流水线；尤其适合需要批量重渲染（换数据/换语言）与「先估时长再开工」的制作方式。
不适合：不适合无旁白的纯视觉短片（应走 diagram-animation / isometric-animation / whiteboard-animation 等单场景层）；不适合长片或多幕叙事（本 skill 明确锚定 30–90s 单信息）；也不适合只为炫技的风格实验——它的每条规则都服务于「把一句主张讲清楚」。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-28
方式 A · 人下载镜像包下载 explainer-video.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agentae5f4f77121acf12…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库iart-ai / iart-ai/explainer-video-skills
原始 GitHubiart-ai/explainer-video-skills ↗
Stars26
最近推送2026-06-22
本 skill commit
3e2d411b72许可MIT（仓库根 LICENSE：MIT License / Copyright (c) 2026 iart.ai；.claude-plugin/plugin.json 声明 "license": "MIT"，GitHub API license.spdx_id = MIT）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。