关于 remotion-best-practices
一组用于 Remotion 项目的 Agent 指引，涵盖视频创建、编辑、渲染和故障排查。它会引导 Agent 加载相应任务技能，并强调保留用户改动及检查 Studio 预览。
主要功能
- 01引导使用专门的 Remotion 技能
- 02保留意外出现的用户改动
- 03视频与项目创建指南
- 04Studio 预览工作流
- 05Codex 中的 Studio 故障排查
适用场景
- 01创建或编辑 Remotion 视频
- 02选择地图或多媒体任务指南
- 03在 Codex 中检查 Studio 预览
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/remotion-best-practices确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
agents/openai.yamlremotion-captions/import-srt-captions.mdREFERENCE.mddisplay-captions.mdtranscribe-captions.mdremotion-captions/agents/openai.yamlremotion-create/video-layout.mdtailwind.mdREFERENCE.mdremotion-create/agents/openai.yamlremotion-docs/REFERENCE.mdremotion-docs/agents/openai.yamlremotion-interactivity/REFERENCE.mdremotion-interactivity/agents/openai.yamlremotion-maps/REFERENCE.mdremotion-maps/agents/openai.yamlremotion-maps/techniques/cesium/TECHNIQUE.mdremotion-maps/techniques/cesium/assets/cesium-path.jsoncity-path.jsonflight-path.tssample-river.geojsonremotion-maps/techniques/cesium/references/3d-data-sources.md3d-flyover-architecture.md3d-troubleshooting.mdremotion-maps/techniques/cesium/scripts/prep-cesium-path.mjsremotion-maps/techniques/mapbox/TECHNIQUE.mdremotion-maps/techniques/mapbox/references/render-stability.mdremotion-maps/techniques/maplibre/references/render-stability.mdremotion-maps/techniques/maptiler/TECHNIQUE.mdremotion-maps/techniques/maptiler/assets/MapTilerVectorElement.ts详细介绍
保留用户的更改
用户可能会在对话之外编辑代码。
如果你发现期间出现了意外更改，请勿覆盖；应假定这是有意为之，或征求确认。
创建视频
如果用户要求制作、创建或构建新视频或合成，请加载 创建新的 Remotion 视频，无论是否已存在 Remotion 项目。
新项目设置
如果当前不存在 Remotion 项目，请加载 创建新的 Remotion 项目
React 标记最佳实践
如果你要编写 Remotion React 标记，请加载 Remotion 标记最佳实践
地图
对于静态地图、动画路线和标记、地理解说、Mapbox、MapLibre、MapTiler、GeoJSON 或 3D 地理飞行效果，请加载 Remotion 地图。
多媒体
对于在浏览器中处理多媒体任务，例如剪辑、裁剪视频或获取视频元数据，请加载 Remotion 多媒体
改进交互性
通过妥善组织 Remotion 标记，我们可以让用户在 Studio 中交互式地更改内容，并将更改写回代码。如有需要，请参阅：交互性最佳实践
渲染
如需了解超出简单 npx remotion render 的高级渲染，请参阅：渲染最佳实践
打开 Remotion Studio
创建或编辑视频时，请启动 Studio，并在项目可以运行后立即打开预览，然后再构建合成。工作期间请保持 Studio 打开，让用户查看更改并提供指导。
要在 Remotion Studio 中启动项目，请打开其确切的本地 URL，或配置 Studio CLI 标志，并加载 Remotion Studio。
字幕
处理字幕时，请加载 Remotion 字幕。
创建 SaaS、自动化工具或应用程序
如需了解由 Remotion 驱动的 SaaS 应用（例如 <Player>、在 Lambda、Vercel、Cloudflare 上进行渲染、通过 Express.js 渲染、客户端渲染，或查找合适的 SaaS 模板），请使用 Remotion SaaS 技能。
查找 Remotion API 和文档
如需查找和阅读最新的 Remotion 文档，请加载 Remotion 文档。
升级
如需升级 Remotion、相关软件包、兼容的 Mediabunny 软件包和已安装的 Remotion Agent Skills，请加载 Remotion 升级。
Codex 故障排除
在 Codex 中运行时，请先尝试启动 Remotion Studio，但不要打开系统浏览器：
npx remotion studio --no-open
在 Codex 内置浏览器中打开打印出的确切 URL，并确认 Studio 已加载。合成存在后，请确认其视频预览已加载。如果无法在其中打开，请运行 Studio 时加上 --no-open。
仅当因文件监视器限制而失败（例如 EMFILE: too many open files, watch）时，才使用轮询方式重试，并且不要从 Codex 打开浏览器：
npx remotion studio --no-open --webpack-poll 1000
重试后，在 Codex 内置浏览器中打开打印出的确切 URL，并确认 Studio 已加载。合成存在后，请确认其视频预览已加载。如果无法在其中打开，请使用 --no-open 重试。
如果 Studio 仍无法从 Codex 启动，请让用户在 macOS Terminal 中手动启动，然后继续使用已经运行的 Studio。从 Codex 启动 Chromium 时出现的沙盒错误，很可能是由 Codex/macOS 沙盒导致的，而不是 Remotion 项目本身。