agentleFS
wangyendtwangyendt/wayne-skills/technical-explainer-video/SKILL.md

technical-explainer-video

Skill9 starsChanged 9 months agoMITView on GitHub

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

The file

Files
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。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.