製作 60 秒解說影片
將一個主題透過本儲存庫的流水線,轉化為完成的 1080x1920 影片。完全免費:由你負責研究、撰寫與修正;腳本負責檢查與渲染。請在儲存庫根目錄下工作。在撰寫分鏡腳本之前,請先閱讀 .claude/skills/make-explainer/rules.md。
嚴格規則
- 螢幕上顯示的每個數字、日期、名稱與引述,都必須來自於你實際透過 WebFetch 開啟的
facts.json中的事實。切勿憑記憶輸入任何數字。如果你無法為某個論點找到來源,就刪除它。旁白只能陳述你實際開啟的頁面內容;不要為了補足背景而添加你並未閱讀的論點。 - 絕對不要為了讓分鏡腳本通過檢查而編輯
src/、tests/、驗證器或此技能本身。應修正分鏡腳本或事實資料。未經重新閱讀來源,不得為了配合分鏡腳本而改變事實資料,反之亦然。 - 在審核關卡(步驟 6)停下來。在使用者核准審閱表之前,不要執行
npm run produce。 - 金融與投資內容必須是教育與歷史性質:不得提供建議、不得預測、不得說「你應該」。每個數據都必須標明時期與來源。
工作流程
每部影片的所有資料都存放在 videos/<slug>/ 目錄下(使用小寫字母、數字與連字號):包括 facts.json、storyboard.json、review/。
- 簡報。 確定主題、影片要證明的單句主張,以及目標觀眾。如果主張不明確,最多只問一個問題。預設語音為
en-US-AndrewNeural,音樂為null。 - 研究。 先進行網路搜尋,然後使用 WebFetch 擷取主要來源(勞工統計局、聯邦儲備系統、美國證券交易委員會、公司申報文件;歷史日期則使用維基百科或博物館與圖書館頁面)。從頁面上複製數字。撰寫 5 到 8 個事實:
id(編號)、claim(一個完整的句子,包含單位與時期,如來源所述)、value(用於單一數字)或dataset(用於圖表或列表將顯示的完整數據),以及source(包含名稱與網址)。切勿在論點中留下「示範資料」等字眼。 - 驗證。 執行
npm run verify-facts -- --facts videos/<slug>/facts.json --out videos/<slug>/verify.json。對於每個標記為not-found、partial或unreachable的事實:重新開啟來源,修正或刪除該事實。此工具僅供參考;你需對準確性負全責。一個小的整數(如 8, 9, 27)幾乎在任何頁面上都會出現,因此supported狀態對其證明力很弱:你必須親自閱讀來源行。在你因任何原因編輯facts.json後,必須再次執行verify-facts;審閱表會標記結果是否已過時。 - 腳本與分鏡。 旁白總字數約 155 字(約 55 到 60 秒),包含 6 到 10 個場景,第 1 場景需要有鉤子(hook),每個場景傳達一個想法,場景類型需多樣化(不可連續三個相同類型)。請使用
storyboard.schema.json了解確切欄位與限制,並參考fixtures/finance.storyboard.json、fixtures/history.storyboard.json與fixtures/ancient.storyboard.json的結構。撰寫videos/<slug>/storyboard.json。 - 檢查與修復。 執行
npm run check -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json。修正每個問題(每則訊息都會指出場景編號與修正方法)並重新執行,最多 6 輪;如果仍有阻礙,請確切回報原因。將警告(關於長度、建議措辭、未追蹤文字等)視為需要修正或提供理由的事項。長度預估的精確度約在 10% 以內(實際每秒字數範圍為 2.5 到 3.2 字),因此目標是 55 到 60 秒;最終長度以produce的判定為準,如果長度被拒絕,只需調整旁白並重新執行即可。 - 審核關卡。 執行
npm run sheet -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json --verify videos/<slug>/verify.json --out videos/<slug>/review。通知使用者開啟videos/<slug>/review/review.html。摘要說明:影片主張、場景列表、字數與預估長度、每個事實及其來源檢查狀態,以及所有警告。請求使用者核准或提出修改。停下來並等待。 - 產出。 核准後:執行
npm run produce -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json --out out/<slug>。此過程約需兩分鐘。如果它拒絕長度或某場景過短,請修改旁白,重新執行check,然後再次產出(語音音訊會根據文字快取)。回報檔案路徑、長度與音量。明確說明你未進行判斷的事項:語音品質、發音、節奏與品味。請使用者觀看。
遇到問題時
- 看不懂檢查訊息: 訊息會指出場景 ID;請在
rules.md中開啟該場景查看其限制。不要猜測如何修正。 - 事實與場景不符: 重新開啟來源。根據來源修正錯誤的一方,切勿直接將一方內容複製到另一方。
- 地圖區域找不到: 使用訊息建議的地圖集拼寫(例如「United States of America」);區域必須與
focus框重疊。 - 語音問題(網路):
npm run produce需要網路連線以使用 Edge TTS;--voice standin參數可僅用於乾執行(dry run),提供近似靜音的佔位音訊。 - 缺少設定: 先執行
npm install與npm run setup:tts一次。
向使用者輸出
保持簡短:檔案路徑、影片主張的內容、長度、音量、使用的事實與來源,以及你接受並解釋過的任何警告。