Shrimer06/remotion-video-superpowers

Remotion 视频超能力

使用该技能时，请遵循“规范 → 计划 → 执行 → 验证”的流程来运行 Remotion 视频制作。对于非简单的视频，不要直接跳入动画编码。

工作流

1. 创建或更新视频规格文档后再开始实现。

   • 阅读 references/writing-video-specs.md。
   • 在项目中可行的前提下，将规格文档保存至 docs/video/specs/YYYY-MM-DD-项目名称.md。
   • 捕获目标、非目标、受众、视觉方向、素材、画外音需求、约束条件和验收标准。

2. 创建或更新制作计划。

   • 阅读 references/writing-video-plans.md。
   • 在项目中可行的前提下，将计划保存至 docs/video/plans/YYYY-MM-DD-项目名称.md。
   • 使用复选框任务。每个任务必须列出文件、步骤、验证方法和停止条件。

3. 在开始动画实现之前完成素材收集。

   • 阅读 references/asset-sourcing.md。
   • 收集并记录产品素材、品牌素材、UI 参考、截图、3D 模型、地图/地理空间资源、服务令牌/环境变量名称、音频参考、许可证、归属信息、本地路径和备选方案。
   • 在所需素材本地可用或明确记录备选方案之前，不要开始场景动画。

4. 按计划逐任务执行。

   • 在编辑 Remotion 代码之前阅读 references/remotion-scene-execution.md。
   • 当视频包含 Web UI、产品界面、仪表盘、前端风格动画、Three.js、Anime.js 或复杂动画编排时，阅读 references/frontend-animation-system.md。
   • 当视频需要地图、路线、城市、地形、建筑物、地标、数字孪生、设备、航天器、真实世界 3D 对象或基于令牌的服务（如 Mapbox/Cesium ion）时，阅读 references/3d-map-and-model-resources.md。
   • 使用 useCurrentFrame() 和 interpolate() 进行可跳转式动画。
   • 避免 CSS 过渡和不可确定的运行时动画。
   • 保持场景文字简洁；将解释部分移至画外音。
   • 在最终渲染前，在场景开始、高峰和过渡点渲染静态画面。

5. 将画外音作为一流的时间线源来处理。

   • 在编写 ElevenLabs v3 脚本之前阅读 references/elevenlabs-v3-scripting.md。
   • 在导入、同步或混音音频之前阅读 references/audio-sync-and-muxing.md。
   • 使用本技能的 scripts/inspect-audio.sh 检查实际音频时长。
   • 优先调整场景时长以匹配最终画外音，而不是裁剪音频。

6. 交付前进行最终质量检查。

   • 阅读 references/qa-checkpoints.md。
   • 在可用时运行项目 lint/类型检查。
   • 使用本技能的 scripts/render-checkpoints.sh 或显式 npx remotion still 命令渲染检查帧。
   • 渲染最终的 MP4 文件。
   • 当音频可靠性重要时，使用本技能的 scripts/mux-voiceover.sh 混入画外音。
   • 使用 ffprobe/ffmpeg 验证时长、音频流和音量。

超能力规则

• 将规格文档视为真理之源。如果实现与规格冲突，更新规格或停下来询问。
• 将计划视为可执行文件。在验证通过之前，不要将任务标记为完成。
• 在影响最终视频质量的验证失败时立即停止：失败的 lint、不可读的文字、重叠的场景、缺失的音频、时长不匹配或关键画面空白。
• 对于修订，先确定受影响的场景和帧范围，渲染前后静态画面，然后仅修补必要的代码。
• 保留用户提供的媒体。有目的地复制或引用它；不要覆盖源文件下载。
• 除非用户明确要求屏幕导览，否则不要将截图作为推广视频的主要视觉语言。将产品想法转化为运动隐喻，并将截图作为证据、过渡或简短的产品证明使用。

参考文档路由

• 需要设计视频：阅读 writing-video-specs.md。
• 需要规划实现：阅读 writing-video-plans.md。
• 需要收集产品素材、模型素材、截图、令牌、许可证或参考：阅读 asset-sourcing.md。
• 需要编写 Remotion 场景或过渡：阅读 remotion-scene-execution.md。
• 需要设计丰富的前端风格动画：阅读 frontend-animation-system.md。
• 需要地图、3D 城市/地形、路线或外部 3D 模型：阅读 3d-map-and-model-resources.md。
• 需要画外音脚本，尤其是 ElevenLabs v3：阅读 elevenlabs-v3-scripting.md。
• 需要对齐 MP3/WAV 音频或修复“无声”问题：阅读 audio-sync-and-muxing.md。
• 需要检查最终质量：阅读 qa-checkpoints.md。

从项目目录运行捆绑脚本时，请使用本技能 scripts/ 目录的绝对路径，除非存在等效的项目本地脚本。