Communitygithub.com

解释器视频技能(地狱男爵)

为技术主题制作2-3分钟竖屏(9:16)解释视频,面向非技术观众,由卡通建筑师“地狱男爵”主持,风格参考源素材(章节跟踪器、建筑图、卡拉OK字幕、唇同步角色、印地语英语配音)。

解释器视频技能(地狱男爵) 是什么?

该技能专为自动生成技术解释视频而设计,输出格式为1080×1920 MP4,时长2-3分钟。其核心工作流程包括:创建项目脚手架、编写脚本和故事板、验证、预览和质量检查(QA),最后渲染。视觉和叙事风格严格遵循参考源分析(`docs/01-style-bible.md`),但角色(地狱男爵)和配音是固定的。脚本遵循7节拍结构(钩子-张力-路线图-主体-转折-回顾-妙语),每句对应屏幕上的一个视觉变化。场景使用多种类型,地狱男爵出现在40–70%的场景中。该技能通过命令行工具(`engine/make_video.py`)执行,支持批量生成,并包含针对小型本地模型的分步策略(`docs/07-small-model-playbook.md`)。它非常适合需要快速、一致和高质量技术解释视频的内容创作者、教育工作者和营销人员。验证器确保零错误后才渲染,最终视频输出到`output/<slug>.mp4`。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bhuvanchandmaddi/video-generator-skill/tree/HEAD/skills/explainer-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

解释器视频技能(地狱男爵) 是做什么的?

你将一个技术主题转化为一个完成的2–3分钟1080×1920 MP4视频,让非技术人员一看就懂。视觉风格、节奏和脚本结构都源自一个参考频道(在 docs/01-style-bible.md 中分析)。两样东西是我们有意为之的:角色(地狱男爵) 和配音。

你只需编写文本文件(一个脚本和一个 storyboard.json)。engine/ 中的引擎负责配音、字幕、动画、角色、音乐和渲染。


当用户只给出一个主题时

直接完成全部工作,无需追问:

  1. 根据主题创建一个slug(如 how-dns-works),然后运行 python engine/make_video.py new videos/<slug>。
  2. 编写 videos/<slug>/script.md(参考 docs/02)和 videos/<slug>/storyboard.json(参考 docs/03 + docs/04)。复制 examples/upi-explained/ 中的模式。
  3. 运行 python engine/validate_storyboard.py videos/<slug>。修复每个 ERROR,重复直到打印出 0 error(s)。
  4. 运行 python engine/make_video.py preview videos/<slug>。如果你能看到图片,对照 docs/06 第B节检查 build/preview.png 并修复。
  5. 运行 python engine/make_video.py render videos/<slug>。回复路径 output/<slug>.mp4、时长和两行摘要。

不可妥协事项

  1. 地狱男爵永不重绘。 他只来自 character/hellboy/hellboy.js。你可以设置 show、arm(down/point/explain)和 expression,其他不能动。读一遍 character/hellboy/CHARACTER_BIBLE.md。
  2. 配音是固定的,在 engine/config.json 中。不要针对每个视频更改。
  3. 长度:360–470个旁白词,2:00–2:50。 句子≤20个词。
  4. 每句话都改变屏幕上的内容。 项目在对应的关键词("at")处出现。
  5. 正确优于复杂。 通过省略内容来简化,绝不说假话。
  6. 验证器必须通过(0 errors) 才能渲染。

工作流程(按顺序执行)

#步骤阅读输出
1搭建框架–python engine/make_video.py new videos/<slug>
2规划并编写脚本docs/02-script-writing.mdvideos/<slug>/script.md(360–470词,7个节拍)
3规划视觉docs/03-visual-planning.md场景列表:旁白 → 类型、标题、角色
4编写故事板docs/04-storyboard-reference.mdvideos/<slug>/storyboard.json(或 meta.json + scenes.jsonl → assemble)
5验证–python engine/validate_storyboard.py videos/<slug> → 修复直到0错误
6预览 + QAdocs/06-qa-checklist.mdmake_video.py preview videos/<slug> → 检查 build/preview.png,修复
7渲染docs/05-production.mdmake_video.py render videos/<slug> → output/<slug>.mp4
8最终QAdocs/06-qa-checklist.md分数≥85,所有MUST项通过

小型/本地模型? 按照 docs/07-small-model-playbook.md 替代步骤2–5。它把工作分解为一次一个场景的提示。

7节拍脚本(记住)

钩子(≤22词:“X解释。” / “X实际上如何工作?” / 惊人声称 / relatable动作)→ 张力(谜团)→ 路线图(“让我们跟着……”)→ 主体(3–6章:概念 → 通俗含义 → 日常例子 → 结果;一个带有人名的运行例子)→ 转折(“但有趣的部分是……”)→ 回顾(“所以这样记住它。”每章一句)→ 妙语(呼应钩子的片段:“一次扫描。四个参与者。两秒钟。”)。

场景配方(记住)

  • 1个场景 = 1–3句话(8–28词,3–8秒);每个视频20–32个场景。
  • 从 docs/03-visual-planning.md 的决策表中选取 visual.type。每个视频使用7–12种不同类型的场景。
  • 在40–70%的场景中显示地狱男爵(始终:第一个场景、转折点、回顾、最后一个场景)。对于 sequence、hub、diagram、compare 类型隐藏他。
  • 通过2–4个场景构建大图,使用 "continue": true + "shown": true 项和相同的标题。
  • 标题2–6个词,带一个 *重音* 词。屏幕上标签1–4个词。

命令(从仓库根目录执行)

# 首先激活:  source .venv/bin/activate   |   Windows: .\.venv\Scripts\Activate.ps1
python engine/make_video.py new       videos/<slug>   # 模板
python engine/make_video.py assemble  videos/<slug>   # meta.json + scenes.jsonl -> storyboard.json
python engine/validate_storyboard.py  videos/<slug>   # 必须0错误
python engine/make_video.py preview   videos/<slug>   # build/preview.png(每个场景一帧)
python engine/make_video.py render    videos/<slug> [--fast]

第一次在某台机器上运行:./setup.sh(Linux/macOS)或 setup.ps1(Windows)。完成的视频放在 output/<slug>.mp4。

参考资料

  • examples/upi-explained/(暖纸风格)和 examples/load-balancer-explained/(蓝图风格)——完整的示例作品。复制他们的模式。
  • templates/——script.template.md、storyboard.template.json。
  • docs/01-style-bible.md——参考频道的做法及度量(规则存在的原因)。
  • engine/icon_names.txt——所有2,359个允许的图标名称(Lucide)。

相关技能