Communitygithub.com

科學動畫科普視頻

用代碼製作科普、講解類動畫視頻,涵蓋科學、語言學習、生活常識、產品講解等知識主題。先確定用途,查證資料並給予出處;再提供三種風格方案,製作預覽;用戶確認後按鏡頭逐步完成並合成輸出。

科學動畫科普視頻 是什麼?

這是一個專注於用純代碼(Remotion + Python)製作知識科普動畫視頻的 AI 助手技能。它支援多種平台(如 Claude Code、Cursor、Codex),主要用於將文字、文章、產品網址或程式碼庫轉化為具有動畫效果的影片。技能的核心工作流程包含:先詢問使用者的想法或素材,進行真實資料查證並附上來源;接著提出三種風格迥異的方案(FLASH 動畫風、像素卡帶風、依題材另選的自定義風格),每種方案都產出一張關鍵幀或 2-4 秒的小樣;用戶選擇後,生成詳細的 `brief.md` 文件,然後逐個鏡頭製作,並透過靜幀進行自檢;最後根據背景音樂的節拍合成音效、混音並輸出 MP4 影片。同時,它還會自動生成 3:4 和 4:3 兩種比例的封面。這個技能特別適合需要快速產出高品質、程式化動畫影片的開發者或內容創作者。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dominoeffect/science-video-skill/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

代碼動畫科普視頻

所有畫面都用 Remotion 純代碼畫,音效用 Python 合成。先給三個方案和預覽,用戶選定後寫成 brief.md,再逐個鏡頭做。

硬性規則

  • 只用本 Skill 的做法。 不要用別的工作流或別的項目裡的做法來替代這裡寫明的步驟。
  • 資料必須真實、有連結。 每條都要親自打開或下載核對。核對不到的標「未核實」,二手解讀要寫清是誰讀出來的。不編數字,不寫找不到出處的說法。
  • 每一步都要用戶確認後再往下走: 資料清單 → 三個方案和預覽 → 聲音檔位 → 封面。brief.md 寫好後要告訴用戶放在哪裡。
  • 不配旁白(除非用戶要求)。資訊全靠畫面文字。背景音樂用用戶給的(用戶必須有權使用),動作音效自己合成並卡點。倉庫不附帶音樂檔案。
  • 文字:不重疊、看得清、停留夠久、不堆大段文字。畫面要豐富,主角(人物、動物或物體)要畫得細緻生動。
  • 默認規格:橫屏 1920×1080、30fps;用戶要豎屏/抖音/短視頻時用 1080×1920(scenes.json 的 style 設為 "vflash")。時長等於背景音樂時長(沒有音樂時可指定時長和 BPM)。

工作目錄

<主題>/                    例:~/videos/<主題>
  demo.mp3 / demo.mp4      用戶給的背景音樂、參考視頻(可選)
  source/                  sources.md(資料清單)、ref-notes.md(參考視頻分析)、原材料
  previews/                plan-a.png、plan-b.mp4、plan-c.png(三個方案的預覽)
  brief.md                 確認後的完整方案,也是可以複用的提示詞
  video/                   Remotion 工程(由 new_project.py 或 new_project.ps1 生成)
  qa/                      逐鏡頭靜幀、整片抽幀圖、review_log.md
  <片名>.mp4               成片
  封面/                    封面_3比4_豎版.jpg、封面_4比3_橫版.jpg

第 0 步:建工程

python <skill>/scripts/new_project.py --project "<主題目錄>"
# 沒有背景音樂時:... --no-music --duration 60 --bpm 120

Windows 也可用 scripts/new_project.ps1。這個腳本依次做這些事:

  1. 檢查環境(scripts/check_env.py)。缺什麼會打印出來;裝之前先徵得用戶同意。
  2. 建工作目錄。
  3. 複製模板。
  4. 拷字體。
  5. 執行 npm install。
  6. 測節拍,寫入 src/grid.json。
  7. 出第一版混音。

