Remotion 版本升级
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/remotion-dev-skills-remotion-upgrade。
技能介绍
问题背景
Remotion 主版本或小版本升级时,remotion、@remotion/* 往往分散在多个 workspace,版本不一致会导致编译失败、渲染 API 行为变化,甚至被锁文件「钉死」旧版本。Mediabunny 与 Remotion 有官方兼容矩阵,只升 Remotion 而忘记 Mediabunny,常见问题会在 CI 或本地 npx remotion 时才暴露。
技能如何工作
技能会先读 manifest 与 lockfile,确认包管理器(npm/pnpm/yarn 等)以及 monorepo / workspace 布局,并尽量不改动无关依赖。
若项目已安装 @remotion/cli,优先走 CLI 升级路径,并同步更新项目内的 Remotion 相关 skills,可跳过手搓改版本号。
没有 CLI 时按文档执行手动流程:用 npm view remotion version 取最新稳定版,在全仓检索并统一升级所有 remotion 与 @remotion/*;查阅当前 Mediabunny 兼容页,把已安装的 mediabunny 与 @mediabunny/* 升到文档要求的版本;再执行包管理器刷新锁文件。必要时还会更新已安装的 Remotion skills。
收尾阶段对照 manifest / lockfile diff,确认 Remotion 全家桶单一版本、Mediabunny 为兼容版本;有 CLI 时可额外运行 npx remotion versions 做交叉校验,并可结合 release changelog 归纳本次升级影响面。
适用边界
技能面向依赖与锁文件层面的版本对齐,不替代你跑完整回归测试或改 Breaking Change 的业务代码。多包管理器混用、非标准 catalog 约定或自定义 fork 包名时,仍需人工核对 diff。CLI 不可用场景下,Mediabunny 兼容信息必须以官方当前页面为准,不能凭记忆拍版本号。
使用场景
- Monorepo 里多个包各自锁了不同 Remotion 版本,发版前要对齐 manifest 与 lockfile
- 跟进 Remotion 新稳定版后,需按官方表同步升级 Mediabunny 相关依赖
- CI 因 @remotion/* 版本不一致失败,要在本地统一版本并复核 diff
- 项目未装 @remotion/cli,需按 SKILL 流程手动改依赖并更新 Remotion skills
适合人员
- 维护 Remotion 视频模板的工程同学,大版本升级时要一次性对齐全仓 @remotion/*
- 在 pnpm/yarn workspace 里接 Remotion 的前端,发版前怕锁文件里残留旧版渲染依赖
- 自建 CI 跑 `npx remotion` 的 DevOps,升级后主包与 Mediabunny 版本不对导致流水线红
- 给团队写 Remotion 脚手架的维护者,升级后要顺带刷新项目内 Remotion skills