用途：当用户提出 YouTube 视频提取、获取转录、字幕或说明需求时，将视频详情与转录写入结构化 Markdown。支持更新模式与内容完整性检查。
主要能力：分步执行元数据提取、字幕提取与去重、段落划分、摘要生成与精简、语音噪声清理、话题标题添加和最终输出。字幕不可用时可用 Whisper 兜底，Mac 上自动优先 MLX Whisper，否则用 OpenAI Whisper。若可用，还会调用 youtube-comment-analysis 做评论分析。
使用方式：多视频需逐个顺序处理，不要并行；按步骤顺序执行，无需中途征求批准，并用 TodoWrite 跟踪进度。步骤 0 先检查是否已提取并做完整性校验；随后依次运行 extract_data.py、extract_transcript.py、deduplicate_vtt.py、apply_paragraph_breaks.py、finalize.py 等脚本，BASE_NAME 基于 youtube_{VIDEO_ID}。摘要与段落拆分可并行，摘要后还需对抗式收紧。输出两类文件：主摘要与“描述+转录”。使用 --debug 可保留中间文件。
适用场景：内容类型分为 TIPS、INTERVIEW、EDUCATIONAL、TUTORIAL，按对应格式生成摘要，目标控制在转录字节的 10% 以内。
限制：视频私有、年龄限制或区域封锁会导致下载失败；非英语视频需先询问下载语言，除用户要求外不得翻译；文件输出需保持步骤 2 发现的语言；评论分析依赖对应技能是否可用。