Technical Explainer Video

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

# 知识演示 / 教学视频

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

## 通用制作规则

- **公式用 LaTeX**：公式、分式、向量、矩阵、上下标和代入计算通过数学渲染器排版，不用普通文本拼接。中文解释与变量标签单独排版；数值、单位、近似号与几何计算一致。
- **字幕数值用阿拉伯数字**：数量、测量值、版本、尺寸、范围、负数、百分数优先写作 9、1.4、11×5、−6、1.35%。自然词语如“三维”“最小二乘”和逐字引用按语义保留。显示文字与口播读法分开保存，禁止对中文数字做无上下文的全局替换。
- **口播说人话**：直接讲对象、动作、结果和原因，减少无信息的预告、总结和生硬转折。用户要求“说人话”且该技能可用时，读它并逐段润色；保留数字、条件和因果，不按禁词清单机械改句。没有该技能时也按本条编辑，不将其作为必需依赖。
- **按理解顺序分章**：先解释输入、坐标和前置概念，再讲变换、逐项计算、汇总和结果解释。不同特征各自说明取哪些数据、关键几何、公式、单位和统计方式；不把所有新概念挤在一幕。
- **图形随讲解变化**：3D 用来表达空间关系，2D 用来表达投影、变换、曲线和统计。逐点选取、连线、投影、作垂线、显示角弧，再代入计算；当前对象高亮，其余淡化。需要时放大或切正交视图，避免射线、透明平面和标签互相遮挡。
- **分清推导方向**：先确认哪些量足以决定结果。标明投影丢失的信息、补充条件、符号和退化情况；不把两个相关指标画成互相唯一决定，也不把投影角默认当作欧拉角。
- **减少无用文字**：保留短章节名、必要变量/单位、图、公式和字幕。字幕放独立安全区，默认写入视频像素；外挂 SRT/VTT 不重复开启。

## 工作流程

### 1. 定内容与证据

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

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

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

### 2. 文案、配音和时间线

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

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

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

### 3. 实现并交付

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

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

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

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

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

## 附件的用途

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