用途：当用户要求压缩视频、减小文件大小、优化网页播放或缩小视频时使用。
主要能力：先用 ffprobe 探测时长、大小、视频编码和音频码率；再根据用户意图选择模式——CRF 质量模式（无明确大小目标）或两遍大小模式（指定目标如 50MB 以内）。编码默认 H.264/libx264，目标不超过原大小 50% 或要求最大压缩/HEVC 时用 H.265/libx265。
使用方式：CRF 模式示例：ffmpeg -i "$INPUT" -c:v libx264 -crf 23 -c:a copy -movflags +faststart "$OUTPUT"。两遍模式先用脚本计算码率：python3 ${CLAUDE_PLUGIN_ROOT}/skills/compress-video/scripts/calc_bitrate.py "$INPUT" --target-mb "$TARGET_MB"，再执行两遍编码，第二遍音频用 AAC 128k。运行前需向用户确认输入大小、编码器、模式与输出路径，完成后报告压缩比。
限制：ffprobe 失败应停止；目标过小导致码率负数需请求更大目标；H.265 需加 -tag:v hvc1 以兼容 Apple 设备；两遍编码后清理 ffmpeg2pass 日志；若仅裁剪或重封装且输入已是 H.264，建议改用 convert-video 的 -c copy。