整個過程要 1–3 分鐘。若在需要後台運行長命令的環境裡,請後台啟動再輪詢輸出(見 references/pitfalls.md)。

模板裡是一支約 12 秒的通用佔位示例,用來確認工程能渲染。換主題後要重寫場景、字幕和音效。完整的多鏡頭示例見 examples/bait-color/(可選對照,不是默認內容)。

第 1 步:問清楚要做什麼

用戶可以給以下任意幾種原材料,混著給也行:

  • 想法:一句話主題也可以。
  • 原內容:文章、口播稿、產品網址、程式碼庫、資料表。
  • 參考視頻、背景音樂。

追問最多 3 個,只問會改變方案的:時長、畫幅、要不要旁白、指定的品牌色或字體。用戶沒說的用默認值,並在方案裡寫明,讓用戶改。

處理原材料:

  • 科普、事實類主題:按 references/research.md 查資料、核對,寫進 source/sources.md,交給用戶確認。
  • 文章、口播稿:提煉核心資訊、受眾和必須出現的事實。事實只能來自原材料,不確定的不寫。
  • 產品網址:讀頁面,記下產品名、功能、口號和品牌色。要截圖時先徵得同意。
  • 程式碼庫:讀 README 和關鍵檔案,提煉功能點,不編功能。
  • 參考視頻:
    • 連結要先徵得同意再下載。
    • 用 ffprobe 量規格。
    • 用 ffmpeg -vf "select='gt(scene,0.3)',showinfo" 找鏡頭切換點。
    • 每秒抽 1 幀拼成聯繫表。
    • 把鏡頭結構、節奏、配色、字體和手法寫進 source/ref-notes.md。
    • 只學結構和手法,不搬素材和文案。
  • 背景音樂:建工程腳本已經測過節拍,會打印 BPM、段落邊界和漂移,方案和分鏡都按它排。

第 2 步:給三個方案

按 references/plans.md 寫,三個方案的分工是固定的:

方案風格技術講法
AFLASH 動畫風(扁平插畫)Remotion + SVG 扁平插畫組件穩妥:設問 → 實驗/數據 → 結論 → 記住三件事
B像素卡帶風(復古遊戲機 + CRT 老電視)Canvas 2D 像素畫布 → WebGL CRT 著色器遊戲化:選卡帶就是選關卡,HUD 顯示數據,對話框講結論,結算畫面給結果
C屆時建議:從 plans.md 的候選表裡挑最貼題材的,或自己提一個能用 Remotion 做出來的和 A、B 都不同換一種講法:一鏡到底、貫穿全片的主角、倒敘、一個比喻講完

每個方案都要寫清楚:名字、一句話概括、風格(配色色值和字體)、規格、技術組合、逐鏡頭畫面概括(帶時間段)、聲音、預計渲染時間、難點和風險,以及為什麼適合這份原材料。

三個方案要在風格、技術和講法上都明顯不同,不能只是換個配色。

第 3 步:每個方案出預覽

  1. 在 video/src/preview/PlanA.tsx、PlanB.tsx、PlanC.tsx 裡各搭一個最能代表這個方案的鏡頭,時間從 0 開始,長 2–4 秒。模板裡這三個檔案是通用佔位示例,照著改:
    • A 用 src/art/、src/ui/ 的 SVG 組件。
    • B 用 src/pixel/ 引擎,畫進 PixelStage。
    • C 新寫,參照 PlanC.tsx 的寫法:畫面只由 t 決定,一個鏡頭搭完。
  2. 執行:
    node tools/preview.mjs --out ../previews --estimate A:2.4 B:2.5 C:3.9
    
    • 默認每個方案出一張關鍵幀,冒號後面是取幀的秒數。
    • 賣點在運動本身的方案,寫成 B:clip,出 3 秒小樣。
    • 腳本會打印每幀耗時和整片渲染時間的估算,這個數填進方案裡。
  3. 自己先看一遍預覽圖:文字有沒有溢出、元素是否擠在一起、畫面是否太空、三個風格是否真的拉開了。修好再交給用戶。
  4. 把三個方案的文字和預覽圖一起交給用戶(把預覽圖嵌進回覆;各助手的做法不同)。用戶可以選一個、要求混合或修改;有改動就回到第 2 或第 3 步,直到用戶確認。

