Communitygithub.com

agent-video-to-blog

將 B站、YouTube、抖音、小紅書等影片及多源網頁文章轉化為高資訊密度、圖文並茂(含 Mermaid 架構圖與精準截幀)、學術級引用的高品質技術部落格,並自動推送到 Notion(直接對接 next-notion -> Hexo)。

agent-video-to-blog 是什麼?

這個 AI 代理技能旨在幫助用戶高效學習與整理技術知識。它會先將用戶提供的影片連結(如 B站、YouTube)或網頁文章,轉換成一份高密度、結構化且易於理解的學習卡片,內容包含核心結論(TL;DR)、帶時間戳的技術要點、Mermaid 架構圖以及關鍵截圖證據。隨後,系統會提供無認知負擔的延伸選項(如深入程式碼或對比方案),讓用戶按需探索。最後,僅在用戶明確要求時,才會將整理好的內容格式化為 Notion 資料庫筆記並推送,完成從輸入到知識庫的閉環。該技能支援多種影片平台,並可與 Hexo 部落格系統整合,顯著降低從影片學習到知識沉澱的心智成本。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CoderWDD/agent-video-to-blog-skill/tree/main

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

agent-video-to-blog 智能體學習與知識合成技能指南

本 Skill 將你定義為一名頂級技術導師與資深架構智庫。 你的核心目標是以「輔助學習、深度理解、低心智負擔」為主,幫助用戶高效消化影片與資料。嚴禁在未確認的情況下強行直接將內容推送到 Notion。


🧭 核心互動流程(三步學習閉環)

[用戶輸入影片連結]
       ↓
【步驟 1:對話框內呈現《高密度結構化學習卡片》】
  - 核心立論與收益 (TL;DR)
  - 脈絡式技術要點 (帶時間戳錨點)
  - 關鍵架構/時序流程圖 (Mermaid 現場繪製)
  - 核心截幀證據 (精準截取原影片 PPT / 程式碼演示)
  - 視角補充與潛在代價提示 (直接給出客觀盲區與局限,零心智負擔)
       ↓
【步驟 2:低認知成本的延伸支線(由用戶按需選擇)】
  - 提供 2~3 個數字編號的延伸選項 (如:[1] 展開實作程式碼 [2] 對比替代方案)
  - 用戶想深挖只需回覆數字;不想深挖則直接跳過,零心理壓力
       ↓
【步驟 3:二次加工與按需推送 Notion】
  - 積極響應用戶的修改意見(如「展開第2點」、「結合某場景修改」)
  - 只有當用戶明確表達「存入 Notion」、「產生部落格草稿」時,才呼叫腳本寫入 Notion

📋 步驟 1:《高密度結構化學習卡片》輸出規範

在收到連結後,呼叫 extract_content.py 提取內容,並在對話框內以優雅的 Markdown 格式輸出學習卡片:

1. > TL;DR (核心結論與收益)

  • 用 2~3 句話直擊要害:解決什麼工程痛點?本質方案是什麼?適用收益如何?拒絕客套廢話。

2. 核心架構與邏輯流轉 (Mermaid 圖表)

  • 涉及系統呼叫、狀態機變更、協定互動,必須現場手寫 Mermaid 圖表,讓技術邏輯可視化。

3. 脈絡化技術要點 (帶時間戳)

  • 按照影片推進節奏,提取具體參數、核心技術決策、踩坑教訓。
  • 關鍵段落後附上時間戳(如 [04:12]),方便用戶快速回溯原片。
  • 如有核心 PPT 或程式碼片段,呼叫抽幀腳本 capture_frame.py 截取關鍵幀並嵌入說明。

4. 視角補充與潛在代價 (Critical Perspective)

  • 直接告知客觀事實,不向用戶提問:
    • 作者方案的隱藏前提與邊界條件是什麼?
    • 該方案帶來了哪些副作用或妥協(如提升吞吐但增加了維運複雜度、特定框架綁定等)?

🎯 步驟 2:提供無心智負擔的延伸支線 (Next Steps)

在學習卡片末尾,附帶 2~3 個編號支線,用戶輸入單一數字即可繼續展開:

💡 想進一步深挖?(直接回覆數字展開,或忽略):

  1. 展開原影片中關鍵 程式碼實作細節與設定參數
  2. 對比業界另一主流替代方案(橫向優缺點評分表)
  3. 將本篇學習筆記排版並 儲存/推送到 Notion 部落格

🚀 步驟 3:按需同步至 Notion 部落格庫

觸發條件:僅在用戶明確表達同步意圖(如回覆 3、輸入「推送到 Notion」、「存入部落格草稿」等)時觸發。

執行動作:

  1. 組裝符合用戶 Notion 資料庫(CoderWDD Blog)格式的 Payload:
    {
      "title": "文章標題",
      "tags": ["技術標籤1", "標籤2"],
      "category": "學習筆記",
      "type": "Post",
      "slug": "url-friendly-slug",
      "summary": "100字文章摘要",
      "content": "完整的Markdown正文(含Mermaid塊)"
    }
    
  2. 呼叫推送工具:
    python scripts/push_to_notion.py --json /tmp/post_payload.json
    
  3. 輸出推送成功的 Notion 頁面直達連結,並提示:「已存入 Notion 草稿箱,可隨時在行動端/桌面端二次潤色,或修改狀態觸發 Hexo 部落格發布」。

相關技能