视频总结器 (YouTube Summarizer)
选择性阅读规则
请先阅读以下文件:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
然后仅加载与用户实际任务相关的继承文档、脚本、资源或示例。
目的
此技能从 YouTube 视频中提取转录文本,并使用 STAR + R-I-S-E 框架生成全面、详尽的总结。它会验证视频的可访问性,利用 youtube-transcript-api Python 库提取转录,并生成详细的文档,捕获所有见解、论据和关键要点。
该技能专为需要从教育视频、讲座、教程或知识性内容中进行深入内容分析和制作参考文档的用户设计。
何时使用此技能
当以下情况时,应使用此技能:
- 用户提供 YouTube 视频 URL 并希望获得详细总结
- 用户需要记录视频内容以便日后参考,无需重新观看
- 用户希望从教育内容中提取见解、关键点和论据
- 用户需要 YouTube 视频的转录文本进行分析
- 用户要求“总结”、“概述”或“提取内容”来自 YouTube 视频
- 用户希望获得完整优先于简洁的全面文档
步骤 0:发现与设置
在处理视频之前,验证环境和依赖:
# 检查 youtube-transcript-api 是否已安装
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
echo "⚠️ youtube-transcript-api 未找到"
# 提供安装选项
fi
# 检查 Python 是否可用
if ! command -v python3 &>/dev/null; then
echo "❌ 需要 Python 3 但未安装"
exit 1
fi
如果缺少依赖,询问用户:
youtube-transcript-api 是必需的,但尚未安装。
是否立即安装?
- [ ] 是 - 使用 pip 安装 (pip install youtube-transcript-api)
- [ ] 否 - 我将手动安装
如果用户选择“是”:
pip install youtube-transcript-api
验证安装:
python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api 安装成功')"
主要工作流程
进度跟踪指南
在整个工作流程中,请在每一步之前显示一个可视化的进度条,以便用户了解进度。进度条格式如下:
echo "[████░░░░░░░░░░░░░░░░] 20% - 第 1/5 步:验证 URL"
格式规范:
- 宽度为 20 个字符(使用 █ 表示已完成,░ 表示未完成)
- 百分比增量:步骤 1=20%,步骤 2=40%,步骤 3=60%,步骤 4=80%,步骤 5=100%
- 步骤计数器显示当前/总计(例如,“第 3/5 步”)
- 当前阶段的简要说明
在步骤 1 之前显示初始状态框:
╔══════════════════════════════════════════════════════════════╗
║ 📹 视频总结器 - 正在处理视频 ║
╠══════════════════════════════════════════════════════════════╣
║ → 第 1 步:验证 URL [进行中] ║
║ ○ 第 2 步:检查可用性 ║
║ ○ 第 3 步:提取转录文本 ║
║ ○ 第 4 步:生成总结 ║
║ ○ 第 5 步:格式化输出 ║
╠══════════════════════════════════════════════════════════════╣
║ 进度:██████░░░░░░░░░░░░░░░░░░░░░░░░ 20% ║
╚══════════════════════════════════════════════════════════════╝
步骤 1:验证 YouTube URL
目标: 提取视频 ID 并验证 URL 格式。
支持的 URL 格式:
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://m.youtube.com/watch?v=VIDEO_ID
操作:
# 使用正则表达式或 URL 解析提取视频 ID
URL="$USER_PROVIDED_URL"
# 格式 1:youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# 格式 2:youtu.be/VIDEO_ID
elif echo "$URL" | grep -qE 'youtu\.be/'; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
echo "❌ 无效的 YouTube URL 格式"
exit 1
fi
echo "📹 视频 ID 已提取:$VIDEO_ID"
如果 URL 无效:
❌ 无效的 YouTube URL
请提供以下格式之一的有效 YouTube URL:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
示例:https://www.youtube.com/watch?v=dQw4w9WgXcQ
步骤 2:检查视频和转录可用性
进度:
echo "[████████░░░░░░░░░░░░] 40% - 第 2/5 步:检查可用性"
目标: 验证视频是否存在且转录可访问。
操作:
from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys
video_id = sys.argv[1]
try:
# 获取可用转录列表
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print(f"✅ 视频可访问:{video_id}")
print("📝 可用转录:")
for transcript in transcript_list:
print(f" - {transcript.language} ({transcript.language_code})")
if transcript.is_generated:
print(" [自动生成]")
except TranscriptsDisabled:
print(f"❌ 视频 {video_id} 的转录功能已禁用")
sys.exit(1)
except NoTranscriptFound:
print(f"❌ 未找到视频 {video_id} 的转录")
sys.exit(1)
except Exception as e:
print(f"❌ 访问视频时出错:{e}")
sys.exit(1)
错误处理:
| 错误 | 消息 | 操作 |
|---|---|---|
| 视频未找到 | "❌ 视频不存在或为私有" | 请用户验证 URL |
| 转录已禁用 | "❌ 此视频已禁用转录功能" | 无法继续 |
| 无可用转录 | "❌ 未找到转录(未自动生成或手动添加)" | 无法继续 |
| 私有/受限视频 | "❌ 视频为私有或受限" | 请提供公开视频 |
步骤 3:提取转录
进度:
echo "[████████████░░░░░░░░] 60% - 第 3/5 步:提取转录文本"
目标: 以首选语言检索转录文本。
操作:
from youtube_transcript_api import YouTubeTranscriptApi
video_id = "VIDEO_ID"
try:
# 首先尝试获取用户首选语言的转录
# 如果不可用,则回退到英语
transcript = YouTubeTranscriptApi.get_transcript(
video_id,
languages=['pt', 'en'] # 首选葡萄牙语,回退到英语
)
# 将转录片段合并为完整文本
full_text = " ".join([entry['text'] for entry in transcript])
# 获取视频元数据
from youtube_transcript_api import YouTubeTranscriptApi
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print("✅ 转录提取成功")
print(f"📊 转录长度:{len(full_text)} 个字符")
# 保存到临时文件以备处理
with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
f.write(full_text)
except Exception as e:
print(f"❌ 提取转录时出错:{e}")
exit(1)
转录处理:
- 将所有转录片段合并为连贯的文本
- 尽可能保留标点和格式
- 删除重复或重叠的片段(如果是自动生成的伪影)
- 存储在临时文件中以供分析
步骤 4:生成全面总结
进度:
echo "[████████████████░░░░] 80% - 第 4/5 步:生成总结"
目标: 应用增强的 STAR + R-I-S-E 提示以创建详细总结。
应用的提示:
使用第 2 阶段(STAR + R-I-S-E 框架)的增强提示,并将提取的转录作为输入。
操作:
- 加载完整的转录文本
- 应用全面的总结提示
- 使用 AI 模型(Claude/GPT)生成结构化的总结
- 确保输出遵循定义的结构:
- 带有视频元数据的标题
- 执行综合摘要
- 详细的逐节分解
- 关键见解和结论
- 概念和术语
- 资源和参考
实现:
# 使用转录文件作为 AI 提示的输入
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"
# AI 代理将:
# 1. 读取转录内容
# 2. 应用 STAR + R-I-S-E 总结框架
# 3. 生成全面的 Markdown 输出
# 4. 使用标题、列表和重点进行结构化
Read "$TRANSCRIPT_FILE" # 将转录内容读入上下文
然后应用完整的总结提示(来自第 2 阶段的增强版本)。
步骤 5:格式化并呈现输出
进度:
echo "[████████████████████] 100% - 第 5/5 步:格式化输出"
目标: 以清晰、结构良好的 Markdown 格式提供总结。
输出结构:
# [视频标题]
**频道:** [频道名称]
**时长:** [时长]
**URL:** [https://youtube.com/watch?v=VIDEO_ID]
**发布日期:** [日期(如果可用)]
## 📝 详细总结
### [主题 1]
[包含示例、数据、引用的全面解释...]
#### [子主题 1.1]
[详细分解...]
### [主题 2]
[继续详细分析...]
## 📚 概念和术语
- **[术语 1]:** [定义和上下文]
- **[术语 2]:** [定义和上下文]
## 📌 结论
[最终综合和要点]
### **示例 2:缺少依赖**
**用户输入:**
claude> 总结这个 YouTube 视频 https://youtu.be/abc123
**技能响应:**
⚠️ youtube-transcript-api 未安装
此技能需要 Python 库 'youtube-transcript-api'。
是否立即安装?
- 是 - 使用 pip 安装
- 否 - 我将手动安装
**用户选择“是”:**
```bash
$ pip install youtube-transcript-api
成功安装 youtube-transcript-api-0.6.1
✅ 安装完成!继续视频总结...
示例 4:无效 URL
用户输入:
claude> 总结 YouTube 视频 www.youtube.com/some-video
技能响应:
❌ 无效的 YouTube URL 格式
预期的格式示例:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
请提供有效的 YouTube 视频 URL。
📊 执行摘要
该视频全面介绍了人工智能(AI)的基本概念,专为希望理解现代 AI 技术基础和实际应用的初学者和专业人士设计。讲师涵盖了从基本定义到机器学习算法的所有内容,使用实际示例和可视化来促进理解。
[... 继续详细总结 ...]
**保存选项:**
您希望保存什么? → 总结 + 原始转录
✅ 文件已保存:resumo-exemplo123-2026-02-01.md(包含原始转录) [████████████████████] 100% - ✓ 处理完成!
欢迎来到这个关于机器学习基础的全面教程。在今天的视频中,我们将探索驱动现代 AI 系统的核心概念...
版本: 1.2.0 最后更新: 2026-02-02 维护者: Eric Andrade
限制
- 仅在任务明确符合上述范围时使用此技能。
- 不要将输出视为特定环境验证、测试或专家审查的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准,请停止并要求澄清。