企业官网建设流程全解析

🎥 youtube-summarizer

从 YouTube 视频中提取转录，并生成全面、详细的摘要

版本：1.2.0
状态：✨ 零配置 | 🌍 通用
平台：GitHub Copilot CLI、Claude Code

概述

youtube-summarizer技能自动化提取 YouTube 视频转录，并使用 STAR + R-I-S-E 框架生成详尽、结构化的摘要。非常适合记录教育内容、讲座、教程或任何信息类视频，而无需重看。

功能特性

• 🎯自动转录提取，使用youtube-transcript-api
• ✅视频验证- 检查视频是否可访问且有转录
• 🌍多语言支持- 优先葡萄牙语，回退到英语
• 📊全面摘要- 优先细节和完整性
• 📝结构化输出- 带标题、章节、见解的 Markdown
• 🔍包含元数据- 视频标题、频道、时长、URL
• ⚡错误处理- 为所有失败场景提供清晰消息
• 🛠️依赖管理- 自动提供安装所需依赖
• 📊进度条- 跨所有步骤的可视化处理跟踪
• 💾灵活的保存选项- 仅摘要、摘要+转录，或仅转录（v1.2.0 新增）

快速开始

触发词

用以下任意短语激活此技能：

# Englishcopilot>summarize this video: https://www.youtube.com/watch?v=VIDEO_ID copilot>summarize youtube video https://youtu.be/VIDEO_ID copilot>extract youtube transcript https://youtube.com/watch?v=VIDEO_ID# Portuguese (also supported)copilot>resume este video: https://www.youtube.com/watch?v=VIDEO_ID

首次设置

技能会自动检查依赖并提供安装：

⚠️ youtube-transcript-api not installed Would you like me toinstallit now? -[x]Yes - Install with pip -[]No - I'llinstallmanually

选择"是"，技能会自动处理安装。

使用场景

1.教育视频文档化

copilot>summarize this video: https://www.youtube.com/watch?v=abc123

输出：

• 讲座内容的全面摘要
• 关键概念与术语
• 示例和实际应用
• 视频中提到的资源

2.技术教程分析

copilot>summarize youtube video https://youtu.be/xyz789

输出：

• 教程的分步拆解
• 提到的代码片段和命令
• 突出的最佳实践
• 记录在案的故障排除技巧

3.会议演讲参考

copilot>extract youtube transcript https://youtube.com/watch?v=def456

输出：

• 演讲者的见解和论点
• 统计数据和数据点
• 案例研究和示例
• 问答环节摘要

4.语言学习内容

copilot>summarize youtube video https://youtu.be/ghi789

输出：

• 使用的词汇和表达
• 讲解的语法点
• 文化引用
• 提到的练习

5.研究与调查

copilot>summarize youtube video https://www.youtube.com/watch?v=jkl012

输出：

• 呈现的研究发现
• 解释的方法论
• 结果和结论
• 未来工作建议

输出结构

每个摘要都遵循这个全面的结构：

# [Video Title] **Canal:** [Channel Name] **Duração:** [Duration] **URL:** [Video URL] **Data de Publicação:** [Date] --- ## 📊 Síntese Executiva [High-level overview, 2-3 paragraphs] --- ## 📝 Resumo Detalhado ### [Topic 1] [Detailed analysis with examples, data, quotes] ### [Topic 2] [Continued breakdown...] --- ## 💡 Principais Insights - **Insight 1:** [Explanation] - **Insight 2:** [Explanation] --- ## 📚 Conceitos e Terminologia - **Term 1:** [Definition] - **Term 2:** [Definition] --- ## 🔗 Recursos Mencionados - [Resource 1] - [Resource 2] --- ## 📌 Conclusão [Final synthesis and key takeaways]

要求

• Python 3.x（macOS/Linux 通常预装）
• pip（Python 包管理器）
• youtube-transcript-api，作者 Julien Depoix（由技能自动安装）

手动安装（可选）

如果你更喜欢手动安装依赖：

pipinstallyoutube-transcript-api

支持的 URL 格式

