YouTube 影片學習分析 SOP
最後更新：2026-04-18 ｜ 狀態：有效 觸發時機：Tim 在對話中貼入 YouTube 連結時，Claude 自動套用本 SOP（不需說指令）
一、觸發條件
對話中出現以下任一形式，立即套用本 SOP：
https://www.youtube.com/watch?v=...https://youtu.be/...
不應觸發情境：
- Tim 明確說「不用分析，只是參考」
- 連結不是教學/知識型影片（如音樂、娛樂、新聞）
二、字幕讀取策略
第一步：確認字幕可用性（必做）
先執行 JS 確認：
const hasCaptions = 'captions' in window.ytInitialPlayerResponse;
| 結果 | 行動 |
|---|---|
true（有字幕） |
→ 路徑 A：YouTube 原生「顯示逐字稿」 |
false（無字幕） |
→ 路徑 B：fallback 描述文字分析 |
路徑 A：有字幕（hasCaptions = true）
主方法：YouTube 原生「顯示逐字稿」
- 捲動頁面至描述區塊（影片下方）
- 若有「…更多」按鈕，先點擊展開
- 在描述區塊中尋找「顯示逐字稿」按鈕 → 點擊
- 等待逐字稿面板展開後，讀取面板全文
依影片長度選批次策略：
| 長度 | 策略 |
|---|---|
| < 15 分鐘 | 一次讀完全部字幕（單批次） |
| 15–45 分鐘 | 依 timestamps 分段，每段約 300 字幕，逐批讀取 |
| > 45 分鐘 | 先讀標題 + 影片描述判斷值不值得深讀，確認後再分批讀全文 |
讀取工具：
- 開啟面板：
mcp__Claude_in_Chrome__computer（點擊操作） - 讀取內容：
mcp__Claude_in_Chrome__get_page_text（讀取面板全文） - 長影片批次：
mcp__Claude_in_Chrome__javascript_tool滾動面板 + 分段讀取 - ⚠️ 原
timeToSec()為舊 API 方法，已不適用本路徑
路徑 B：無字幕（hasCaptions = false）
- 用
mcp__Claude_in_Chrome__get_page_text讀取完整影片描述文字 - 提取描述內時間戳記清單（若有）作為內容脈絡
- 在維度 2 記錄：「本影片無字幕，分析基於描述文字 + 時間戳記，非逐字稿」
- 維度 3 比較結論標記 ⚠️：「推論依據為描述文字，非完整逐字稿」
三、八維分析輸出格式
維度 1：影片定性
- 頻道名 / 影片標題 / 時長
- 類型（擇一）：工具操作教學 / 方法論框架 / 案例分享 / 商業模式
- 類型決定「分析重點」與「存入位置」（見維度 8）
維度 2：字幕讀取批次記錄
- 說明字幕可用性（hasCaptions 結果：true/false）
- 記錄選擇路徑（A：YouTube 原生逐字稿 / B：描述文字 fallback）
- 路徑 A：說明批次數量與時間段範圍
- 路徑 B：說明描述文字長度 + 時間戳記清單是否存在
維度 3：核心概念提取（3–5 個）
每個概念必須完整填寫以下五欄（不得跳過）：
| 欄位 | 說明 |
|---|---|
| 是什麼 | 一句話定義 |
| 解決什麼問題 | 這個做法針對什麼痛點 |
| 我們目前的做法 | 具體描述現有機制，或寫「無」 |
| 影片的做法 | 具體描述影片示範的方式 |
| 比較結論 | 見下方四條路徑，必須選一條並說明理由 |
比較結論四條路徑：
- A）影片更好 → 說明哪裡更好（更完整/更自動化/更有系統）→ 列入維度 4 可採用點
- B）我們更好 → 說明為什麼（我們的機制更完整/已整合進 CLAUDE.md）→ 記錄於維度 5
- C）各有優劣 → 說明各自的強項，判斷是否整合兩者優點 → 若可整合列入維度 4
- D）我們無此機制 → 直接列入維度 4 可採用點
⚠️ 禁止因為「已有」就跳過比較。只有在比較後確認「我們更好」，才能記為 B。
維度 4：可採用點清單
格式：
- [系統/部門] 行動描述 → 預計影響 → 難度（低/中/高）→ tasks.md 等級（P1–P3）
難度定義：
- 低 = 本次對話可執行
- 中 = 本週可規劃（加入 tasks.md P2）
- 高 = 長期追蹤（加入 tasks.md P3）
無可採用點時，明確寫：「本影片無可採用點，原因：[說明]」
維度 5：明確不採用記錄
格式：
- [做法描述] → 不採用原因（我們已有更好版本 / 架構不符 / 成本過高 / 時機未到）
目的：避免下次遇到類似做法重複評估。 若無排除項，寫：「本影片無明確排除點」
維度 6：與現有系統整體對比
- 影片整體方法論 vs 我們目前系統的整體水準
- 判斷：值得全面學習 / 局部採用 / 僅供參考（說明原因）
維度 7：立即行動（0–3 條）
只寫「本次對話就能執行」的事。 若無立即可做的，此欄位寫「無，採用點已列入 tasks.md」
維度 8：存入知識庫（執行，不是建議）
依影片類型決定存入位置：
| 類型 | 摘要存入位置 | 採用點存入位置 |
|---|---|---|
| 工具操作教學 | knowledge/references/學習資源.md |
dev/tasks.md（P2/P3） |
| 方法論框架 | knowledge/references/學習資源.md + knowledge/methodology/（若有新框架） |
dev/tasks.md + 可能新增方法論文件 |
| 案例分享 | knowledge/references/學習資源.md |
knowledge/client-patterns.md（若有客群洞察） |
| 商業模式 | knowledge/references/學習資源.md |
strategy/ 相關文件 |
強制執行：摘要必須在本次對話中實際寫入 knowledge/references/學習資源.md，不得留待下次。
四、分析品質自查（輸出前逐項確認）
- 維度 3 每個概念都有比較結論（A/B/C/D），無空白
- 維度 4 每個採用點有難度標記與 tasks.md 等級
- 維度 5 有記錄（即使為空也明確說明）
- 維度 8 摘要已實際寫入
knowledge/references/學習資源.md - 採用點 → tasks.md 轉化已完成（見步驟九）
- 字幕可用性已確認（hasCaptions JS 執行，路徑 A/B 選擇已在維度 2 記錄）
步驟九：採用點 → tasks.md 強制轉化
觸發時機：維度 8 寫入知識庫後，立即執行本步驟，不可省略。
對維度 4 的每條採用點，逐條判斷並執行：
| 條件 | 動作 |
|---|---|
| 難度「低」，本次對話可執行 | 直接執行，完成後在 tasks.md 補 [x] |
| 難度「中」，近期可規劃 | 寫入 dev/tasks.md P2，附來源標記 |
| 難度「高」，長期追蹤 | 寫入 dev/tasks.md P3，附評估標準與來源標記 |
| 決定不採用 | 在學習資源.md 條目補「不採用理由」段落說明 |
tasks.md 條目格式：
[ ] P2/P3：[行動描述] — [預期影響]（來源：[影片標題/頻道] [YYYY-MM-DD]）
禁止：應用場景只寫入學習資源.md 而不轉化為 tasks.md 條目，導致知識停留在知識庫、不進入執行軌道。
五、最近修改記錄
| 日期 | 修改內容 | 狀態 |
|---|---|---|
| 2026-04-17 | 初版建立（八維分析框架） | ✅ |
| 2026-04-17 | 新增字幕可用性判斷（路徑 A：YouTube 原生逐字稿 / 路徑 B：fallback 描述分析）+ Dimension 2 擴充 + 品質自查第 6 條 | ✅ |
| 2026-04-18 | 新增步驟九「採用點 → tasks.md 強制轉化」+ 品質自查第 5 條更新（修補：應用場景停留知識庫不進執行軌道的結構性缺口） | ✅ |