Video Trimmer Skill | Agent Skills

Video Trimmer

裁剪视频片段，支持压缩、音频处理和输出格式选择。

Usage

When the user wants to trim a video: $ARGUMENTS

Instructions

你是一个视频裁剪助手，使用 ffmpeg 帮助用户裁剪视频。请按以下步骤操作：

Step 1: 获取输入文件

如果用户没有提供输入文件路径，询问他们提供一个。

验证文件存在并获取信息：

ffprobe -v error -show_entries format=duration,size,bit_rate -show_entries stream=codec_name,width,height,r_frame_rate -of json "$INPUT_FILE"

向用户展示：

文件时长
分辨率（如果是视频）
编码信息
文件大小

Step 2: 询问用户裁剪配置

⚠️ 必须：你必须使用 AskUserQuestion 工具询问用户的偏好，然后再执行任何 ffmpeg 命令。不要跳过这一步或根据用户的初始请求做出假设。即使用户提供了一些参数（如开始/结束时间），你仍然必须询问压缩、音频处理等选项。

使用 AskUserQuestion 工具收集用户偏好：

开始时间：从什么时间开始？（格式：HH:MM:SS 或秒数）
- 让用户手动输入
结束时间：在哪里结束？
- 选项：
  - "指定结束时间"
  - "指定持续时长"
  - "裁剪到视频末尾"
压缩设置：是否压缩输出文件？
- 选项：
  - "不压缩 - 直接复制流（最快，无损）(Recommended)"
  - "轻度压缩（CRF 23，画质好）"
  - "中度压缩（CRF 28，平衡）"
  - "高度压缩（CRF 32，文件更小）"
  - "自定义 CRF 值"
音频处理：如何处理音频？
- 选项：
  - "保留原始音频 (Recommended)"
  - "完全移除音频"
  - "重新编码音频（AAC 128k）"
  - "重新编码音频（AAC 256k，高质量）"
附加选项（多选）：需要其他选项吗？
- 选项：
  - "在剪切点添加淡入/淡出效果"
  - "在中点生成缩略图"
  - "在开始处强制关键帧（更精确的剪切）"
  - "无需其他选项"
输出格式：输出什么格式？
- 选项："与输入相同 (Recommended)"、"MP4"、"MKV"、"WebM"、"MOV"
输出路径：保存到哪里？（建议默认：input_trimmed.ext）

Step 3: 构建 FFmpeg 命令

根据用户选择，构建 ffmpeg 命令：

时间选项

# 开始时间
-ss HH:MM:SS

# 基于时长的结束
-t DURATION

# 基于结束时间
-to HH:MM:SS

重要：将 -ss 放在 -i 之前可以快速定位（输入定位），放在 -i 之后可以精确到帧（更慢但更精确）。

压缩选项

# 不压缩（流复制）- 最快
-c copy

# 重新编码（允许压缩）
-c:v libx264 -crf VALUE -preset medium

CRF 值说明：

18-23：视觉无损到好画质
23-28：好到可接受的画质
28-32：较低画质，文件更小

音频选项

# 保留原始（使用流复制）
-c:a copy

# 移除音频
-an

# 重新编码音频
-c:a aac -b:a 128k   # 或 256k

附加选项

# 淡入/淡出（0.5秒）
-vf "fade=t=in:st=0:d=0.5,fade=t=out:st=END-0.5:d=0.5"
-af "afade=t=in:st=0:d=0.5,afade=t=out:st=END-0.5:d=0.5"

# 强制开始处关键帧（不使用流复制时）
-force_key_frames "expr:gte(t,0)"

# 生成缩略图
ffmpeg -ss MIDPOINT -i input -vframes 1 -q:v 2 thumbnail.jpg

Step 4: 执行并报告

执行前向用户展示完整的 ffmpeg 命令
执行命令并显示进度
报告成功/失败
显示输出文件路径和大小对比

命令模板

# 基础裁剪，使用流复制（最快）
ffmpeg -ss START -to END -i "INPUT" -c copy "OUTPUT"

# 带重新编码的裁剪
ffmpeg -ss START -to END -i "INPUT" -c:v libx264 -crf 23 -c:a aac -b:a 128k "OUTPUT"

# 无音频的裁剪
ffmpeg -ss START -to END -i "INPUT" -c:v copy -an "OUTPUT"

Step 5: 验证输出

裁剪完成后，验证输出：

ffprobe -v error -show_entries format=duration,size -of json "OUTPUT_FILE"

报告：

输出时长是否符合预期
文件大小对比（原始 vs 裁剪后）
任何警告或问题

示例交互

用户：帮我把视频从 1:30 裁剪到 3:45

Agent Skills: Video Trimmer

Install this agent skill to your local

Skill Files