video-summarize

用途

video-summarize 用于总结单个 YouTube 视频，并在 my-vault 中创建一条笔记。当用户分享视频链接，或要求总结某个特定视频时使用。触发语包括“summarize this video”等。

使用方式

命令格式：

/video-summarize <youtube-url> [folder]

youtube-url：完整的 YouTube 链接或视频 ID
folder（可选）：Videos/ 下的子文件夹（例如 "Atlassian"、"Ali Abdaal"）。如果未指定，则使用频道名称。

示例：

/video-summarize https://www.youtube.com/watch?v=abc123 /video-summarize abc123 "Tech Talks" /video-summarize https://youtu.be/xyz789 Atlassian

工作流程

从链接中提取视频 ID（支持 youtube.com/watch?v=、youtu.be/ 以及裸 ID）。
使用 youtube-catchup 辅助脚本获取视频元数据：

python3 .claude/skills/youtube-catchup/scripts/youtube_helper.py full <video_id>

查看字幕并创建摘要，包含：
- 关键概念的要点摘要
- 带有推荐意见的“Why Watch?”部分
确定文件夹：
- 如果指定了文件夹则使用指定的
- 否则使用元数据中的频道名称
- 如果文件夹不存在则创建
在 my-vault/06 Knowledge Base/Capture/Videos/<folder>/<title>.md 创建笔记
分配标签：
- 检查 youtube-catchup/references/channels.json 中该频道的默认标签
- 如果频道不在配置中，则从 my-vault/09 System/Tag Index.md 的规范列表中推断标签

视频笔记格式

使用以下精确模板格式：

class: Video media: https://www.youtube.com/watch?v=VIDEO_ID publishDate: YYYY-MM-DD status: Summarized duration: Xm or Xh Ym reviewFrequency: lastReviewedDate: review: aliases: tags: ["tag1", "tag2"] cssclasses: archived:

Key point - Details
Key point - Details

Why Watch?

摘要指南

使用带加粗关键概念的要点
根据视频长度调整详细程度：
- < 5 分钟：3-5 个要点
- 5-15 分钟：5-8 个要点
- 15-30 分钟：8-12 个要点
- 30+ 分钟：使用章节/标题，12+ 个要点
关注可执行的要点，而非时间戳
“Why Watch?”应帮助用户判断是否真的需要观看

时长格式

60 分钟以下：Xm（例如 23m）
60 分钟以上：Xh Ym（例如 1h 15m）

标题清理

为文件名移除或替换以下字符：

: → -
/ → -
| → -
? → （移除）
" → （移除）
< > → （移除）

路径处理

关键 - 切勿用反斜杠转义空格：

完全按所示使用路径：my-vault/06 Knowledge Base/...（使用字面空格）
Write 工具能正确处理空格 - 反斜杠转义会在目录名中产生字面 \ 字符
使用 Bash 命令时，用双引号包裹路径："my-vault/06 Knowledge Base/..."

说明

复用 youtube-catchup 技能中的 youtube_helper.py（无重复代码）
如果字幕不可用，在摘要中注明，并仅根据描述/标题进行总结
创建前检查笔记是否已存在（在 media 字段中按视频 ID 搜索）

适用场景

适合需要将 YouTube 视频内容快速转化为结构化知识笔记的用户，尤其是使用 my-vault 知识库管理视频资料、希望按频道或主题归档并自动打标签的场景。

限制

依赖 youtube-catchup 技能及其辅助脚本 youtube_helper.py
依赖 my-vault 目录结构（如 06 Knowledge Base、09 System/Tag Index.md）
字幕不可用时只能基于描述和标题总结
其他平台或非 YouTube 视频暂未提供支持

技能介绍

用途