codex-video-use 是做什么的？
Codex 原生视频编辑技能，每日上游同步——专为智能体设计的短视频编辑循环。
概述
本技能为 Codex 兼容的智能体（如 Claude Code、Cursor、Codex CLI）提供了直接调用视频编辑操作的能力，无需手动操作专业编辑软件。它封装了常见的短视频编辑任务，包括剪切、拼接、转场效果、标题叠加以及导出优化等，并以标准化的工具接口暴露给 AI 代理。
功能特性
- 智能体驱动编辑：通过自然语言描述或结构化参数，智能体可直接执行视频编辑操作。
- 每日上游同步：技能自动与上游代码仓库同步，确保最新的编辑算法和修复立即可用。
- 短视频优化：针对短视频（如 Reels、Shorts、TikTok 等）的格式和时长做了专门优化，包括自动裁剪、比例调整和关键帧标记。
- 命令行集成：提供简洁的 CLI 命令，便于在开发环境或 CI/CD 流水线中调用。
- 回退与预览：支持编辑操作的预览和撤销，智能体可在生成最终版本前进行验证。
快速开始
前提条件
- 安装 Codex CLI 或兼容的 AI 代理工具。
- 确保系统已安装
ffmpeg（版本 4.2+）并可在 PATH 中访问。 - 视频文件存储在本地或可通过 URL 访问。
安装技能
# 在与智能体工作区关联的目录中克隆或链接技能
codex skills install AxelkHellberg/codex-video-use
基本用法
智能体可接收如下指令：
"将 input.mp4 从 00:00:10 剪切到 00:00:20，并输出为 output.mp4"
或者通过结构化 JSON 调用：
{
"action": "trim",
"input": "input.mp4",
"start": "00:00:10",
"end": "00:00:20",
"output": "output.mp4"
}
API 参考
该技能暴露以下主要操作（作为智能体可调用的工具/函数）：
| 操作 | 描述 | 必要参数 |
|---|---|---|
trim | 剪切视频片段 | input, start, end, output |
concat | 拼接多个视频 | inputs: [], output |
scale | 调整视频尺寸与比例 | input, width, height, output |
overlay | 叠加文字或图片水印 | input, overlay_type, text/path, output |
export | 导出为指定格式 | input, format (mp4/mov/gif), output |
配置
通过环境变量自定义行为：
VIDEO_EDIT_WORK_DIR：工作目录（默认：当前工作目录）VIDEO_EDIT_PRESET：预设配置名称（如social-tall,landscape-hd）VIDEO_EDIT_SYNC_INTERVAL：上游同步间隔（分钟，默认：1440）
示例
示例 1：智能体自动拼接广告片段
用户："将 intro.mp4, middle.mp4, outro.mp4 拼接成一个广告视频"
智能体：调用 concat 操作，生成 ad.mp4
示例 2：批量缩放并添加水印
for f in *.mp4; do
codex call video-use scale --input "$f" --width 1080 --height 1920 --output "scaled_$f"
codex call video-use overlay --input "scaled_$f" --text "©2025" --output "watermarked_$f"
done
贡献与反馈
欢迎提交 Issue 或 PR 至原始仓库：AxelkHellberg/codex-video-use。请遵循上游的代码规范与行为准则。
许可
本技能遵循其上游存储库的许可协议。详见 LICENSE 文件。