用途:当用户要求整理 YouTube 视频、总结视频、翻译字幕、生成视频测验,或直接提供 YouTube URL 时使用。流程为:分析视频 → 生成摘要/洞察/翻译文档 → 测验。
主要能力与用法:
- 元数据收集:运行 scripts/extract_metadata.sh "<URL>",提取标题、描述、频道、上传日期、时长、标签。
- 字幕提取:运行 scripts/extract_transcript.sh "<URL>" [output_dir],优先级为手动字幕(韩→英)高于自动生成字幕(韩→英)。
- 上下文理解:用 WebSearch 搜索“{视频标题} {频道名} summary”“{演讲者} {主题关键词}”,收集专有名词准确写法。
- 字幕校正:用搜索结果替换自动字幕中的专有名词误识别,如 Kora→Cora、cloud code→Claude Code、every→Every.to。
- 文档生成:包含 frontmatter(title、url、channel、date、duration、processed_at)及摘要、洞察、韩文翻译全文。
- 文件保存:research/readings/youtube/{YYYY-MM-DD}-{sanitized-title}.md。
- 学习测验:3 阶段 × 3 题共 9 题,用 AskUserQuestion 每阶段同时出 3 题;阶段 1 基础、阶段 2 中级、阶段 3 深化。错题给出答案与解析,并在文档末尾追加测验结果与错题笔记。
- 后续选择:再测一次、Deep Research(参考 references/deep-research.md)或结束。
限制与注意:字幕语言优先级为韩语手动→英语手动→韩语自动→英语自动;无法理解处标 [불명확];yt-dlp 可用 --list-subs 查看字幕列表,登录时用 --cookies-from-browser chrome。资源包括 scripts/extract_metadata.sh、scripts/extract_transcript.sh、references/quiz-patterns.md、references/deep-research.md。