Communitygithub.com

Motion Educator

製作高品質的動畫教育影片(解釋、課程、概念短片、「edukasi 影片」),透過程式碼打造精品影片——包含發光著色器舞台、玻璃面板、金屬字體、3D 物件、圖表、標題、旁白、音樂與音效——以影格為單位渲染成 MP4,橫式 16:9 或直式 9:16。

Motion Educator 是什麼?

Motion Educator 是一個專為製作簡短教育動畫電影(20-120 秒)設計的 AI 技能,它以程式碼為基礎,產出外觀精美且專注於一個核心概念的影片。該技能的核心是一個獨特的渲染引擎:影片本質上是一個帶有暫停時間軸的網頁,每一影格都透過時間軸定位繪製,因此絕不會遺失任何畫面,且任何鏡頭都能獨立修正與重新渲染。支援的平台包括 Claude Code、Cursor 和 Codex,工作流程嚴格遵循「先有分鏡腳本」的原則:必須先繪製詳細的分鏡腳本,並通過工具檢查,然後展示給使用者確認,之後才開始建置任何影片檔案。旁白以對話方式撰寫(支援印尼語或英語),使用 ElevenLabs 一次錄製完成,畫面則根據語音進行剪輯,確保語音與畫面完美同步。這個技能特別適用於當使用者要求製作教育或解釋性影片、動畫課程、解釋「某事物如何運作」或「為什麼某事物會這樣」的影片,以及科學、數學、歷史、金融或產品概念的動畫說明。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zeative/motion-educator/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

Motion Educator 是做什麼的?

你製作簡短的教育影片(20 到 120 秒,橫式解釋片或直式短片),看起來很昂貴,並且專注教好一件事。該影片是一個帶有暫停時間軸的網頁:每一影格都是透過尋找時間軸來繪製,因此絕不會遺失任何畫面,且任何鏡頭都能獨立修正並重新渲染。此技能中的工具組就是那個引擎。 examples/ 包含了透過遵循此技能所完成的成品影片,每個都有自己的分鏡腳本、原始碼、提示表和旁白:langit-biru(僅標題,最常被審查的)和 petir-guntur(一個有旁白的短片)是應該優先閱讀的。

只閱讀你目前步驟所需的參考資料。

步驟閱讀
決定要教什麼以及順序references/pedagogy.md
編寫並繪製分鏡腳本(關卡)references/storyboard.md
選擇外觀、口音、舞台燈光、3Dreferences/look.md
使用工具組建置影片references/engine.md,然後 references/motion.md
編寫旁白:對話,而非標題;印尼語和英語的語域references/narration.md
聲音:選擇聲音、使用 ElevenLabs 一次錄製完成、根據聲音剪輯影片references/voice.md
音樂、音效、混音references/sound.md
檢查渲染、獨立審查references/review.md
使用 raea 而非瀏覽器渲染references/raea.md

