代碼動畫科普視頻
所有畫面都用 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。這個腳本依次做這些事:
- 檢查環境(
scripts/check_env.py)。缺什麼會打印出來;裝之前先徵得用戶同意。 - 建工作目錄。
- 複製模板。
- 拷字體。
- 執行 npm install。
- 測節拍,寫入
src/grid.json。 - 出第一版混音。
整個過程要 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 寫,三個方案的分工是固定的:
| 方案 | 風格 | 技術 | 講法 |
|---|---|---|---|
| A | FLASH 動畫風(扁平插畫) | Remotion + SVG 扁平插畫組件 | 穩妥:設問 → 實驗/數據 → 結論 → 記住三件事 |
| B | 像素卡帶風(復古遊戲機 + CRT 老電視) | Canvas 2D 像素畫布 → WebGL CRT 著色器 | 遊戲化:選卡帶就是選關卡,HUD 顯示數據,對話框講結論,結算畫面給結果 |
| C | 屆時建議:從 plans.md 的候選表裡挑最貼題材的,或自己提一個能用 Remotion 做出來的 | 和 A、B 都不同 | 換一種講法:一鏡到底、貫穿全片的主角、倒敘、一個比喻講完 |
每個方案都要寫清楚:名字、一句話概括、風格(配色色值和字體)、規格、技術組合、逐鏡頭畫面概括(帶時間段)、聲音、預計渲染時間、難點和風險,以及為什麼適合這份原材料。
三個方案要在風格、技術和講法上都明顯不同,不能只是換個配色。
第 3 步:每個方案出預覽
- 在
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 決定,一個鏡頭搭完。
- A 用
- 執行:
node tools/preview.mjs --out ../previews --estimate A:2.4 B:2.5 C:3.9- 默認每個方案出一張關鍵幀,冒號後面是取幀的秒數。
- 賣點在運動本身的方案,寫成
B:clip,出 3 秒小樣。 - 腳本會打印每幀耗時和整片渲染時間的估算,這個數填進方案裡。
- 自己先看一遍預覽圖:文字有沒有溢出、元素是否擠在一起、畫面是否太空、三個風格是否真的拉開了。修好再交給用戶。
- 把三個方案的文字和預覽圖一起交給用戶(把預覽圖嵌進回覆;各助手的做法不同)。用戶可以選一個、要求混合或修改;有改動就回到第 2 或第 3 步,直到用戶確認。
第 4 步:寫 brief.md
用戶確認後,按 references/brief-template.md 寫成 <主題>/brief.md。它分七塊:<role> <inputs> <direction> <structure> <build> <gotchas> <start>。已經確認的內容全部寫實,用了默認值的地方寫明是默認值。寫完告訴用戶檔案位置。
之後的製作嚴格按 brief 來。中途要改,先改 brief,再改代碼。用戶以後換主題、或拿到別的工具裡跑,也可以直接用這份 brief。
第 5 步:逐個鏡頭製作
-
先寫
src/scenes.json:style寫"flash"或"pixel",Root 會按它選用哪套畫面。- 場景表用拍號寫,切場放在段落邊界上。
-
每個鏡頭要寫這些:
- 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,都用同一套拍號。
- FLASH 風:在
-
每做完一個鏡頭,依次執行:
npm run typechecknpm run check(字幕檢查,必須 0 個問題)node tools/stills.mjs --out ../qa <進場秒> <主動作秒> <出場秒>
然後逐張看圖,查遮擋、出畫、文字壓臉、文字重疊。修好了再做下一個鏡頭。
-
片長 30 秒以上時,所有鏡頭搭完後先出一版低清小樣:
node tools/render.mjs --scale 0.5 --out out/draft.mp4。確認節奏和轉場沒問題,再精修細節。 -
風格規則看
references/style-flash.md和references/style-pixel.md,通用規則看references/craft.md。
第 6 步:聲音
規則見 references/audio.md:
- 音效和畫面動作寫在同一個拍號上。
- 像素風用
chip_*晶片音色。 - 打字機效果用
rep欄位讓音效連發。 - 默認電平就是定稿值。
- 用戶說太響、太小或刺耳時,用
--music-db和--sfx-db出幾檔對比檔案讓用戶選。只換音軌,不重渲畫面。
第 7 步:渲染和驗收
- 渲染:
npm run sfx,再npm run render。耗時看第 3 步的估算;3200 幀的片子,FLASH 風實測約 1.8 分鐘,像素風約 6 分鐘。 - 用
ffprobe核對解析度、幀率、幀數和時長,用ebur128量響度。 - 出抽幀圖:
python tools/qa_sheet.py out/film.mp4 ../qa/final(Windows 也可用tools/qa_sheet.ps1)。會出兩張:完整聯繫表,和每格 360 寬的手機尺寸版。 - 按
references/craft.md的自檢表打分,7 項每項都要 8 分以上:- 列出最嚴重的 3 個問題和時間點。
- 只重渲有問題的那一段(
node tools/render.mjs --frames 起-止),再合成整片。 - 每一輪的分數和問題記進
qa/review_log.md。
- 把成片複製到
<主題>/<片名>.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 的風格:
- 把它的代碼收進
assets/template/src/<風格名>/。 - 寫
references/style-<風格名>.md。 - 在
plans.md的候選表裡標為「已收錄」。 - 在本文件的方案表裡加一行。
- 把它的代碼收進
- 做不到的風格:這套流程只用代碼畫向量和像素圖,實拍、寫實 3D、寫實人物都做不了,要提前告訴用戶。需要寫實人物時,可以讓用戶先用視頻模型生成純綠幕的人物片段,代碼只負責場景和文字。
參考檔案(需要時再讀)
| 檔案 | 內容 |
|---|---|
references/plans.md | 三個方案的格式、C 方案候選表、預覽規則、交給用戶時的寫法 |
references/brief-template.md | brief.md 七塊模板 |
references/style-flash.md | FLASH 動畫風:風格規範、組件、封面 |
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/ | 完整多鏡頭示例(可選對照,不是默認模板) |