技能识别以下 YouTube URL 格式：

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://m.youtube.com/watch?v=VIDEO_ID

局限性

可正常处理的视频

✅ 带自动生成字幕的公开视频
✅ 有人工字幕/字幕的视频
✅ 有任意支持语言转录的视频

无法处理的视频

❌ 私密或未列出的视频
❌ 转录被禁用的视频
❌ 年龄受限视频（可能需要认证）
❌ 没有任何字幕的视频

错误消息

无可用转录

❌ No transcript available for this video This skill requires videos with auto-generated captions or manual subtitles. Unfortunately, transcripts are not enabled for this video.

解决方案：换一个启用了字幕的视频。

无效 URL

❌ Invalid YouTube URL format Expected format examples: - https://www.youtube.com/watch?v=VIDEO_ID - https://youtu.be/VIDEO_ID

解决方案：确保提供完整、有效的 YouTube URL。

视频不可访问

❌ Unable to access video Possible reasons: 1. Video is private or unlisted 2. Video has been removed 3. Invalid video ID

解决方案：核实 URL 并确保视频是公开的。

常见问题

问：生成摘要需要多长时间？

答：取决于视频长度：

• 短视频（5-10 分钟）：30-60 秒
• 中等视频（20-40 分钟）：1-2 分钟
• 长视频（60 分钟以上）：2-5 分钟

问：我可以摘要英语/葡萄牙语以外的视频吗？

答：可以！技能会尝试以视频的原始语言提取转录。如果不可用，则回退到英语。

问：这对 YouTube Music 视频有效吗？

答：只有当音乐视频启用了字幕/转录时才有效。大多数音乐视频没有转录。

问：我可以自定义摘要长度吗？

答：技能在设计上优先完整性（详尽摘要）。如果你需要更短的摘要，可以之后请 AI 压缩输出。

问：这会下载视频吗？

答：不会。只通过 YouTube 的 API 提取文本转录。不下载任何视频文件。

问：我可以把摘要保存到文件吗？

答：可以！生成摘要后，技能提供灵活的保存选项：

• 仅摘要- 带结构化摘要的 Markdown 文件
• 摘要 + 转录- 带摘要并附加原始转录的 Markdown 文件
• 仅转录- 带原始转录的纯文本文件（v1.2.0 新增）
• 仅显示- 不保存文件，摘要显示在终端中

文件保存为resumo-{VIDEO_ID}-{YYYY-MM-DD}.md（摘要）或transcript-{VIDEO_ID}-{YYYY-MM-DD}.txt（仅转录）。

问：我应该何时只保存转录？

答：当你满足以下条件时使用仅转录选项：

• 需要原始内容做进一步分析
• 想用其他工具处理文本
• 想稍后自己创建摘要
• 需要转录用于文档或归档目的

安装

全局安装（推荐）

全局安装此技能，以便在所有项目中使用：

# Clone the repositorygitclone https://github.com/ericgandrade/cli-ai-skills.gitcdcli-ai-skills# Run the install script./scripts/install-skills.sh$(pwd)

这会在以下位置创建符号链接：

• ~/.copilot/skills/youtube-summarizer/（GitHub Copilot CLI）
• ~/.claude/skills/youtube-summarizer/（Claude Code）

仓库安装

添加到特定项目：

# Copy skill to your projectcp-rcli-ai-skills/.github/skills/youtube-summarizer .github/skills/

贡献

发现 bug 或有功能请求？欢迎贡献！

1. Fork 仓库
2. 创建功能分支：git checkout -b feature/youtube-enhancement
3. 提交更改：git commit -m "feat(youtube-summarizer): add feature X"
4. 推送并创建 Pull Request

许可证

MIT 许可证 - 详情见 LICENSE。

致谢

• youtube-transcript-api，作者 Julien Depoix - 用于提取 YouTube 视频转录的 Python 库
• Anthropic STAR/R-I-S-E 框架- 用于结构化摘要

由 Eric Andrade 用 ❤️ 构建

版本 1.1.0 | 最后更新：2026 年 2 月