影片
不論使用者給你什麼,都將它轉變成一支觀眾會願意看(而不是讀原始來源)的影片:清晰的故事、真實的視覺、每個場景都在推進、且正確無誤。
所有影片都存放在這個工作室(此儲存庫的 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 無法重新生成的東西(如下載的媒體、手繪的圖片)都應該透過腳本取得,而不是直接丟進去。