Menu
环境准备。install依赖、配置 API Key、验证环境。触发词：install、环境准备、初始化
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
视频剪辑 Agent，专为口播视频设计 功能： - 语义理解：AI 逐句分析，识别重说/纠正/卡顿 - 静音检测：自动标记过长静音段 - 重复句检测：删除重复内容，保留最佳表达 - 文案生成：基于保留内容自动生成视频介绍草稿 - subtitles生成：Whisper 转录 + 词典纠错 - 自更新：记住用户偏好，越用越准 触发场景： - 用户说"/videocut:install" - 用户说"/videocut:cut [视频文件]" - 用户说"/videocut:subtitle [视频文件]" - 用户说"/videocut:update"
口播视频转录和口误识别。生成审查稿和删除任务清单。触发词：talkcut、处理视频、识别口误
evolution skills。记录用户反馈，更新方法论和规则。触发词：更新规则、记录反馈、改进skill
subtitles生成与烧录。火山引擎转录→词典纠错→审核→烧录。触发词：加subtitles、生成subtitles、subtitles
| name | videocut:install |
| description | 环境准备。install依赖、配置 API Key、验证环境。触发词：install、环境准备、初始化 |
首次使用前的环境准备
用户: install环境
用户: 初始化
| 依赖 | 用途 | macOS | Windows |
|---|---|---|---|
| Node.js | 运行脚本 | brew install node | winget install OpenJS.NodeJS 或 官网下载 |
| FFmpeg | 视频剪辑 | brew install ffmpeg | winget install Gyan.FFmpeg 或 手动下载 |
| curl | API 调用 | 系统自带 | 系统自带（Win10+） |
| mlx-whisper | 本地语音转录（可选） | pip3 install mlx-whisper | 不支持（仅 Apple Silicon） |
本工具支持两种语音转录方案，用户可任选其一：
| 方案 | 速度 | 费用 | 说明 |
|---|---|---|---|
| 火山引擎 API | 快（云端处理） | 免费 20 小时额度 | 需要 API Key、需要联网，全平台可用 |
| Whisper 本地 | 较慢（本地运算） | 完全免费 | 占用约 1.5GB 磁盘空间，首次使用自动下载模型，仅支持 macOS（Apple Silicon） |
选择写入 .env 的 ASR_ENGINE 字段（volcengine 或 whisper），留空则每次执行时询问。
控制台：https://console.volcengine.com/speech/new/experience/asr?projectName=default
配置到项目目录 .claude/skills/.env：
# 文件路径：剪辑Agent/.claude/skills/.env
VOLCENGINE_API_KEY=your_api_key_here
1. install Node.js + FFmpeg
↓
2. 选择转录方案（火山引擎 / Whisper）
↓
3. 配置所选方案（API Key 或install mlx-whisper）
↓
4. 配置默认输出目录
↓
5. 验证环境
brew install node ffmpeg
winget install OpenJS.NodeJS
winget install Gyan.FFmpeg
node -v
ffmpeg -version
询问用户选择哪种转录方案，将选择写入 .env：
# .env 中设置（二选一）
ASR_ENGINE=volcengine # 火山引擎 API
ASR_ENGINE=whisper # Whisper 本地模型
ASR_ENGINE= # 留空 = 每次询问
API Key 获取指南：https://my.feishu.cn/wiki/Gh0MwxHePidsYfkIx7zcvJQynqc?from=from_copylink
echo "VOLCENGINE_API_KEY=your_key" >> .claude/skills/.env
echo "ASR_ENGINE=volcengine" >> .claude/skills/.env
# install mlx-whisper（Apple Silicon 优化）
pip3 install mlx-whisper
# 首次运行时会自动下载模型（~1.5GB）到 ~/.cache/huggingface/
echo "ASR_ENGINE=whisper" >> .claude/skills/.env
检查是否已install：
python3 -c "import mlx_whisper; print('✅ mlx-whisper 已install')"
如果未install，直接执行 pip3 install mlx-whisper 帮用户install。
询问用户希望将剪辑后的视频输出到哪个目录，写入 .env：
# 示例：用户指定 ~/Videos/output
echo "DEFAULT_OUTPUT_DIR=/Users/xxx/Videos/output" >> .claude/skills/.env
如果用户没有特别要求，可以使用视频文件所在目录的 output/ 子目录作为默认值。
# 检查 Node.js
node -v
# 检查 FFmpeg
ffmpeg -version
# 检查转录方案配置
grep ASR_ENGINE .claude/skills/.env
# 如果选了火山引擎，检查 API Key
grep VOLCENGINE .claude/skills/.env
# 如果选了 Whisper，检查install
python3 -c "import mlx_whisper; print('✅ mlx-whisper OK')"
火山引擎控制台 → 语音技术 → 语音识别 → API Key
which ffmpeg # 应该输出路径
# 如果没有，重新install：brew install ffmpeg
FFmpeg 命令需加 file: 前缀：
ffmpeg -i "file:2026:01:26 task.mp4" ...