YouTube 视频智能剪辑工具

Installation: If you're installing this skill from GitHub, please refer to README.md for installation instructions. The recommended method is npx skills add https://github.com/op7418/Youtube-clipper-skill.

工作流程

你将按照以下 6 个阶段执行 YouTube 视频剪辑任务：

阶段 1: 环境检测

目标: 确保所有必需工具和依赖都已安装

1. 检测 yt-dlp 是否可用

   yt-dlp --version
   

2. 检测 FFmpeg 版本和 libass 支持

   # 优先检查 ffmpeg-full（macOS）
   /opt/homebrew/opt/ffmpeg-full/bin/ffmpeg -version
   
   # 检查标准 FFmpeg
   ffmpeg -version
   
   # 验证 libass 支持（字幕烧录必需）
   ffmpeg -filters 2>&1 | grep subtitles
   

3. 检测 Python 依赖

   python3 -c "import yt_dlp; print('✅ yt-dlp available')"
   python3 -c "import pysrt; print('✅ pysrt available')"
   

如果环境检测失败:

• yt-dlp 未安装: 提示 brew install yt-dlp 或 pip install yt-dlp
• FFmpeg 无 libass: 提示安装 ffmpeg-full

  brew install ffmpeg-full  # macOS
  

• Python 依赖缺失: 提示 pip install pysrt python-dotenv

注意:

• 标准 Homebrew FFmpeg 不包含 libass，无法烧录字幕
• ffmpeg-full 路径: /opt/homebrew/opt/ffmpeg-full/bin/ffmpeg (Apple Silicon)
• 必须先通过环境检测才能继续

---

阶段 2: 下载视频

目标: 下载 YouTube 视频和英文字幕

1. 询问用户 YouTube URL

2. 调用 download_video.py 脚本

   cd ~/.claude/skills/youtube-clipper
   python3 scripts/download_video.py <youtube_url>
   

3. 脚本会：

   • 下载视频（最高 1080p，mp4 格式）
   • 下载英文字幕（VTT 格式，自动字幕作为备选）
   • 输出文件路径和视频信息

4. 向用户展示：

   • 视频标题
   • 视频时长
   • 文件大小
   • 下载路径

输出:

• 视频文件: <id>.mp4（使用视频 ID 命名，避免特殊字符问题）
• 字幕文件: <id>.en.vtt

---

阶段 3: 分析章节（核心差异化功能）

目标: 使用 Claude AI 分析字幕内容，生成精细章节（2-5 分钟级别）

1. 调用 analyze_subtitles.py 解析 VTT 字幕

   python3 scripts/analyze_subtitles.py <subtitle_path>
   

2. 脚本会输出结构化字幕数据：

   • 完整字幕文本（带时间戳）
   • 总时长
   • 字幕条数

3. 你需要执行 AI 分析（这是最关键的步骤）：

   • 阅读完整字幕内容
   • 理解内容语义和主题转换点
   • 识别自然的话题切换位置
   • 生成 2-5 分钟粒度的章节（避免半小时粗粒度切分）

4. 为每个章节生成：

   • 标题: 精炼的主题概括（10-20 字）
   • 时间范围: 起始和结束时间（格式: MM:SS 或 HH:MM:SS）
   • *...