remotion-video-skill (王树义)

五维评分

优秀点拆解

• 音频驱动时长 + 配置单一数据源：TTS 脚本用 ffprobe 实测每段音频时长并换算帧数，自动重写 src/audioConfig.ts，所有场景时长/起始帧/总帧数都从它派生，从根本上解决程序化视频的音画同步难题
• 踩坑经验表驱动 agent 避坑：SKILL.md 内嵌大量「问题|原因|解决方案」表和❌/✅对照代码（MiniMax 错误域名、Python f-string 写坏 TS、WebGL 上下文溢出、相机插值抖动、row/col 映射旋转 90 度、progress 未 clamp 等），agent 照抄正确写法即可一次成功
• 双方案降级链：MiniMax TTS（高质量克隆音色）首选、检测不可用自动退回零配置免费的 Edge TTS，用户不配任何 key 也能跑通全流程，上手门槛极低
• 长任务工程化：断点续作（已存在文件跳过）、失败保留已完成部分、幂等执行、实时进度回显、前台执行封装 render.sh，批量音频生成和渲染流程敢跑不慌
• 从能做到做好：整章 3Blue1Brown 风格指南（Why→What、逐步构建、语义化配色、探索式脚本模板）+ 过程动画组件库（StaggeredGroup/StepByStepCalc/ValueFlyIn/SlidingWindow 等），把高质量教程视频的隐性知识代码化

可复用的设计模式

• 「测量→生成配置→应用引用」数据闭环：外部资产用工具实测后自动重写项目配置文件，所有代码从配置派生，保证精确同步
• 降级链（fallback chain）：首选付费高质量方案，检测不可用自动退回免费方案，并写成明确决策流程
• 长任务工程化四原则：幂等跳过 + 原子失败 + 进度保留可续 + 实时进度回显
• 「错误写法 vs 正确写法 + 原因 + 口诀」对照表：踩坑经验结构化，比长篇叙述更适合 agent 消费
• 单一数据源（Single Source of Truth）配置：可变参数集中一个 config 文件，组件只读不写死

适用场景

边界与注意：依赖本地工具链（Node 18+/Python 3.8+/ffmpeg），缺一个就断链；Edge TTS 需联网、MiniMax 按字符计费；3D 场景受 WebGL 上下文限制需额外配置；SKILL.md 是教程型而非自动化 SOP，agent 需按文档手工组合命令；脚本中 SCENES 文本是占位符，每项目需人工替换讲解稿。