technical-explainer-video

v2026.09.24

制作或修改算法、数学、物理及其他知识的教学动画视频,用清晰的几何或图解、LaTeX 公式、自然配音和同步字幕交付实际 MP4 与可编辑工程。适用于知识讲解、计算演示、分镜和成片修改。

GitHub
Install command
npx skhub add wangyendt/technical-explainer-video
Markdown
SKILL.md

知识演示 / 教学视频

交付观众能跟着推导和操作的实际视频。延续用户已确认的风格、语言和参数;知识主题、章节数、坐标约定、阈值和数据均来自本次任务,不沿用旧视频的业务设置。

独立使用与可选增强

本技能独立完成视频制作,不依赖其它 skill。当前环境提供的技能列表中若有 awesome-docs,复杂内容组织可按需参考;若有 shuorenhua,口播文案可按需润色。通过列表提供的实际路径读取,不假定相邻目录或固定安装位置。缺失或所需参考文件不存在时,跳过增强,按本技能继续;不扫描其它 agent 的安装目录,不触发安装、更新或安装提示。用户明确点名的技能未能加载时,简短说明,不声称执行过它。

视频讲解与画面规则

  • 按观众理解顺序分镜:先交代问题、输入和必要概念,再演示变化、计算和结果。每幕聚焦一个问题,保留中间推导,不把文档段落逐页搬进视频。
  • 画面与旁白分工:旁白解释当前对象发生什么、为什么;画面展示关键点、线、面和数值变化。避免旁白已经进入下一步,画面还停在上一步。画面保留短标题、必要标注、公式和字幕,删去重复说明。
  • 公式用 LaTeX:图内外的公式、分式、向量、矩阵和上下标通过数学渲染器排版;动态替换和最终导出后仍要检查。中文解释单独排版,变量、单位、符号和几何计算保持一致。
  • 字幕数值用阿拉伯数字:数量、测量值、版本、范围和百分数采用阿拉伯数字;自然词语和逐字引用保留。显示 text 与朗读 speech 分开保存,不做无上下文的中文数字替换。字幕放独立安全区,默认烧录进视频,避免与外挂字幕重复显示。
  • 图示服务于解释:空间关系用 3D,投影、曲线和流程按需用 2D。先说明原点、参考系和对象,再随讲解高亮关键几何;其它必要对象淡化保留。放大或转动视角不改变测量值;相机视角与场景内的物理相机分开标识。
  • 口播直接、准确:讲清对象、动作、条件和结果,删去空泛预告及重复总结;保留事实、术语、数字和不确定性,不按禁词表机械改句。通读时检查前提是否先于结论,观众能否跟着当前画面理解旁白。

工作流程

1. 定内容与证据

先找现有工程。修改成片保留旧版;只改字幕时不顺带改算法或数值。区分用户指定值、来源值、推导值和教学构造值;未知参数明确标注。材料制作不修改生产代码、配置或设备状态。

每幕记录:观众要弄懂的问题、前置概念、输入/输出、选用数据、图形动作、公式、显示字幕和口播。先检查整条推导与因果,再写动画。涉及补偿或控制时,区分预测、实际执行、重新测量和判据;其他知识按自身逻辑组织。

几何或计算密集任务按需读 references/geometry-and-reasoning.md。

2. 文案、配音和时间线

先通读并润色整份文案,再生成语音。每段显式保存显示文字 text 与朗读文字 speech;数字展开只改变读法,不改变数值、单位、正负或版本含义。

采用真实词边界或有记录的强制/人工对齐,生成字幕时间。字幕和关键动画共用时间线;改旁白后重新生成失效音频和边界,更新事件锚点。仅改等义显示格式时可复用未变的口播缓存,仍须重建字幕。

新工程、字幕数据结构、语音服务、导出和验证按需读 references/production.md。

3. 实现并交付

优先复用已有工程,不强制换框架。无工程时可用随附 Motion Canvas / Three.js 起点:

python3 SKILL_DIR/scripts/scaffold.py /absolute/path/to/video-project

该脚手架只复制文件并生成静音排版样本;正式配音、依赖安装和渲染另行执行。默认 1080p / 30 fps,可随任务调整。

交付前检查计算不变量、渲染日志、最终 MP4 音视频和字幕;抽查最终解码帧中的关键动作及公式,不只检查网页或静态分镜。人工视听抽查与自动像素/音频检查分开记录,不夸大覆盖范围。

返回实际 MP4,按需附章节播放器、字幕与可编辑源工程。Codex 中用绝对路径媒体嵌入展示。打包排除运行时、临时大文件和敏感配置;不默认发布、提交、推送或全局安装。

附件的用途

SKILL.md 是唯一必需文件。此技能额外保留 2 份按需参考文档、1 个复制脚本、1 份界面元数据和 19 个可运行模板文件。模板中的依赖锁、渲染入口、音频对齐和验证代码用于复现,使用现有工程时无需读取或复制它们。具体业务视频、测量数据、成片、缓存和制作日志留在项目里,不放进通用 skill。

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

technical-explainer-video

Default branch

main

Latest commit

9f913bc

Tree SHA

57134bd