第 4 步:寫 brief.md

用戶確認後,按 references/brief-template.md 寫成 <主題>/brief.md。它分七塊:<role> <inputs> <direction> <structure> <build> <gotchas> <start>。已經確認的內容全部寫實,用了默認值的地方寫明是默認值。寫完告訴用戶檔案位置。

之後的製作嚴格按 brief 來。中途要改,先改 brief,再改代碼。用戶以後換主題、或拿到別的工具裡跑,也可以直接用這份 brief。

第 5 步:逐個鏡頭製作

  1. 先寫 src/scenes.json:

    • style 寫 "flash" 或 "pixel",Root 會按它選用哪套畫面。
    • 場景表用拍號寫,切場放在段落邊界上。
  2. 每個鏡頭要寫這些:

    • FLASH 風:在 src/scenes/*.tsx 寫組件,再到 src/scenes/index.ts 註冊。
    • 像素風:在 src/pixel/scenes.ts 的 PIXEL_SCENES 裡寫繪製函數 (c, f) => void。
    • C 風格:按第 3 步的預覽代碼擴寫,接到 Film.tsx,或者仿照 PixelFilm.tsx 另寫一個整片組件。
    • 所有文字寫進 src/captions.json,所有音效寫進 src/sfx.json,都用同一套拍號。
  3. 每做完一個鏡頭,依次執行:

    • npm run typecheck
    • npm run check(字幕檢查,必須 0 個問題)
    • node tools/stills.mjs --out ../qa <進場秒> <主動作秒> <出場秒>

    然後逐張看圖,查遮擋、出畫、文字壓臉、文字重疊。修好了再做下一個鏡頭。

  4. 片長 30 秒以上時,所有鏡頭搭完後先出一版低清小樣:node tools/render.mjs --scale 0.5 --out out/draft.mp4。確認節奏和轉場沒問題,再精修細節。

  5. 風格規則看 references/style-flash.md 和 references/style-pixel.md,通用規則看 references/craft.md。

第 6 步:聲音

規則見 references/audio.md:

  • 音效和畫面動作寫在同一個拍號上。
  • 像素風用 chip_* 晶片音色。
  • 打字機效果用 rep 欄位讓音效連發。
  • 默認電平就是定稿值。
  • 用戶說太響、太小或刺耳時,用 --music-db 和 --sfx-db 出幾檔對比檔案讓用戶選。只換音軌,不重渲畫面。

第 7 步:渲染和驗收

  1. 渲染:npm run sfx,再 npm run render。耗時看第 3 步的估算;3200 幀的片子,FLASH 風實測約 1.8 分鐘,像素風約 6 分鐘。
  2. 用 ffprobe 核對解析度、幀率、幀數和時長,用 ebur128 量響度。
  3. 出抽幀圖:python tools/qa_sheet.py out/film.mp4 ../qa/final(Windows 也可用 tools/qa_sheet.ps1)。會出兩張:完整聯繫表,和每格 360 寬的手機尺寸版。
  4. 按 references/craft.md 的自檢表打分,7 項每項都要 8 分以上:
    • 列出最嚴重的 3 個問題和時間點。
    • 只重渲有問題的那一段(node tools/render.mjs --frames 起-止),再合成整片。
    • 每一輪的分數和問題記進 qa/review_log.md。
  5. 把成片複製到 <主題>/<片名>.mp4。

豎屏短視頻要點(style = vflash)

  • 整片組件在 src/vfilm/:VFilm、VOverlay、通用卡片和標籤、極簡封面。場景在 vfilm/scenes.tsx 的 VSCENE_MAP 註冊。
  • 字幕安全區 x 40–1040、y 240–1640;文字停留默認 ≥ 3.5 秒,短字卡 ≥ 3 秒。
  • 不要把出處疊在畫面上,出處只寫 source/sources.md。畫面最多標「示意」。
  • 結尾建議:帶編號的複習/投票 + 關注引導。文案規則見 references/publish-copy.md(標題 ≤ 30 字,簡介 ≤ 100 字含話題)。
  • 成片響度 -16 LUFS、真峰值 ≤ -2 dBTP:python tools/loudnorm.py out/film.mp4。背景音樂要清楚聽得見。
  • 切點卡在小節第一拍:python tools/sync_check.py。變速曲由 beat_grid.py 寫入 grid.json 的 segments。
  • 豎屏封面:npm run vcover34 / vcover43。

第 8 步:封面

兩種風格各有 3:4 和 4:3 兩張;豎屏還有一套極簡封面:

  • FLASH 風(橫屏構圖):npm run cover34、npm run cover43
  • 像素風:npm run pixelcover34、npm run pixelcover43
  • 豎屏極簡:npm run vcover34、npm run vcover43

都是 2 倍解析度導出。版式規則見對應風格的文件和 references/publish-copy.md。短視頻封面請避開左下角(播放量區域),不要用底部色帶堆列表。

交付

告訴用戶:

  • 成片路徑、brief.md 路徑、工程目錄。
  • 這次的關鍵創作決定。
  • 已知的不足。
  • 渲染用時。
  • 不確定、需要用戶核對的事實,單獨列出來。

改風格、加新風格

  • 只改這一支:只改這支片子 video/ 裡的檔案,不動 Skill 模板。各部分在哪個檔案裡,見 references/craft.md 的「風格分佈在哪些檔案」。先出 4–6 張代表性靜幀給用戶確認風格,再做整片。
  • 以後都用 C 的風格:
    1. 把它的代碼收進 assets/template/src/<風格名>/。
    2. 寫 references/style-<風格名>.md。
    3. 在 plans.md 的候選表裡標為「已收錄」。
    4. 在本文件的方案表裡加一行。
  • 做不到的風格:這套流程只用代碼畫向量和像素圖,實拍、寫實 3D、寫實人物都做不了,要提前告訴用戶。需要寫實人物時,可以讓用戶先用視頻模型生成純綠幕的人物片段,代碼只負責場景和文字。

參考檔案(需要時再讀)

檔案內容
references/plans.md三個方案的格式、C 方案候選表、預覽規則、交給用戶時的寫法
references/brief-template.mdbrief.md 七塊模板
references/style-flash.mdFLASH 動畫風:風格規範、組件、封面
references/style-pixel.md像素卡帶風:畫面要點、調色板、兩層解析度、點陣字、精靈、CRT、封面
references/craft.md分鏡規則、字幕規則、逐鏡頭自檢、整片自檢打分、驗收清單、風格分佈在哪些檔案
references/remotion-kit.md模板結構、拍號系統、各組件 API、常用命令
references/audio.md節拍、音色表(含晶片音色)、混音電平定稿值、調音流程
references/research.md查資料與核對的方法
references/pitfalls.md踩過的坑(開工前必讀)
references/credits.md借鑑來源和字體授權
references/publish-copy.md豎屏發布文案、投票結尾、安全區、響度
scripts/new_project.py、new_project.ps1、check_env.py、beat_grid.py、music_rms.py、qa_sheet.py建工程、查環境、測節拍、測電平、抽幀
assets/template/Remotion 工程模板(含兩種風格的全部通用組件和佔位示例)
assets/fonts/Fusion Pixel 12px 點陣字體(OFL)
examples/bait-color/完整多鏡頭示例(可選對照,不是默認模板)

相關技能