Communitygithub.com

C4KEBX/motionexplainers

當使用者要求製作、編寫或產出一部關於金融、投資或歷史的 60 秒垂直動畫解說影片時使用(如「製作一部關於 X 的影片」或「/make-explainer <主題>」)。此技能會執行研究、蒐集有來源的事實、驗證過的分鏡腳本、人工審核關卡,最終產出附旁白的渲染影片。

motionexplainers 是什麼?

此技能為 AI 代理(如 Claude Code)提供一個自動化流水線,用以製作 60 秒的垂直解說影片(解析度 1080×1920),主題涵蓋金融、投資或歷史。其核心流程從研究與來源驗證開始:代理必須使用 WebFetch 實際開啟並閱讀來源頁面,以確保 facts.json 中的每個數字、日期、名稱和引述都有可靠來源。接著,代理會撰寫並檢查結構化分鏡腳本 (`storyboard.json`),並透過 npm 指令驗證其是否符合預先定義的結構(如字數、場景變化)。關鍵的「審核關卡」發生在自動產生之前:系統會生成一份審閱表,使用者必須親自檢視並批准,代理才能執行最終的 `npm run produce` 指令。此設計強制了人機協作,以確保準確性與品質。該技能支援 Claude Code(及其他相容的終端機型代理),並透過一系列嚴格的「硬性規則」來防止資料幻覺,例如禁止根據記憶輸入數字、未經來源驗證不得修改腳本,以及對金融內容必須保持純教育與歷史性立場。最終輸出是一個包含語音旁白、事實來源清單的 MP4 影片檔。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/C4KEBX/motionexplainers/tree/HEAD/.claude/skills/make-explainer

在你喜歡的 AI 中提問

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

說明文件

製作 60 秒解說影片

將一個主題透過本儲存庫的流水線,轉化為完成的 1080x1920 影片。完全免費:由你負責研究、撰寫與修正;腳本負責檢查與渲染。請在儲存庫根目錄下工作。在撰寫分鏡腳本之前,請先閱讀 .claude/skills/make-explainer/rules.md。

嚴格規則

  • 螢幕上顯示的每個數字、日期、名稱與引述,都必須來自於你實際透過 WebFetch 開啟的 facts.json 中的事實。切勿憑記憶輸入任何數字。如果你無法為某個論點找到來源,就刪除它。旁白只能陳述你實際開啟的頁面內容;不要為了補足背景而添加你並未閱讀的論點。
  • 絕對不要為了讓分鏡腳本通過檢查而編輯 src/、tests/、驗證器或此技能本身。應修正分鏡腳本或事實資料。未經重新閱讀來源,不得為了配合分鏡腳本而改變事實資料,反之亦然。
  • 在審核關卡(步驟 6)停下來。在使用者核准審閱表之前,不要執行 npm run produce。
  • 金融與投資內容必須是教育與歷史性質:不得提供建議、不得預測、不得說「你應該」。每個數據都必須標明時期與來源。

工作流程

每部影片的所有資料都存放在 videos/<slug>/ 目錄下(使用小寫字母、數字與連字號):包括 facts.json、storyboard.json、review/。

  1. 簡報。 確定主題、影片要證明的單句主張,以及目標觀眾。如果主張不明確,最多只問一個問題。預設語音為 en-US-AndrewNeural,音樂為 null。
  2. 研究。 先進行網路搜尋,然後使用 WebFetch 擷取主要來源(勞工統計局、聯邦儲備系統、美國證券交易委員會、公司申報文件;歷史日期則使用維基百科或博物館與圖書館頁面)。從頁面上複製數字。撰寫 5 到 8 個事實:id(編號)、claim(一個完整的句子,包含單位與時期,如來源所述)、value(用於單一數字)或 dataset(用於圖表或列表將顯示的完整數據),以及 source(包含名稱與網址)。切勿在論點中留下「示範資料」等字眼。
  3. 驗證。 執行 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;審閱表會標記結果是否已過時。
  4. 腳本與分鏡。 旁白總字數約 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。
  5. 檢查與修復。 執行 npm run check -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json。修正每個問題(每則訊息都會指出場景編號與修正方法)並重新執行,最多 6 輪;如果仍有阻礙,請確切回報原因。將警告(關於長度、建議措辭、未追蹤文字等)視為需要修正或提供理由的事項。長度預估的精確度約在 10% 以內(實際每秒字數範圍為 2.5 到 3.2 字),因此目標是 55 到 60 秒;最終長度以 produce 的判定為準,如果長度被拒絕,只需調整旁白並重新執行即可。
  6. 審核關卡。 執行 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。摘要說明:影片主張、場景列表、字數與預估長度、每個事實及其來源檢查狀態,以及所有警告。請求使用者核准或提出修改。停下來並等待。
  7. 產出。 核准後:執行 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 一次。

向使用者輸出

保持簡短:檔案路徑、影片主張的內容、長度、音量、使用的事實與來源,以及你接受並解釋過的任何警告。

相關技能