Works with the AI Agents you already use
Claude Code
Cursor
Codex CLI
Muse
Dots+21 moreClaude CodeCursorCodex CLIMuseDots
Manus
Grok
Grok Bot+18 agentsVideo Edit Script Engine
Automation routing (moviepy/ffmpeg), batch processing, audio, effects automation, quality gates.
Free
Video Edit Script Engine
Example session with this skill installed
Help with video
- Read your context and instructions
- Compiled the video edit script
Video Edit Script Engine
Structured analysis with routing and next steps.
Connects securely to your tools. The creator never sees your data.
About this skill
name: video-edit-script-engine description: > 自动化剪辑脚本专家决策引擎 v2.0。提供剪辑自动化路由(moviepy/ffmpeg/剪映)、 批量处理完整方案(水印/字幕/转码/拼接)、音频处理(降噪/音量标准化/背景音乐)、 效果自动化(转场/调色/变速)、质量门控三级清单(P0/P1/P2)、10个常见错误模式、 完整SOP流程。当用户需要视频剪辑自动化、批量视频处理、ffmpeg脚本、moviepy脚本时使用此技能。 metadata: author: woodfantasy version: "2.0"
自动化剪辑脚本专家 v2.0
专业的视频剪辑自动化决策引擎，根据用户需求智能推荐最优工具链和脚本方案。
一、剪辑自动化路由决策树
1.1 工具选择决策矩阵
| 任务类型 | 推荐工具 | 处理速度 | 质量 | 学习曲线 | 适用场景 |
|---|---|---|---|---|---|
| 简单转码 | FFmpeg | ⚡⚡⚡⚡⚡ | ★★★★ | ★ | 格式转换、压缩、裁剪 |
| 水印字幕 | FFmpeg | ⚡⚡⚡⚡ | ★★★★ | ★★ | 批量添加logo、字幕 |
| 多轨合成 | FFmpeg Filter | ⚡⚡⚡ | ★★★★ | ★★ | 多视频拼接、画中画 |
| 特效动画 | MoviePy | ⚡⚡ | ★★★★ | ★★★ | 动态字幕、特效转场 |
| 模板剪辑 | 剪映 | ⚡⚡⚡⚡⚡ | ★★★ | ★ | 批量模板化、AI功能 |
| 专业影视 | Premiere | ⚡⚡ | ★★★★★ | ★★★★★ | 复杂剪辑、调色 |
1.2 工具选择决策流程
1.3 工具特性对比表
| 特性 | FFmpeg | MoviePy | 剪映 | Premiere |
|---|---|---|---|---|
| 性能 | 最快 | 较慢 | 快 | 中等 |
| Python集成 | ⚠️ 需subprocess | ✅ 原生支持 | ❌ | ❌ |
| 特效能力 | 基础 | 丰富 | AI特效 | 专业完整 |
| 批量处理 | ✅ 循环处理 | ⚠️ 需循环 | ✅ 批处理 | ⚠️ 脚本 |
| 学习成本 | 低 | 中 | 低 | 高 |
| 跨平台 | ✅ | ✅ | ❌ | ✅ |
| 自动化程度 | 高 | 高 | 中 | 低 |
| 输出格式 | 全部 | 有限 | 抖音格式 | 专业格式 |
二、批量处理完整方案
2.1 批量处理框架SOP
2.2 批量处理完整代码框架
2.3 水印批量添加脚本
三、音频处理方案
3.1 FFmpeg音频处理命令库
3.2 音频处理Python脚本
四、常用FFmpeg命令速查
4.1 基础操作命令
4.2 编码与质量命令
4.3 水印与字幕命令
4.4 音频处理命令
4.5 高级操作命令
五、效果自动化方案
5.1 转场效果脚本
5.2 调色自动化
5.3 变速处理
六、质量门控三级清单
6.1 P0级门控（上线阻塞级）
| 检查项 | 检查标准 | 检测方法 | 阻断条件 |
|---|---|---|---|
| 输出文件存在 | 文件已生成 | os.path.exists() | 无文件=阻断 |
| 文件大小合理 | >1KB | os.path.getsize() | 过小=阻断 |
| 视频时长正确 | 时长>0 | ffprobe duration | 时长异常=阻断 |
| 编码成功 | returncode==0 | subprocess | 失败=阻断 |
| 视频流存在 | has video | ffprobe streams | 无视频=阻断 |
| 音频流存在 | has audio | ffprobe streams | 无音频(如有要求)=阻断 |
| 无致命错误 | stderr无Error | 日志检查 | Error=阻断 |
6.2 P1级门控（质量保证级）
| 检查项 | 检查标准 | 检测方法 | 处理方式 |
|---|---|---|---|
| 分辨率正确 | 符合目标尺寸 | ffprobe streams | 警告 |
| 码率合理 | 在预期范围 | ffprobe bitrate | 警告 |
| 音视频同步 | 相差<1秒 | 音频视频时长差 | 警告 |
| 无编码警告 | stderr无warning | 日志检查 | 警告 |
| 视频完整性 | 可正常播放 | ffprobe检查 | 警告 |
| 音频清晰度 | 无爆音 | loudnorm峰值 | 警告 |
| 字幕正确 | 时间轴准确 | 检查VTT/SRT | 警告 |
| 水印位置 | 在设定位置 | 截图检查 | 警告 |
6.3 P2级门控（优化建议级）
| 检查项 | 检查标准 | 优化建议 |
|---|---|---|
| 文件体积优化 | 压缩比合理 | 调整CRF |
| 画面质量 | 无明显块效应 | 调整preset |
| 编码速度 | 处理速度满意 | 调整preset |
| 文件格式 | 符合目标格式 | 调整codec |
| 元数据 | metadata完整 | 添加metadata |
6.4 质量检查实现
七、常见错误模式详解
错误1: 编码不兼容问题
| 错误信息 | 原因 | 解决方案 |
|---|---|---|
Invalid NAL unit size | H.264/H.265编码参数不兼容 | 添加 -bsf:v h264_mp4toannexb 或 -tag:v avc1 |
Unsupported codec with豆腐 | 缺少编解码器 | 安装 libx264、libmp3lame |
Non-monotonous DTS | 帧顺序问题 | 添加 -vsync cfr |
B frames not supported | B帧不兼容 | 添加 -flags -cgop |
Encoder (codec xxx) not found | 编码器未安装 | 安装对应编解码器 |
解决代码:
错误2: 音画不同步
| 症状 | 原因 | 解决方案 |
|---|---|---|
| 播放时音画完全错位 | 时间戳错误 | 重新封装 ffmpeg -i input -c copy |
| 播放快进快退 | 关键帧间隔过大 | 设置 -g 30 -keyint_min 30 |
| 音画逐步漂移 | 音视频时长不一致 | 使用 -itsoffset 调整 |
| 音画突然跳变 | PTS/DTS问题 | 添加 -async 1 -vsync cfr |
解决代码:
错误3: 内存溢出 (OOM)
| 错误信息 | 原因 | 解决方案 |
|---|---|---|
Killed signal terminated | 大文件内存不足 | 分段处理 + 降低缓存 |
Cannot allocate memory | 并行任务过多 | 减少 max_workers |
malloc error | 临时文件过大 | 设置 -threads 1 |
解决代码:
错误4: 水印位置问题
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 水印位置偏移 | 视频尺寸变化 | 使用相对位置 |
| 水印被裁剪 | 位置超出画面 | 调整margin |
| 水印不显示 | 坐标计算错误 | 使用固定像素测试 |
解决代码:
错误5: 字幕乱码
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 字幕显示为方块 | 字体不支持 | 添加字体路径 |
| 字幕乱码 | 编码不匹配 | 指定编码 utf-8 |
| 字幕位置错误 | 分辨率不匹配 | 调整坐标 |
解决代码:
错误6: 批量处理卡死
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 任务无响应 | 单个任务超时 | 设置 timeout |
| 并发过高 | 资源耗尽 | 减少 max_workers |
| 内存泄漏 | 缓存未释放 | 定期清理 |
解决代码:
错误7: 输出文件损坏
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 文件不完整 | 覆盖冲突 | 使用 -y 前确认 |
| 文件损坏 | 中断写入 | 原子写入 |
| 权限错误 | 目录不可写 | 检查权限 |
解决代码:
错误8: 权限错误
| 问题 | 原因 | 解决方案 |
|---|---|---|
| Permission denied | 目录不可写 | chmod 755 |
| Read-only | 文件系统只读 | 检查挂载 |
| 所有者错误 | 操作无权限 | sudo 或修改权限 |
解决代码:
错误9: 进度追踪丢失
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 进度丢失 | 意外中断 | 状态持久化 |
| 重复处理 | 未标记完成 | 断点续传 |
| 统计不准 | 并发计数冲突 | 线程安全 |
解决代码:
错误10: 资源清理失败
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 临时文件残留 | 程序异常退出 | 使用context manager |
| 端口占用 | 进程未关闭 | 信号处理 |
| 内存泄漏 | 资源未释放 | finally清理 |
解决代码:
八、快速参考速查表
8.1 常见场景命令速查
| 场景 | 推荐命令 |
|---|---|
| 批量转MP4 | for f in *.avi; do ffmpeg -i "$f" "${f%.avi}.mp4"; done |
| 添加水印 | ffmpeg -i input.mp4 -i logo.png -filter_complex "overlay=10:10" output.mp4 |
| 提取音频 | ffmpeg -i video.mp4 -vn -acodec libmp3lame audio.mp3 |
| 压缩大小 | ffmpeg -i input.mp4 -c:v libx265 -crf 28 -c:a copy output.mp4 |
| 添加字幕 | ffmpeg -i input.mp4 -vf "ass=subtitle.ass" output.mp4 |
| 剪切片段 | ffmpeg -i input.mp4 -ss 0 -t 60 -c copy output.mp4 |
| 合并视频 | ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp4 |
| 音量标准化 | ffmpeg -i input.mp4 -af "loudnorm=I=-16:TP=-1.5:LRA=11" -c:v copy output.mp4 |
8.2 参数说明
| 参数 | 说明 | 常用值 |
|---|---|---|
-crf | 质量因子（越小越清晰） | 18-28 |
-preset | 编码速度 | ultrafast, fast, medium, slow |
-b:v | 视频码率 | 2000k, 5000k |
-c:v | 视频编码器 | libx264, libx265, copy |
-c:a | 音频编码器 | libmp3lame, aac, copy |
-vf | 视频滤镜 | scale, overlay, eq |
-af | 音频滤镜 | volume, amix, loudnorm |
版本: 2.0
更新内容: 完整批量处理框架、断点续传支持、错误恢复机制、质量门控检查、10个错误模式详解
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
12 uses
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 4 months ago
- Free with an Agensi account
Permissions
File Scopes
No API needed