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;

---

路徑 A：有字幕（hasCaptions = true）

主方法：YouTube 原生「顯示逐字稿」

1. 捲動頁面至描述區塊（影片下方）
2. 若有「…更多」按鈕，先點擊展開
3. 在描述區塊中尋找「顯示逐字稿」按鈕 → 點擊
4. 等待逐字稿面板展開後，讀取面板全文

依影片長度選批次策略：

讀取工具：

• 開啟面板：mcp__Claude_in_Chrome__computer（點擊操作）
• 讀取內容：mcp__Claude_in_Chrome__get_page_text（讀取面板全文）
• 長影片批次：mcp__Claude_in_Chrome__javascript_tool 滾動面板 + 分段讀取
• ⚠️ 原 timeToSec() 為舊 API 方法，已不適用本路徑

---

路徑 B：無字幕（hasCaptions = false）

1. 用 mcp__Claude_in_Chrome__get_page_text 讀取完整影片描述文字
2. 提取描述內時間戳記清單（若有）作為內容脈絡
3. 在維度 2 記錄：「本影片無字幕，分析基於描述文字 + 時間戳記，非逐字稿」
4. 維度 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：存入知識庫（三步強制執行）

禁止：三步任一未完成 → 維度 8 未完成 = 整個分析未完成。

依影片類型決定 condensed entry 存入位置：

插入位置：<!-- MANUAL END --> 標記之前。

---

Step A：condensed entry → 分類 .md

condensed entry 格式：

## [影片標題]（[YYYY-MM-DD]）

🎬 [YouTube URL]

**頻道**：[頻道名]
**影片時長**：[X 分鐘]
**內容類型**：[工具操作教學 / 方法論框架 / 案例分享 / 商業模式]
**完整分析**：`knowledge/analyses/YYYY-MM-DD-[slug].md`

**摘要**：[2-3 句話，說明影片核心觀點]

**深度分析**：[1-2 句，說明與現有系統的對比發現]

**採用點**：
- [採用點1]
- [採用點2]（最多 3 條）

**用途標籤**：[關鍵詞1、關鍵詞2、關鍵詞3]

---

---

Step B：完整八維分析 → knowledge/analyses/YYYY-MM-DD-[slug].md

檔名規則：YYYY-MM-DD-[頻道縮寫]-[主題關鍵字].md（全小寫英數，空格用 -） 範例：2026-04-17-openspec-multi-agent-architecture.md

檔案格式：

# [影片標題]（[YYYY-MM-DD]）

🎬 [YouTube URL]
**頻道**：[頻道名] ｜ **時長**：[X 分鐘] ｜ **分類**：[knowledge/references/分類名]

---

## 維度 1：影片定性
[完整內容]

## 維度 2：字幕讀取批次記錄
[完整內容]

## 維度 3：核心概念提取
[完整表格與說明]

## 維度 4：可採用點清單
[完整內容]

## 維度 5：明確不採用記錄
[完整內容]

## 維度 6：與現有系統整體對比
[完整內容]

## 維度 7：立即行動
[完整內容]

## 維度 8（確認）
- Step A condensed entry 已寫入：學習資源.md ✅
- Step C index 已更新：knowledge/analyses/README.md ✅

---

Step C：更新雙索引（README.md ＋ topic-index.md）

C-1：knowledge/analyses/README.md — 在 <!-- ANALYSIS INDEX --> 標記之前新增一行：

| YYYY-MM-DD | [影片標題] | YouTube | 學習資源 | [用途標籤] | [高/中/低] | `[filename].md` |

C-2：knowledge/analyses/topic-index.md（⛔ 2026-06-21 補規，RCF-095） — 矩陣末行前插入新列（填 ●/△/空白），依該檔「維護說明」跑密度重算腳本整表覆蓋密度統計（禁手動增量），header 索引條目數 +1。

WHY：原 Step C 只列 README，與 web-learning-sop / 品牌分析同根缺口導致 topic-index 漂移（IMP-166 家族）。

---

四、分析品質自查（輸出前逐項確認）

• 維度 3 每個概念都有比較結論（A/B/C/D），無空白
• 維度 4 每個採用點有難度標記與 tasks.md 等級
• 維度 5 有記錄（即使為空也明確說明）
• Step A 完成：condensed entry 已寫入學習資源.md（+ 可選 methodology/），含「完整分析」連結行
• Step B 完成：完整八維分析已寫入 knowledge/analyses/YYYY-MM-DD-[slug].md（所有維度逐字，無壓縮）
• Step C 完成：knowledge/analyses/README.md 已在 <!-- ANALYSIS INDEX --> 之前新增一行索引記錄
• 步驟九即時評估已啟動（詳細完成確認見步驟九內部品質自查三項）
• 字幕可用性已確認（hasCaptions JS 執行，路徑 A/B 選擇已在維度 2 記錄）

---

步驟九：即時採用評估（v1.0 試行，2026-04-27 起）

觸發時機：維度 8 存入知識庫後立即執行。 核心設計：不重複維度 3-4 的分析——引用已有結論，補充決策，與 Tim 互動確認。 注意：維度 8 完成 ≠ 分析結束；Tim 確認後才是正式完成。

分流判斷

三步驟互動流程

Step 1：開頭列出已執行低難度項目（即使 0 條也明確說明，讓 Tim 有完整視野）

已執行（低難度）：
- [項目] → 已完成 ✅
（若無則寫：本次採用點均為中/高難度，無低難度直接執行項目）

然後引用維度 3-4 摘要（不重新分析）：

待討論採用點：
- [採用點描述]
  → 解決問題：[直接引用維度 4 B欄]
  → 現有對比：[直接引用維度 3 比較結論]
  → 難度/初步等級：[直接引用維度 4]

Step 2：Claude 給建議決定（⚠️ 若本次為 URL 直接觸發分析，此步驟前必須先 Read dev/tasks.md 確認 P1/P2 當前負載，再決定優先級，不可只複製維度 4 的等級）

建議：
- [採用點 A] → P2，理由：[考慮當前負載後的判斷]
- [採用點 B] → P3，理由：[一句話]
- [採用點 C] → 放棄，理由：[一句話]

Step 3：問 Tim 確認（⚠️ 強制等待點：輸出後 Claude 停止，不可在同一則訊息繼續執行）

「你同意這個分配嗎？或有哪條想調整？」

Tim 回應後的執行流程

完成後：tasks.md commit + push（若有修改 analyses/ 或 references/ 則一起 commit）

品質自查對應（本步驟完成後才可確認）

• Step 9 評估完成：已執行低難度列出 + Tim 已確認中 / 高難度分配
• tasks.md 最終寫入完成（按 Tim 確認結果）
• 放棄項目已補寫 analyses/[slug].md 維度 5（若有）+ condensed entry 已同步更新（若有）

試行期管理（v1.0，2026-04-27 起）

• 每次執行後：在對話品質自查 improvements.md 掃描時，主動記錄本次 Step 9 執行狀況（順暢 / 哪裡卡）
• 第 1 次執行結束後：在 Step 3 Tim 確認後，主動問「這是新版步驟九首次執行，流程有沒有哪裡感覺卡？」
• 第 3 次執行後：Claude 主動發起回顧 → 讀取 improvements.md 相關條目 → 輸出「順暢 / 局部調整 / 需重設計」判斷

---

五、最近修改記錄