1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | remotion-upgrade-remotion-dev-skills |
| 作者/维护者 | Remotion（remotion-dev 官方团队，视频框架 Remotion 的所有者） |
| 来源链接 | https://github.com/remotion-dev/skills/tree/main/skills/remotion-upgrade |
| 许可证 | Remotion License（个人与小型公司可免费使用，达一定规模的商业机构需付费授权），条款位于主仓库 remotion-dev/remotion 的 LICENSE.md（本技能所在的 remotion-dev/skills 仓库自身不含 LICENSE 文件） |
| GitHub Stars | 4,206（合集仓库 remotion-dev/skills 整体数字，来自 GitHub API；不代表本技能自身热度） |
| Forks | 484（同上，合集整体） |
| 最新版本 | 4.0.506（SKILL.md frontmatter 标注，随 Remotion 框架版本同步发布） |
| 安装方式 | 见第 10 章 |
2. 功能介绍与亮点
Remotion 项目依赖一组会独立发版的包——remotion 核心包、多个 @remotion/* 子包，以及处理音视频的 mediabunny/@mediabunny/*。手工升级容易漏掉某个子包，或升级后版本互相不兼容。remotion-upgrade 把这套升级流程整理成一份可直接执行的操作手册：
- 优先走官方一键路径：先检查项目本地是否已装
@remotion/cli，有则直接运行npx remotion upgrade——该命令会一并把项目本地安装的其他 Remotion Agent Skills 也同步升级，无需再手动操作。 - 无 CLI 时的手动路径：用
npm view remotion version取得最新稳定版本号，逐个找出项目里已安装的remotion与@remotion/*依赖并统一升级到该版本，同时保留原有的 workspace/catalog 依赖写法不被破坏。 - 跨库版本兼容检查：手动路径下会额外读取官方 Mediabunny 兼容性页面，确定与目标 Remotion 版本匹配的 Mediabunny 版本，避免“Remotion 升级了但音视频处理库版本对不上”这类不易察觉的兼容性问题。
- 升级后自检：提示对比 manifest 与 lockfile 的 diff，确认所有 Remotion 包版本一致、Mediabunml 包版本落在兼容区间，并可选运行
npx remotion versions做二次核验；同时给出官方 Release Notes 链接方便了解具体变更。
3. 适用场景
所属分类：工程效率与代码质量（内容是升级项目自身依赖版本、检查跨包兼容性、复核 diff 的操作规程，围绕的是“维护项目代码/依赖”这件事本身，而不是视频动画的编码规范或内容产出，故不归入内容创作与知识管理）。
适用人群：已在用 Remotion 编写程序化视频、需要定期把 remotion/@remotion/*/mediabunny 等依赖包升级到最新稳定版的开发者；尤其适合多人协作或长期维护的 Remotion 项目，避免因为遗漏某个子包升级或版本不匹配导致渲染、Studio 预览等功能异常。
4. 跨 Agent 兼容性
| Agent 生态 | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方文档说明 Claude Code 兼容性通过将 .claude/skills 软链接到 .agents/skills 实现，技能以标准 SKILL.md 格式分发 |
| Codex | 原生支持 | 官方文档将 Codex 列为受支持的 AI 编程助手之一 |
| OpenClaw | 未验证 | 已抓取材料未提及 OpenClaw |
| Hermes Agent | 未验证 | 已抓取材料未提及 Hermes Agent |
5. 推荐理由
依赖升级看似简单，实际踩坑点很隐蔽：Remotion 由核心包加一串 @remotion/* 子包组成，手工升级极易漏掉其中一个导致版本错配；音视频处理库 Mediabunny 的兼容版本还需要对照官方页面单独核实，这一步很容易被忽略。remotion-upgrade 由框架官方团队直接维护，把“先查 CLI 是否可用→能用则一条命令搞定→不能用则手动逐包升级并核对 Mediabunny 兼容性→复核 diff”整理成一套可重复执行的流程，同时把项目里其他已安装的 Remotion 技能一并同步到最新版，减少了升级后出现“渲染正常但 Studio 编辑或字幕功能失效”这类隐蔽兼容性问题的概率。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 官方 Remotion 团队直接出品；第三方技能市场 skills.sh 显示本技能单独安装量约 2.05 万次（区别于合集整体安装量，是本技能自身的独立采用数据），且通过该平台 Gen Agent Trust Hub、Socket、Snyk 三项独立安全扫描 |
| 可用性 | 9 | 主路径为单条命令 npx remotion upgrade，且内置了较罕见场景（无本地 CLI）的完整手动步骤与外部文档链接；随 Remotion 主框架同步维护，个人与小型团队使用免费 |
| 安全性 | 8 | 见下方安全检查清单；手动升级路径会调用第三方安装器 npx skills update，该工具存在未完全解决的透明度问题（详见清单②） |
安全检查清单：
① 是否执行 shell 命令：会执行 npx remotion upgrade、npm view、包管理器安装命令等，范围限定在当前项目自身依赖版本的查询与升级，均为标准 npm/npx 操作
② 运行时是否联网外发数据：手动路径的第 4 步会调用第三方安装器 npx skills update ... --yes 来同步升级已安装的技能——该工具存在两个尚未修复的公开 issue，分别指控其在未明确告知的情况下上传使用数据、以及审计上报机制不完全受禁用开关约束；主路径（本地已装 @remotion/cli 时）不会触发这一步
③ 是否要求 API key/凭据：不涉及
④ 可疑指令：未发现
⑤ 作者/组织信誉：Remotion 官方团队，公开身份明确，无刷星或造假迹象
⑥ License：Remotion License，条款明确（个人/小型公司免费，规模企业需付费）
⑦ 最近维护时间：所属仓库最近一次提交为近日，在近 3 个月维护窗口内且频率高
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
同合集的 remotion-docs |
教开发者用 Algolia 搜索 API 检索并抓取最新 Remotion 官方文档页面，避免依赖记忆中可能过时的 API 知识 | 是一个“查资料”的通用技巧，不直接改动项目文件；remotion-upgrade 是“改依赖版本”的操作规程，两者服务于不同阶段的需求 |
同合集的 remotion-studio |
教如何启动 Remotion Studio 预览服务器并说明常用命令行参数 | 内容集中在预览环节的单条命令与参数速查；remotion-upgrade 面对的是升级路径分叉（CLI 可用与否）与跨包版本兼容判断，覆盖的决策分支更多 |
| 通用依赖升级工具（如 Renovate、Dependabot） | 面向任意语言/框架的自动化依赖更新机器人，通常以 PR 形式提交升级 | 是通用型工具，不了解 Remotion 与 Mediabunny 之间的版本兼容对照关系；remotion-upgrade 是官方针对该框架特定升级路径整理的操作指南，能覆盖通用工具触及不到的跨库兼容检查环节 |
8. 用户评价
该技能目前在第三方平台尚无专门针对升级功能本身的具名用户评价。skills.sh 收录的独立安装量数据（约 2.05 万次）反映其在已安装 Remotion 技能矩阵的开发者中有较高的实际使用比例。
9. 其他补充
remotion-upgrade 与同仓库的 remotion-docs、remotion-studio 等技能同属官方 Remotion Agent Skills 矩阵，随 Remotion 主框架版本同步发布与维护，是该技能矩阵中负责“保持工具链与技能自身版本一致”的组成部分。
10. 安装使用方式
- 手动复制（推荐）：将
remotion-dev/skills仓库中skills/remotion-upgrade/目录克隆或下载后，复制到 Claude Code / Codex 的技能目录（如.claude/skills/remotion-upgrade/） - 官方一键安装：运行
npx skills add remotion-dev/skills安装整套 Remotion 技能合集（含本技能），或在新建 Remotion 项目时运行bun create video并按提示选择安装技能 - 安装后注意事项：安装后无需重启 agent；提出“升级 Remotion”或“更新 Remotion 相关依赖”类需求时会被自动匹配，也可用
/remotion-upgrade显式触发；使用前需已有可运行的 Remotion 项目环境（Node.js + 现有 Remotion 依赖）
11. 注意事项
- Remotion License 为个人/小型公司免费、达一定规模的商业机构需付费授权的双层许可，不是完全宽松的开源许可证，企业用户使用前应自行核实是否需要购买商业授权
- 手动升级路径（本地无
@remotion/cli时）会调用第三方安装器npx skills update同步升级已安装技能，该工具存在两个尚未修复的公开 issue（未明确告知情况下上传使用数据、审计上报机制不完全受禁用开关约束）；本地已安装@remotion/cli的项目走主路径npx remotion upgrade即可避开这一步 - 合集仓库整体 4,206 星与 484 forks 属整个 remotion-dev/skills 技能矩阵，不代表本技能自身的独立采用热度
- 升级操作会修改项目的 package manifest 与 lockfile，建议在版本控制下执行并在升级后核对 diff，而非直接信任自动化结果