Remotion 开发最佳实践
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/remotion-dev-skills-remotion-best-practices。
技能介绍
要解决什么问题
用 Remotion 做程序化视频时,任务会散落在「从零建项目」「写 React 组合」「加地图/字幕」「浏览器里裁切素材」「Lambda 批量渲染」等不同文档与习惯里。对话里如果每次都从零搜 API,容易漏步骤,或在用户已改过的代码上被助手误覆盖。
技能如何工作
本技能本质是 路由表:根据你的意图,提示助手加载对应的 Remotion Agent Skill,而不是在同一套说明里硬塞全部主题。
核心分流包括:
- 新建与工程:无项目时走「Create a new Remotion project」;要做新 composition/成片时走「Create a new Remotion video」。
- 画面与交互:写 Remotion React 标记用 Remotion Markup Best Practices;要在 Studio 里改参数并回写代码用 Interactivity Best Practices。
- 地图与多媒体:静态/动画路线、GeoJSON、Mapbox/MapLibre/MapTiler 等走 Remotion Maps;浏览器内裁切、取元数据等走 Remotion Multimedia。
- 产出与运维:复杂
npx remotion render以外看 Rendering Best Practices;开 Studio 看 Remotion Studio;字幕用 Remotion Captions;SaaS/Lambda/Vercel/Express 等用 Remotion SaaS;查官方 API 用 Remotion Docs;升版本与 Mediabunny 兼容用 Remotion Upgrade。
另有 Preserve user changes:发现对话外已有意外改动时,不擅自覆盖,默认视为有意修改或先确认。
适用边界
它不替代各子技能的具体实现步骤,只负责「该用哪一本说明书」。子技能未安装或 SkillHub 未配置时,路由提示无法落地;纯 Remotion 之外的通用 React 前端问题也不在其分工内。
使用场景
- 已有 React 仓库,要在其中新增 Remotion composition 并需要选对「建项目」还是「建视频」子技能
- 在组合里集成 Mapbox 路线动画或 GeoJSON 图层,需要切换到 Remotion Maps 相关实践
- 要把预览站打成 SaaS,在 Lambda 或 Vercel 上跑渲染管线,需按意图加载 Remotion SaaS
- 升级 Remotion 主包与 Mediabunny 依赖,并同步更新已装的 Agent Skills 文档
适合人员
- 用 Remotion 做数据可视化短视频、需要按任务切换地图/字幕/渲染文档的前端工程师
- 维护公司内部 Remotion 模板库、要避免助手覆盖同事在 Studio 外手改代码的视频工具开发者
- 准备把浏览器预览接到 Express 或边缘函数批量出片的 SaaS 原型负责人
- 从 Remotion 3.x 迁到新版本、要查官方 API 并对照 Upgrade 清单的维护者