youtube-summarizer
用途
此技能可從 YouTube 影片中擷取逐字稿,並使用 STAR + R-I-S-E 框架產生詳盡、完整的摘要。它能驗證影片的可存取性,並利用 youtube-transcript-api Python 函式庫提取逐字稿,最終產出捕捉所有洞見、論點及關鍵要點的詳細文件。
此技能專為需要從教育影片、講座、教學課程或資訊型內容中獲取徹底內容分析與參考文件的用戶所設計。
使用時機
當以下情況發生時,應使用此技能:
- 用戶提供 YouTube 影片網址並要求詳細摘要
- 用戶需要記錄影片內容以供日後參考,而無需重新觀看
- 用戶想從教育內容中提取洞見、關鍵要點與論點
- 用戶需要從 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:驗證網址"
格式規範:
- 寬度為 20 個字元(使用 █ 表示已填滿,░ 表示空白)
- 百分比遞增:步驟 1=20%,步驟 2=40%,步驟 3=60%,步驟 4=80%,步驟 5=100%
- 步驟計數器顯示目前/總數(例如「步驟 3/5」)
- 簡短的目前階段描述
在步驟 1 之前顯示初始狀態框:
╔══════════════════════════════════════════════════════════════╗
║ 📹 YouTube 摘要工具 - 處理影片中 ║
╠══════════════════════════════════════════════════════════════╣
║ → 步驟 1:驗證網址 [進行中] ║
║ ○ 步驟 2:檢查可用性 ║
║ ○ 步驟 3:提取逐字稿 ║
║ ○ 步驟 4:產生摘要 ║
║ ○ 步驟 5:格式化輸出 ║
╠══════════════════════════════════════════════════════════════╣
║ 進度:██████░░░░░░░░░░░░░░░░░░░░░░░░ 20% ║
╚══════════════════════════════════════════════════════════════╝
步驟 1:驗證 YouTube 網址
目標: 提取影片 ID 並驗證網址格式。
支援的網址格式:
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
操作:
# 使用正規表達式或網址解析提取影片 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 網址格式"
exit 1
fi
echo "📹 影片 ID 已提取:$VIDEO_ID"
若網址無效:
❌ 無效的 YouTube 網址
請提供一個格式正確的 YouTube 網址,例如:
- 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)
錯誤處理:
| 錯誤 | 訊息 | 行動 |
|---|---|---|
| 找不到影片 | "❌ 影片不存在或設為私人" | 要求用戶確認網址 |
| 逐字稿功能停用 | "❌ 此影片的逐字稿功能已停用" | 無法繼續 |
| 無可用逐字稿 | "❌ 找不到逐字稿(未自動產生也未手動新增)" | 無法繼續 |
| 私人/受限影片 | "❌ 影片為私人或受限內容" | 要求提供公開影片 |
步驟 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 提示詞,建立詳細摘要。
套用的提示詞:
使用第二階段的強化提示詞(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" # 將逐字稿讀入情境
接著套用完整的摘要提示詞(來自第二階段的強化版本)。
步驟 5:格式化與呈現輸出
進度:
echo "[████████████████████] 100% - 步驟 5/5:格式化輸出"
目標: 以簡潔、結構良好的 Markdown 形式交付摘要。
輸出結構:
# [影片標題]
**頻道:** [頻道名稱]
**長度:** [影片長度]
**網址:** [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 安裝
- [ ] 否 - 我會手動安裝
用戶選擇「是」:
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1
✅ 安裝完成!繼續進行影片摘要...
範例 4:無效網址
用戶輸入:
claude> 總結 YouTube 影片 www.youtube.com/some-video
技能回應:
❌ 無效的 YouTube 網址格式
預期的網址範例:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
請提供有效的 YouTube 影片網址。
📊 執行摘要
此影片全面介紹了人工智慧(AI)的基礎概念,專為初學者和希望了解現代 AI 技術基礎與實際應用的專業人士設計。講師從基本定義涵蓋到機器學習演算法,並使用實際範例與視覺化工具來促進理解。
[... 接續的詳細摘要 ...]
**儲存選項:**
您要如何儲存? → 摘要 + 原始逐字稿
✅ 檔案已儲存:resumo-exemplo123-2026-02-01.md(包含原始逐字稿) [████████████████████] 100% - ✓ 處理完成!
歡迎來到這個機器學習基礎的全面教學。在今天的影片中,我們將探索驅動現代 AI 系統的核心概念...
版本: 1.2.0 最後更新: 2026-02-02 維護者: Eric Andrade
限制
- 僅當任務明確符合上述範圍時,才使用此技能。
- 請勿將輸出視為特定環境驗證、測試或專家審查的替代方案。
- 若缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求釐清。