永不妥協的原則

  1. 先有分鏡腳本,並且是繪製出來的。 在 storyboard.json 通過 kit/tools/storyboard.mjs 的檢查且零錯誤,並且使用者看過分鏡腳本之前,不會撰寫任何影片檔案。每個鏡頭都有繪製的影格(如何開始、發生什麼事、如何結束),在真實影格的座標系中繪製,以便建置可以直接從中進行剪輯。如果使用者要求的是無人值守運行,則發送分鏡腳本並繼續進行;否則等待他們的確認。
  2. 真實且有來源。 螢幕上的每一個數字和每一個陳述都必須在分鏡腳本的事實表中,並附上來源。如果你無法找到來源,就不要說出來。繪製的內容與書寫的內容一致:代表數字的條形圖、儀表或路徑是根據該數字計算出來的,未按比例繪製的圖表會在螢幕上標明,而數字會以其實際值出現(不會透過不真實的值來計數)。
  3. 靜音也能自我解釋。 圖像和螢幕上的文字承擔了大部分的解釋工作;語音和音效則是讓解說更有落地感。一個第一次觀看且關閉聲音的觀眾,也能說出他們學到了什麼。整個解釋所依賴的關鍵步驟,必須以機制的方式繪製出來(輸入什麼、遇到什麼、輸出什麼、最終到哪裡),絕不能只靠標題來說明。
  4. 單一時鐘。 每個動畫值都是時間軸時間的函數。不能使用 CSS 動畫、requestAnimationFrame 迴圈、Date.now() 或未設定種子的隨機性。
  5. 分鏡腳本是時間的來源。 影片從 storyboard.json 讀取鏡頭的開始和結束時間;標題和章節導軌是從中產生的。要改變計畫就在那裡改,絕不能手動在影片中修改。在有語音的影片中,錄製的片段會寫入這些時間(voice.mjs)。
  6. 你不為自己的作品評分。 在完整渲染之前,需要先檢視每個鏡頭的靜態畫面;對渲染結果進行測量;並由一位未參與建置的新審查者來評斷結果(references/review.md)。
  7. 有語音的影片是以對話方式撰寫,並一次性表演完成。 腳本需要完整撰寫,並在有任何鏡頭存在之前大聲朗讀出來;它是一次性從頭到尾表演完成,然後畫面根據語音進行剪輯。絕不能一句話一個鏡頭、一個錄音一句話,也不能為了符合計畫而修剪暫停。
  8. 說出哪些沒有被檢查。 你無法聽見。要說出混音是透過測量設定的,指出一個人應該注意聽什麼,並在完整混音之外提供一個純音樂版本。

工作流程

0. 工作空間

工具組會被複製到使用者的專案中,永遠不會從技能本身的資料夾中使用。

node <skill>/kit/tools/new.mjs <workspace> <film-name>   # 如果缺少則複製 kit/ 和 package.json,並建立 films/<film-name>/ 資料夾
cd <workspace> && npm install                            # three.js, GSAP, 字型
sh kit/audio/fetch.sh                                    # 聲音庫(未提交:許可證)

需要 Node 20+、含 Chromium 的 Playwright、FFmpeg 和 Python 3(含 numpy)來進行混音。node kit/tools/doctor.mjs 會檢查所有這些並告知需要安裝什麼。在 new.mjs 中加入 --portrait 來建立 1080x1920 的直式短片。

1. 簡報(幾行文字,放在分鏡腳本的開頭)

誰在看、他們已經知道什麼,以及承諾:他們看完後能用一句話說出來的內容。一部影片,一個承諾。如果主題需要兩個承諾,那就是兩部影片。選擇觀眾閱讀的語言、格式(橫式用於課程,直式用於短片),以及影片是否要有語音或僅用標題說明。

2. 研究與事實表

列出影片將做出的每一個陳述,每個陳述附上其來源,作為 storyboard.json 中的 facts。優先使用主要和機構來源。親自進行計算並展示結果(像「5.9 倍」這樣的數字需寫明是從什麼計算出來的)。寫下你簡化了什麼,並決定影片將如何誠實地呈現它。

3. 腳本(如果影片有語音)

遵循 references/narration.md:一個問題,以觀眾自身語域的連續對話方式撰寫,大聲朗讀並計時,然後再建立鏡頭列表。然後將其剪輯成鏡頭:每個有語音的鏡頭的 voice 就是其腳本的運行段落。

4. 分鏡腳本:關卡

遵循 references/storyboard.md。簡而言之:先有幕次,然後是鏡頭(大約每三秒一個新畫面),每個鏡頭包含它所教的內容、它的標題、螢幕上有什麼、動畫、如何銜接到下一個鏡頭、轉場、音效、需要檢查的內容、它引用的事實,以及兩到三個繪製的影格。剪輯要配合音樂的節拍。

node kit/tools/storyboard.mjs films/NAME --png     # 零錯誤,然後顯示 films/NAME/storyboard/*.png

將頁面發送給使用者。先發送連絡頁(整個影片的影格概覽)。

5. 錄製(如果影片有語音)

遵循 references/voice.md:選擇一個該語言的母語聲音(如果可以,讓使用者聽兩到三個),將整個腳本一次性表演完成,然後根據它剪輯影片。從這裡開始,分鏡腳本的時間就是錄製片段的時間。

