Communitygithub.com

triptu/create-explainer-videos

將任何內容(部落格文章、論文、PR、分支、diff、儲存庫或筆記)製作成附有旁白和字幕的解說影片,或修改現有影片。

create-explainer-videos 是什麼?

這個技能讓 AI 代理能從各種來源(文章 URL、PR、程式碼差異、儲存庫或粗略筆記)自動生成高品質的解說影片。它會先完整閱讀原始材料(而非摘要),找出核心故事線,然後撰寫口語化旁白、設計動態視覺(使用真實截圖、程式碼片段和自訂動畫),最後按照 CLAUDE.md 中定義的流程渲染輸出。支援的平台包括任何文字內容、GitHub PR 或差異、以及儲存庫;可透過「make a video of…」、「/video <連結>」、「解釋這個影片」等指令觸發,或對先前影片進行場景調整、縮短、變更語音或重新渲染。關鍵設計原則是:影片應比閱讀原始來源更具吸引力,且代理必須具備資源回收能力(搜尋網路、檢查原始碼、執行專案)來驗證事實、填補上下文和尋找更好的視覺素材。

相容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/triptu/create-explainer-videos/tree/HEAD/.claude/skills/video

在你喜歡的 AI 中提問

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

說明文件

影片

不論使用者給你什麼,都將它轉變成一支觀眾會願意看(而不是讀原始來源)的影片:清晰的故事、真實的視覺、每個場景都在推進、且正確無誤。

所有影片都存放在這個工作室(此儲存庫的 videos/ 資料夾中)。先讀 CLAUDE.md:裡面有指令、工作流程、場景慣例和常見陷阱。這個技能文件關乎判斷;CLAUDE.md 關乎技術細節。絕對不要從頭建立新專案。請使用 npm run new,或直接在 videos/ 中編輯現有影片。

如何進行

從頭到尾完整執行。 做出合理的假設、建立影片,並回報你假設了什麼。只有在使用者明確要求你確認,或你真的遇到阻礙(來源無法存取,或真的不清楚他們指的是哪些 PR 或範圍)時,才暫停提問。

要足智多謀。 目標是做出最好的影片,而不是只求過關的最低限度。使用任何有幫助的工具:網路搜尋、來源的參考文獻和連結頁面、相關文章或文件、作者先前的作品、gh、複製並執行程式碼、實際產品,以及其他技能。填補遺漏的脈絡、驗證聲明、尋找更好的視覺素材,並弄清楚某個術語或系統的真正含義,而不是亂猜。狹窄的來源不該限制你的可能性。如果某個方法失敗了,在妥協之前先試試其他方法。

觀眾預設:

  • 文章、貼文和論文:外部觀眾。 觀看者是沒讀過原始來源的聰明觀眾。
  • PR、分支、儲存庫和程式碼:內部觀眾。 觀看者就是使用者,他想了解做了什麼,通常是因為他準備要審查。目標是「我現在可以自信地審查或討論這個了」。只有當使用者明確要求時,才將其做成公開或發表風格的影片。

長度由內容決定。 一個小 PR 可能 1-2 分鐘;一篇內容密集的文章,5-8 分鐘。不要灌水,也不要硬塞。一個場景一個概念。

1. 比隨便瀏覽更深入地理解它

在寫任何一個字之前,先去取得原始材料並完整閱讀。

  • 連結和論文: 取得頁面本身。先嘗試原始 HTML,如果它是客戶端渲染、你需要看到或錄製視覺素材、或被封鎖(請見 CLAUDE.md),則改用 Playwright。絕對不要只依賴摘要。取得完整文字以及每一張圖表、影片和互動元素。如果位於登入牆後面,請明確告知。
  • PR 和 diff: 描述、完整 diff、提交記錄、審查討論串、關聯的 issue、CI 結果。也要閱讀周圍的程式碼,而不只是變更的行:呼叫者、資料流程、測試。弄清楚為什麼要這樣做、有哪些替代方案、以及風險在哪裡。如果觀察行為有幫助,就執行它並捕捉前後對比。
  • 儲存庫: 進入點、架構、主要的資料或控制流程,以及特殊之處。
  • 筆記或主題: 做足夠的研究以確保正確,並引用聲明的來源。

2. 找出故事

先決定一句話的重點,然後規劃出能證明這個重點的敘事弧線。通常是:問題、關鍵洞見、運作方式、證據,以及它的意義。對於以審查為導向的 PR 影片,還需要涵蓋:變更的形狀、重要的決策、風險或微妙之處、測試方式,以及審查者應該關注的地方。

用自己的話寫出適合聽的旁白。保留原始來源中的確切數字、名稱和引述,絕對不要編造指標。如果你簡化了,要保持真實。

語音:預設使用 Kokoro。如果使用者想要更自然的語音,或 .env 中有 OPENROUTER_API_KEY,則使用 Gemini TTS(請見 CLAUDE.md 中的「語音」章節)。

3. 讓它視覺化

  • 優先使用真實素材: 原始來源自己的圖表和錄影、實際的使用者介面(執行中應用程式的螢幕截圖或錄影)、以及以聚焦片段加上重點標記行顯示的真實程式碼,絕不要顯示一整面牆的程式碼。
  • 其他情況使用自訂動畫圖表: 流程圖、前後對比、架構圖、遞增的數字、比較。每個場景都應該有能解釋概念的動態元素,並與旁白同步。
  • 主題: 配合原始來源的品牌。對於沒有品牌的程式碼,可採用產品的風格或乾淨、適合程式碼的主題。

4. 驗證,然後交付

依照 CLAUDE.md 中的「檢查 → 靜態圖 → 預覽 → 完整渲染」循環。檢查靜態圖並修正你所看到的問題,包括重疊、空白過長、文字無法閱讀、以及時間點與旁白不匹配。然後回報:輸出路徑、長度、影片涵蓋的內容、你驗證了什麼,以及任何假設或落差。明確說明你尚未從頭看到尾。

讓工作室變得更好

如果你遇到了可重複使用的陷阱,請將其加入 CLAUDE.md。如果你建立了其他影片也會用到的東西(例如程式碼差異場景、PR 時間線、圖表原語),請將其移到 lib/ 或 templates/default。videos/*/public/ 中的生成素材是被 gitignore 的,因此任何全新 clone 無法重新生成的東西(如下載的媒體、手繪的圖片)都應該透過腳本取得,而不是直接丟進去。

相關技能