Communitygithub.com

MrRoam/explainer-video-skill

製作中文解說影片、科普影片、原理動畫或 3Blue1Brown 風格的影片解說。使用 Codex 撰寫講稿與分鏡,並透過本機的 Manim、Kokoro 配音與 FFmpeg 產出 MP4 與字幕。

explainer-video-skill 是什麼?

本技能旨在協助開發者與 AI 代理快速產出高品質的中文解說影片,特別適合用於「製作一個關於 X 的解說影片」這類需求。它結合 Codex 生成內容與動畫程式碼,並利用本機工具(Manim、Kokoro、FFmpeg)完成配音、渲染與合成,無需依賴外部 API。預設採用 3Blue1Brown 風格的圖形推理視覺化方式(深色背景、強調色、漸變動畫、局部放大),並以初學者為目標受眾,輸出 720p、30 fps、約一分鐘的影片。本技能支援 Windows 環境,提供 PowerShell 安裝腳本自動配置依賴;工作流程包含講稿與分鏡同步修改、低解析度預覽、最終輸出 MP4 與 SRT 字幕。此外,它也支援自訂本地語音(Kokoro 中文版)與音訊資源,並提供詳細的管線文件以整合其他音源。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add MrRoam/explainer-video-skill

在你喜歡的 AI 中提問

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

說明文件

中文解說影片

交付可播放的客製化影片。Codex 負責內容與動畫程式碼,本機工具負責配音、渲染和合成。預設中文、面向初學者、約一分鐘、720p、30 fps;使用者當次要求優先。

預設借鏡 3Blue1Brown 的圖形推理方法:深色背景、少量有固定含義的強調色、連續圖形變化、局部放大,以及公式與圖形之間的對應變換。先建立直覺,再給出公式。為當前主題撰寫原創講稿和畫面。

復用工具

本機配置為技能根目錄的 runtime.local.json,也可透過 EXPLAINER_RUNTIME 或 --runtime 指定。先檢查配置中的 Python、FFmpeg、配音模型與可用中文字型。配置缺失時,按 README.md 配置已有環境或安裝缺少的依賴。不要為試玩搭建常駐服務或重複安裝可復用的環境。

Windows 首次安裝可執行 scripts/setup.ps1,自動安裝所需 CPU 依賴、下載中文模型並儲存本機配置。已有有效配置時只檢查路徑;腳本不安裝 Python、TeX 或 CUDA。已有工具放在其他目錄時,傳入對應環境和模型路徑以復用。

python "SKILL_DIR\scripts\init_project.py" --workspace "WORKSPACE" --name concept-video

SKILL_DIR 為目前技能目錄,WORKSPACE 為本次工作區的絕對路徑。腳本只複製小型範本,不下載依賴。原始碼在 outputs/concept-video-project,快取在 work/explainer/concept-video。多個影片使用不同 name;工具被移動後重新配置路徑。

編寫與製作

同時修改專案中的 lesson.json 與 scene.py。範本為導數範例;只改標題不會變成新主題。欄位、分鏡同步和執行命令請見 references/pipeline.md。

選一個具體問題,從例子走到原理。每段旁白對應可觀察的變化,例如點移動、曲線改變、變數更新或關係逐步顯現。數學結論寫清成立條件,字幕、公式和數字與講稿一致。字型取自本機配置;範本中的 MathTex 需要 TeX,缺少 TeX 時可改用 Text 與幾何物件。

預設使用本機 Kokoro 中文版、CPU 和已下載音色,無需額外大模型或語音 API。旁白中的數學符號、LaTeX 和英文術語要改寫為中文讀法。先做短段試聽,再生成整片;不要自動下載全部音色或無提示更換配音後端。其他音訊可按 references/pipeline.md 接入。

檢查與交付

先出低解析度預覽,檢查中文、公式、遮擋和邊界,再匯出最終影片。檢查旁白非靜音、每段完整、結尾不截斷。渲染腳本會檢查尺寸和時間同步,視覺與讀音仍需實際檢查。

交付 MP4、SRT、中文講稿與可重做原始碼。交付檔案放工作區 outputs,中間檔案放 work。說明實際配音後端和未解決限制;不要把腳本成功描述為使用者已滿意音質。

相關技能