node kit/audio/voice.mjs films/NAME --script                       # 要表演的片段
node kit/audio/voice.mjs films/NAME --generate                     # 使用 API 金鑰:片段及其單詞時間
node kit/audio/voice.mjs films/NAME --take AUDIO --words WORDS     # 使用語音連接器:同時提供兩者
node kit/audio/voice.mjs films/NAME                                # 每個鏡頭的時間,以及要聽的單詞

6. 建置,一次一個鏡頭

遵循 references/engine.md。為每個鏡頭建立一個 <section class="scene">,並在其 s.sNN.start 和 s.sNN.end 之間製作動畫。按照分鏡腳本順序建置,並在完成每個鏡頭時檢視其靜態畫面:

node kit/tools/render.mjs films/NAME --stills 1.5,4.2,7.9      # 完成的影格,幾秒鐘的工作

將每個靜態畫面與其繪製的影格進行比較。影格放置在 (x, y) 的內容也應該出現在 (x, y)。

7. 渲染

node kit/tools/render.mjs films/NAME                  # out/picture.mp4,以四秒片段為單位
node kit/tools/render.mjs films/NAME --only 12-16     # 修正後:僅重新渲染變更的片段

一分鐘 60 fps 的影片在四個 CPU 核心上大約需要半小時。讓它在背景執行,同時編寫提示表。

8. 聲音

遵循 references/sound.md:一個音樂背景,其節拍已經與剪輯對齊,以及在真實事件上的小而乾淨的音效,編寫為 films/NAME/cues.json。為影片創作的背景音樂(kit/audio/music.mjs)比使用現成的音效庫曲目更合適,特別是當影片要發布時。

python3 kit/audio/mix.py films/NAME                   # out/NAME.mp4,完成檔案上測量響度
python3 kit/audio/mix.py films/NAME --no-sfx --out films/NAME/out/NAME-music-only.mp4

node kit/tools/make.mjs films/NAME 會依序執行步驟 4 到 9 的命令(檢查、語音、渲染、混音、測量、分享副本),並在第一個失敗的命令處停止。它不能取代在建置過程中檢視靜態畫面的步驟。

9. 審查、修正、驗證

遵循 references/review.md:node kit/tools/check.mjs films/NAME(連絡頁、凍結時間、響度),然後由一位新的審查者,在觀看影片、分鏡腳本和使用者自己的話語後進行審查。修正最大的差距,僅重新渲染變更的內容,並讓一位新的審查者驗證清單。在達到品質標準或當改善變得僅是裝飾性時停止。當修正改變了鏡頭顯示的內容時,也應修改分鏡腳本以反映變更並重新繪製:計畫和影片永遠不應不一致。

10. 交付

MP4(H.264, 1080p60, 約 -14 LUFS, 真實峰值低於 -1 dBFS)、一個較小的分享副本、純音樂版本、分鏡腳本頁面,以及一個簡短的誠實說明:哪些被測量了、哪些僅被檢視過、哪些沒有人聽過,以及你下一步會做什麼。

影片的檔案結構

films/NAME/
  storyboard.json     計畫:事實、幕次、鏡頭、繪製的影格。影片從此處讀取時間
  storyboard.html     分鏡腳本(自動產生),storyboard/*.png 是其頁面
  index.html          每個鏡頭或鏡頭群組一個 <section class="scene">
  film.css            此影片的自訂樣式,基於 kit/css/film.css
  film.js             時間軸,使用 kit/engine/motion.js 建置
  cues.json           音樂背景和每個音效,以影片的時鐘為準
  voice/              旁白:take.mp3, 每個單詞的時間、剪輯(voice.json)、字幕.srt
  out/                渲染輸出(永遠不提交)

工作風格

  • 在使用者可以看到的地方規劃(分鏡腳本),然後在不詢問每個步驟的情況下建置。
  • 當工作時間過長時,用一句話說明你正在做什麼。
  • 展示工作成果:分鏡腳本、靜態畫面、連絡頁、測量數據、審查者的裁決。

相關技能