Agent Skills
返回列表
💻

Remotion 版本升级

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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