Remotion 视频制作
将源材料转化为连贯、可编辑的视频。使用 React 创作视频;从已保存的媒体文件渲染。遵循以下阶段,并根据用户的指示和现有项目进行调整。保留简明的制作记录,以便其他智能体无需重复决策即可继续工作。
1. 检查简报、素材和能力
确定受众、预期收获、交付格式、基调以及可用素材。区分源事实、编辑解读和未解决的信息;不要编造缺失的事实步骤、能力或结果。在将文档读入上下文之前,提取大型内联素材。在制作项目中保留源到场景的映射。
检查相关图像和录音,而不仅仅是文件名。注意构图、嵌入的标签、声音以及实际可见的动作。检查该智能体是否能检查图像、听取音频、运行代码以及提供用户可访问的预览。缺少感知能力需要使用 references/runtime.md 中的备用方案;脚本无法确定这些模型能力或替代人类判断。
对于现有的 Node 项目,可以选择运行 node <skill-dir>/scripts/doctor.mjs <project-dir>。它会列出依赖项清单,但不能证明渲染就绪。使用项目的包管理器和锁文件。当有可用的 Remotion 最佳实践技能时请遵循,否则遵循官方文档。
2. 提出方向并仅澄清有意义的疑问
给出一个推荐方向:受众/预期收获、大致时长和宽高比、场景推进、视觉风格和旁白方法。解释源材料和观看目的如何形成此方向。对于结构和风格选择,请参考 references/editorial.md。
当答案会改变事实内容、受众、方向或不可用素材的使用时,提出少数重点问题。不要重复已回答的问题,也不需要为每个项目都填写问卷。在等待期间继续独立工作;未解决的重大事实不得编造。如果可选的偏好未指定,则陈述合理假设并在用户的授权范围内继续进行。
3. 编写紧凑的故事板
对于每个场景,记录其目的、源证据、旁白文字、屏幕重点、预期的视觉效果/动态以及大致时长。保持旁白与标题和字幕的清晰区分。单独列出未解决的事实。将故事板视为编辑文档,而非新的编程语言。如果视觉效果或音频方向不确定,尽早测试一个具代表性的序列。
4. 准备媒体并测量时长
为每种媒体类型提供适当的适配器。语音请求和视频生成请求不需要共享相同的输入形状。将其结果标准化为已保存的文件和有价值的元数据,包括时长、尺寸、生成设置、来源,以及相关的归属要求。
在预览或渲染之前解决媒体生成问题。根据输入内容和有效的提供商设置缓存输出,并验证缓存文件。不要从 React 渲染函数或元数据评估中触发付费或非确定性生成。
对于旁白,在需要时将显示文本与发音文本分开。测量实际音频时长,然后为相关图像和文本留下足够的理解时间。在足够的情况下使用短语或句子计时。单词高亮需要可靠的时间戳或对齐;均匀分配字符不是准确的对齐方式。
对于现有的录音,保留或有意修剪原始声音,并从转录或听写中衍生出字幕。考虑场景偏移、音频引入、停顿和重叠转场。适配器、计时、缓存和修订合约请参考 references/pipeline.md。捆绑的可选辅助工具可提取内联图像并验证字幕范围;用法和限制见 references/runtime.md。
5. 使用普通的 React/TypeScript 实现
为重复的处理方式复用小组件,并允许使用任意 React 处理特定主题的场景。数据可以包含文本、媒体路径、计时、源引用和设计标记。仅在已知格式的重复输出证明其合理时才引入模板方案。不要为本地视频创建通用的时间线解释器、插件注册表或编排服务。
基于帧号驱动动画;避免使用挂钟定时器和不受控制的随机性。本地加载所需的字体和素材。样式可以改变排版、构图、动态、强调复制、节奏和音频;仅更改调色板不是完整的样式更改。当仅演示发生变化时,重用已批准的媒体和计时。
运行针对性的类型、素材、时长和字幕检查。仅在其文档化的计时合同下使用捆绑的 check-captions.mjs。测试应围绕可复用的计时/导入/缓存逻辑,而不是每个美观决策。当智能体编码能力有限时,优先使用现有组件和小型、已验证的更改。
6. 在花时间进行最终导出之前预览
当用户可以访问 Remotion Studio 时,优先使用它。展示合成并解释需要审查的内容:源保真度、风格、文本/主题裁剪、字幕可读性、动态和声音。在支持的情况下,自行检查具代表性的场景、边界和结尾。当用户要求在导出前审查时,提供预览并等待该审查,然后再进行最终导出。现有的批准或显式的渲染请求可以授权继续执行;不要添加无条件的确认门控。
如果交互式 Studio 不可用,则生成具代表性的静态帧,并在需要审查动态/音频时生成短视频的低分辨率草稿。远程环境的 localhost URL 可能对用户不可访问;提供可访问的预览或本地工件。静态帧不能确定动态或音频质量。应用 references/runtime.md 中的人工审查备用方案,并准确报告哪些内容已被审查以及哪些未被审查。
7. 导出、验证并交付
在任何请求的审查完成后,使用项目已安装的 Remotion CLI 进行常规导出。npx 命令见 references/runtime.md。仅在程序化集成或批处理值得使用时才使用渲染器 API。在修订时保留用户编辑并仅重新生成受影响的媒体。
检查导出文件的尺寸、帧率、时长、音频是否存在、首帧/末帧、字幕更改和场景边界。当可进行感知审查时,播放完整结果;否则确定剩余的人工审查。成功的渲染或音频解码不能确定编辑质量、正确发音或令人愉悦的混音。预览审查和最终文件验证是独立的证据。
交付可编辑的项目、预览/导出位置、重现命令以及简洁的状态报告:已实现、预览已检查、用户已审查、已导出、最终文件已检查。仅声明已完成的阶段。将制作记录与作品一起保留。
保持可重用指导与具体制作无关
技能和可分发的示例必须自包含且主题中立。将私有源文本、图像、音频、名称、链接、标识符、文件路径以及制作专属说明保留在制作项目中。不要将它们包含在可重用的技能、其元数据、参考文件、夹具或素材中。如果需要示例,请使用新发明的示例。
记录从制作中学到的方法和决策标准,但不要将其主题编码为通用要求。在共享或安装技能包之前,验证实际的技能包内容。