YouTube Summary Skill 是一个用于总结 YouTube 视频的技能。它通过 Supadata API 获取视频字幕，并基于字幕文本生成结构化、可读的摘要，适合在用户分享 YouTube 链接并希望获取摘要、要点时使用。
用途 当用户提供 YouTube 链接并希望获得视频摘要时，该技能会抓取该视频的字幕，并生成结构化摘要。
前提条件 该技能需要 Supadata API 密钥，免费额度足够个人使用。使用步骤：在 supadata.ai 注册；从控制台获取 API 密钥；将其设置为环境变量：SUPADATA_API_KEY=sd_your_key_here；或在提示时直接提供。
工作流程 步骤 1：获取 YouTube URL。接受以下格式：https://youtu.be/VIDEO_ID 或 https://www.youtube.com/watch?v=VIDEO_ID。
步骤 2：通过 Supadata API 获取字幕。请求方式：curl -s "https://api.supadata.ai/v1/youtube/transcript?url=VIDEO_URL" -H "x-api-key: $SUPADATA_API_KEY"。响应格式示例：{"content": [{"text": "...", "offset": 0, "duration": 5000, "lang": "en"}, ...], "lang": "en", "availableLangs": ["en"]}。从中提取 text 字段并拼接，得到完整字幕文本。
步骤 3：生成摘要。使用字幕文本生成包含以下部分的结构化摘要（可根据视频内容调整）：🎯 核心主题——视频讲的是什么；📌 主要观点——关键论点或发现（3 至 7 条）；📖 详细内容——按章节或主题展开的详细分解；💡 结论——主要收获或结论。摘要语言应与用户的语言偏好一致。
错误处理 401 Unauthorized：API 密钥无效或缺失；请用户检查其 Supadata API 密钥。404 Not Found：视频没有字幕或为私密视频；告知用户该视频没有可用字幕。429 Rate Limited：请求过多；等待后重试，或升级 Supadata 套餐。content 数组为空：没有可用字幕；告知用户并建议其检查视频是否有字幕。
使用示例 用户：“帮我总结一下这个视频 https://youtu.be/BU9sIfGVhIQ”。Agent 工作流程：使用该 URL 调用 Supadata API；解析并拼接字幕文本；生成中文结构化摘要（匹配用户语言）；以 emoji 分节标题呈现摘要。
注意事项 Supadata 免费额度有每月配额，足够日常使用。没有自动生成字幕或人工字幕的视频无法转写。对于非英语视频，Supadata 返回原始语言的字幕，应据此进行摘要。不要使用 youtube-transcript-api Python 库或 yt-dlp——云服务器 IP 会被 YouTube 屏蔽，应始终使用 Supadata API。