animonkey 是做什麼的？
由 Dustkey LLC 出品
一套工作室級產品動態圖像製作方法，成果媲美頂尖新創公司：故事配合音樂、標題自成一格、轉場以變形取代剪接、角色演繹產品解決的問題、真實 UI 置於畫面核心。內附 Remotion 模板（template/）、音樂、配音、混音、品質控制與交付腳本（scripts/），以及記載各項數值的參考文件（references/）。
**工藝可重複，視覺不重複。**每部影片都有其專屬的視覺路線——色板、字體、角色質感、光線、運鏡、動態個性、音樂——皆根據客戶品牌定義。此技能提供的是製作出此等品質影片的參數，而非複製同一種外觀。絕不抄襲其他影片的路線、音樂、文案或腳本。
開始之前
- 閱讀
references/template.md（模板建構方式與其 API），並在撰寫 Remotion 程式碼前，查閱已安裝版本的官方文件（@remotion/media、@remotion/three和ConfigAPI 在不同版本間會變動）。 - 工具：node ≥ 20、ffmpeg/ffprobe、
uv(Python 3.12) 用於腳本；配音則需要含mlx-audio、faster-whisper、mlx-whisper、speechbrain和librosa的環境（Apple Silicon）。 - 磁碟空間：需要 ≥ 5 GB 可用空間來渲染（
df -h /）。未經詢問，絕不刪除使用者檔案以釋放空間。 - 新專案從複製開始：
cp -R <skill>/template <project>/video && cd <project>/video && npm install。
工作流程
每個步驟都必須產出看得見的成果。閘門（G0–G3）必須以畫格、連絡表或影片來核准，絕不接受僅用文字描述。
0 · 簡報
一次收集（並詢問缺少的資訊）：產品「現在」能做什麼、以及「現在」不能做什麼；目標客群是誰；影片用途（Landing page、App Store、廣告、活動）；長度；格式（16:9、9:16、4:5）；語言；是否需要配音、以及何種模式；音樂（需有商業授權）；品牌資訊（Logo、顏色、字體、語氣）；真實 UI（截圖、來自程式碼的設計 token、圖示）以及客戶喜歡的參考作品。將產品的事實寫入計畫書：影片中不可承諾產品未提供的功能。
1 · 視覺路線 → G0
使用 references/art-direction.md 定義路線的十個軸向，並與已使用路線的登記表（used-lines.md，私人文件；若不存在，則從 used-lines.example.md 建立）比對。將其寫入 kit/palette.ts、style.ts、brand.ts（若字體更換，也需更新 + scripts/font-metrics.py）和 project/cast.ts。使用 scripts/still.sh 渲染三張路線畫格（角色呈現問題、UI、結尾）並取得核准。
2 · 故事與標題
參考 references/storytelling.md：填入各個敘事槽位（價值誕生之處、角色陣容、每個角色投放的原料、失落、轉折、遊走的品牌元素、一鍵行動、三元組、證明、異議、標語）。將幕次鋪在歌曲的形狀上，並依據 references/kinetic-typography.md 將標題以規格形式寫入 project/titles.ts。關閉聲音，連續朗讀這些標題：它們必須能完整講述整部影片。執行 npm run check，直到它在兩種語言下都通過檢查。
3 · 音樂與網格
參考 references/audio-and-voice.md：為路線選擇曲目，進行映射（scripts/mapear-musica.py），必要時依小節剪輯（scripts/cortar-por-compases.py），並將 bpm 和 v0 填入 project/timeline.ts 的 makeGrid 中。從此刻起，每個事件都使用 bar()/beat() 來撰寫。
4 · 動畫草稿 → G1
真實標題動畫、物件以剪影在定位、地面計劃，配合音樂（以及草稿配音）。核准的是「時機」。此處核准的內容就是最終交付的內容。
5 · 區塊生產 → G2
從風險最高到最低（首先處理手上的證明、以及種植與回報的區塊），每個區塊位於 project/blocks/ 和 registry.tsx：
- 角色、姿勢、光線和 3D 攝影機：參閱
references/characters-3d.md； - 以 DOM 呈現產品 UI，與 3D 場景結合、點擊動作、可讀的推近鏡頭：參閱
references/product-ui.md； - 曲線、攝影機配方、變形轉場、物理地面與交接：參閱
references/motion-and-grounds.md。 每個區塊使用連絡表和 100% 裁切畫面進行審查（參閱references/production-and-qa.md）。
6 · 整合、檢查與主片 → G3
執行 npm run check、渲染（scripts/render.sh）、對 MP4 執行 scripts/film-qa.py 和 scripts/hoja-contacto.py；配音（scripts/voz/）與混音（scripts/mezclar.py）需經過測量。以不認識該產品的人的角度觀看無聲主片。
7 · 變體與交付
多語言、透過視窗製作的垂直版本、多種開頭的 6–15 秒廣告剪輯、無聲主片：參閱 references/marketing-and-formats.md。使用 scripts/entregar.py 交付（檔名永不覆寫、含封面、連絡表、清單）。
8 · 登記
將影片的路線加入 used-lines.md，並將其簽章加入下一個專案的 USED_LINES。以客戶自己的話記錄其決定：這些是下一部影片的品味基準（references/taste.md）。
不可妥協的規則
- **音樂主導一切。**所有元素都必須對齊網格；事件誤差在 ±2 畫格以內；移動配音，絕不移動網格。
- 一個標題 = 一行 2–5 個詞，置中，使用真實字體（非 DOM）測量，只有一個重音；若無法容納，則縮短文句，而非字體大小。
- 不透過透明度顯現或交叉淡出變更：攝影機、物件或變形轉場承載所有變化。
- 問題由角色演繹；他們在問題中投放的東西，在產品結果中會再次出現。
- UI 是真實產品的，以 DOM 重新繪製，並在閱讀時清晰可辨（≥ 3.4 px/pt）。
- 品牌元素在故事中穿梭，最終回到 Logo；結尾畫面靜止，並帶有網域名稱。
- 垂直格式無需重做：透過視窗觀看同一部影片；文字保持原樣；在無法容納處加寬視窗。
- 每個專案都有其獨特路線；工作室的兩部影片看起來不會相同（在
art-direction.md中有反相似性檢查）。 - 檢查必須可能失敗，綠色的渲染結果證明不了什麼：務必檢視連絡表和 100% 畫格。
- 畫面上不可出現真實客戶資料或虛構的功能。
何時閱讀什麼
| 你需要… | 閱讀 |
|---|---|
| 開始、理解模板、指令 | references/template.md |
| 定義專案外觀（色板、字體、質感、光線、音樂） | references/art-direction.md |
| 結構、幕次、角色演繹流程、文案與配音 | references/storytelling.md |
| 標題規格、進出場、測量、其他字體或語言 | references/kinetic-typography.md |
| 曲線、攝影機、轉場、地面、節奏、動態指標 | references/motion-and-grounds.md |
| 設計角色陣容、姿勢、IK、3D 場面調度、手部、陰影 | references/characters-3d.md |
| 重現產品 UI 並使其動畫化、與 3D 場景結合 | references/product-ui.md |
| 選擇與剪輯音樂、AI 配音、混音 | references/audio-and-voice.md |
| 廣告剪輯、垂直格式、語言、交付物 | references/marketing-and-formats.md |
| 閘門、可測量規則、渲染、工具、操作 | references/production-and-qa.md |
| 在兩個都可行的選項之間做決定 | references/taste.md |
腳本
| 腳本 | 用途 |
|---|---|
template/scripts/check.sh | 不渲染就進行檢查（標題、同步、地面、對比、剪輯、重複路線）支援兩種語言 |
template/scripts/still.sh | 渲染單張畫格，用於審查和閘門 |
template/scripts/render.sh | 主片與變體：無聲分段渲染（含磁碟空間檢查），並以 ffmpeg 混合音訊 |
template/scripts/proyecto-json.sh | 以 JSON 格式輸出時間軸，供 Python 腳本使用 |
template/scripts/font-metrics.py | 另一種字體（靜態或可變）的度量表 |
scripts/mapear-musica.py | 分析曲目的速度、第一強拍、網格與段落 |
scripts/cortar-por-compases.py | 依網格段落剪輯音樂，無爆音 |
scripts/mezclar.py | 音樂 + 配音混音（含側鏈壓縮、低頻保護與測量報告） |
scripts/voz/ | 從標題 → 設計 → 複製 → 挑選 → 放置的配音流程 |
scripts/film-qa.py | 在 MP4 上檢查剪輯、動態、地面與色彩 |
scripts/hoja-contacto.py | 以 PDF 或 PNG 格式產出連絡表 |
scripts/comparar-videos.py | 比較兩個渲染結果，可設定容差 |
scripts/entregar.py | 交付（含封面、連絡表與清單），絕不覆寫檔案 |
私人案例
如果存在 private-cases/ 資料夾（它永不公開），裡面存放著真實工作室製作的完整分析：閱讀它以理解方法為何如此設計，但絕不複製其路線、音樂、文案或故事。