Communitygithub.com

ohad6k/emulo

將一句話簡報轉化為一部影片。它會產出 Claude Design 所需的提示、組成檔案,以及一份可供預覽的連絡表,涵蓋參考角色、工具包、分鏡閘門、動態底板及驗證指令。不適用於後端工作、UI 設計或純行銷文案。

emulo 是什麼?

Emulo 是一項專門為 AI 代理(如 Claude Code、Claude Design)設計的技能,能將簡短的創意簡報轉化為結構完整的影片製作流程。它生成的不僅僅是一個提示,而是一個完整的資料夾,其中包含動畫引擎專用的 PROMPT.md、組合檔案、資產檔案,以及預覽用的幀數圖,讓用戶在上傳到 Claude Design 進行渲染之前就能視覺化結果。此技能支援 animations-v3.jsx 引擎,並強調嚴格的資產準備(切割元件而非截圖)、參考素材的明確指派(禁止平均化),以及分階段建立(在繼續之前先渲染並審視前幾秒)。它還包含建立工具包 (KIT.md) 的詳細工作流程,測量參考素材、重建實際 UI 元件,以及記錄已知缺陷,以避免在後續階段出現意外。主要目的是將「想法」轉化為「設計就緒的交付物」,最大限度地減少 Claude Design 中的來回溝通和失配資產問題。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ohad6k/emulo/tree/HEAD/skills/video

在你喜歡的 AI 中提問

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

說明文件

Emulo 影片

你接受一份簡報,然後交出一部影片。不是一個提示,而是一部影片:建構它的提示、組合檔案,以及可供他人檢視的幀數圖。

0. 在寫任何文字之前,先載入設定檔

  1. 找出此技能目錄上兩層的 emulo.py;若為直接儲存庫檢出,則回退到 ./emulo.py。
  2. 將解析出的絕對路徑儲存為 EMULO_PY,然後執行 python "$EMULO_PY" plugin profile-path --domain video。
  3. 如果執行結果非零,請提供其確切的復原指示,並停止載入個人上下文。切勿以通用創意角色替代。
  4. 完整讀取每個回傳的路徑。第一個是核心工作設定檔,第二個是影片設定檔。兩者皆優先於下列任何項目:當使用者自訂規則與此技能中的預設值衝突時,以使用者的規則為準。
  5. 如果專案有自己的影片文件或路由器,請先閱讀它們,並遵循它們涵蓋的任何事項。

1. 你的交付物

一個使用者可以上傳到 Claude Design 並獲得一部影片的資料夾。 這就是交付物。不是聊天訊息中的一個提示,不是一部影片的描述,不是一連串的想法。就是一個資料夾。

在專案中建立它,以品牌或影片名稱命名資料夾,結構如下:

#成品存在原因
1PROMPT.md簡報。一頁,使用引擎的語言
2START-HERE.md上傳順序。 哪些檔案、以何種順序、在同一個訊息中。沒有它,使用者會猜測,而猜測往往是錯的
3ATTACH/影片所需的所有資產,包含 animations-v3.jsx 本身
4frames/參考靜態圖片,其檔案名稱承載著指示
5KIT.md清單:每個檔案、其像素尺寸、已知缺陷

可選,且僅在上述五項完成之後:build/piece.jsx 加上 build/frames/,即在本地建置並渲染的影片,讓你可以搶先觀看。這是驗證,不是交付物。缺少本地建置的工具包仍然可以交付。缺少工具包的本地建置則不行。

決定資料夾是否有效的三件事

將引擎放在 ATTACH/ 中。 animations-v3.jsx 必須與資產一起放入資料夾。Claude Design 需要它被要求編寫的運行時環境。省略它是導致好的提示卻產出壞影片的常見原因。

獨立的元件,絕不要整張螢幕截圖。 每個檔案一個物件、透明、長邊至少 1600px,再加上符合影片長寬比的大底板用於地面。整張螢幕丟進去就是個石板,會被視為破損。以這種方式建構的影片,因缺少資產而失敗的頻率遠高於因提示長度不足而失敗。

將指示放在檔案名稱中。 REF_03_object-becomes-the-mark.png 能教導;ref3.png 則不能。上傳者會保留檔案名稱,所以每個檔案都攜帶著自己的教訓進入上下文。

指出缺少的內容。切勿虛構替代品。

如果某項資產不存在,請在 PROMPT.md 中以自己的標題說明,並說明應該如何處理。一份承認缺少兩項資產的簡報是可用的。一份悄悄偽造它們的簡報,會產出一部有兩個無法解釋的破損節拍的影片。

每個提示必須按此順序並指名道姓地包含

  1. 以引擎語言撰寫的簡報:OM_SCENES、CUES、具名的 Easing
  2. 作為匹配錨點的轉換鏈:什麼變成什麼
  3. 資產清單,使用真實檔案名稱,這樣就不會因為缺少元件而卡住節拍
  4. 此特定影片的失敗條件,而非通用條件
  5. 驗證指令,以便「它能運作」的宣稱背後有實際輸出

2. 引擎

animations-v3.jsx 是 Claude Design 的組合運行時環境。讀取其標題一次,然後從此表格開始工作。

永遠不要編輯 animations-v3.jsx。 其本身的標題說明重新執行 copy_starter_component 會覆寫它,因此在那裡所做的每次更改都會在下一次主機複製時丟失。槓桿作用在於簡報。

使用絕不使用
Easing.easeOutExpo 與具名曲線cubic-bezier(...)、任何 CSS 字串
帶有 dur 的具名區段 OM_SCENES絕對幀數作為結構
CUES.SectionName 作為編排關鍵掛鐘時間、setTimeout、requestAnimationFrame
animate({from, to, start, end, ease})(T)繪製任何可見元素的 useEffect
interpolate([...], [...], ease)(T)自行運行的 CSS keyframes
用於硬切的 <Shot from to>按區段條件式掛載
一個 <CompositionStage> 作為唯一可匯出的根節點任何其他位置的 exportable 屬性

用一句話總結模型:動畫是一個元素樹,作為單一編寫時間軸的純函數進行渲染,因此在區段邊界沒有任何東西被掛載或卸載,任何物件都可以透過普通的插值在整個影片中持續存在、移動或變形。這使得零切換和一個物件在影片中轉換成為引擎的預設行為,而不是簡報需要費力爭取的事情。

<CompositionStage width={1080} height={1920} bg="#161309"
                  scenes={window.OM_SCENES} playback={window.OM_PLAYBACK}>
  <Piece />          // 一個元件,整部影片
</CompositionStage>
useComposition() -> { T, CUES, time, duration, authoredTotal, playing }

OM_SCENES 和 OM_PLAYBACK 是主文件中普通內聯 <script> 標籤中的 JSON 字串字面量(非 type="text/babel"),原封不動地傳遞。每個條目都需要一個 desc,一句平實的描述,因為使用者會在時間軸彈出視窗中閱讀它。永遠不要手動設定 nat。

<script>window.OM_SCENES = '[{"name":"Strike","dur":2.5,"desc":"The mark lands and throws colour across the ground"}]';</script>
<script>window.OM_PLAYBACK = '{"mode":"loop"}';</script>

Easing,完整列表。 linear;easeIn/easeOut/easeInOut 用於 Quad、Cubic、Quart、Expo、Sine;easeInBack、easeOutBack、easeInOutBack;easeOutElastic。Back 和 elastic 會產生 overshoot,因此它們絕不該出現在標誌或官方品牌檔案附近。

僅從 T 渲染。 匯出器會以同步提交尋找每個幀,並可能在尋找返回的瞬間序列化舞台,因此從 effect 或私有動畫循環繪製的任何東西匯出時都會是過時的。

僅在被要求時才加字幕。 僅在簡報或使用者的影片設定檔要求燒錄字幕時才渲染 <Captions>。許多人會之後自行添加,燒錄的字幕會破壞這一點。鎖定在畫面中的文案是一個普通元素,放置在組合需要它的位置。

將 bg 設定為影片的地面色,永遠不要使用預設的 #0b0b0e,也永遠不要使用 #000000。一個經過設計的世界需要一個光線可以衰減的地方。

在前端定義恰好三個或四個 motion helper,並且只使用它們之外的 easing 或 transform:

MOTION.slam    Easing.easeOutExpo     到達和撞擊
MOTION.snap    Easing.easeOutBack     晶片落地,overshoot 限制在 6%
MOTION.drive   Easing.easeInOutQuart  移動、光、漂移
MOTION.settle  Easing.easeOutQuart    最終解析

3. 指派參考。切勿將其平均化。

每個參考都獲得一項工作和一個明確的禁止複製清單。如果沒有「不要將參考平均化」這行字,模型會將風格混合成一團糊狀。

參考它的唯一工作絕不採用
使用者為動態指定的影片轉換、深度、比例對比其調色盤、其品牌
使用者為攝影機指定的影片攝影機與 easing:事件、停頓、安定其顏色、其產品
品牌自身的素材識別、字體排印、確切的標誌以它的介面版面配置作為模板

以這種形式寫入提示:

將 X 用作以下方面的主要權威:節奏、克制、匹配錨點、比例對比、攝影機推拉、深度、最終停頓。
僅將 Y 用於:單色識別、字體排印、確切標誌、清晰度。

不要複製 X 的設計。不要引入 X 的顏色。不要將參考平均化。

如果使用者在同一個引擎上有幾部完成的影片,請至少閱讀三部,並問什麼是所有影片中相同的:場景清單如何宣告、轉換鏈在哪裡表達、一個進入鏡頭如何對其撞擊的物體進行計時、最後三秒如何建構。常數就是工作流程。僅在一部影片中出現的任何東西都是那部影片的外衣。

分階段建構,並在階段之間設閘。 先建構前五到八秒。渲染。查看連絡表。然後再繼續。在任何人觀看之前就建構完成的二十秒影片,是沒人能修復的二十秒影片,因為缺陷在於概念,而概念現在是承重結構。

4. 在撰寫提示之前先建立工具包

一個冗長詳細但沒有真實資產的提示,仍然會以代表文字的灰色矩形和取代真實標誌的手繪形狀返回,因為佔位符是在沒有任何真實東西可放置的情況下,模型唯一能繪製的東西。

Claude Code 建立工具包。Claude Design 為它做動畫。 這個分工就是整個流程。

  1. 以 1:1 測量參考,一個檔案,絕非連絡表。記下節拍、地面色、平均亮度、平均飽和度,以及實際佔據畫面的物體。
  2. 品牌攝取。 官方標誌通常存在於品牌自身的指南或新聞頁面上,混雜在他們「不要這樣做」的範例中。渲染一份亮色和暗色的連絡表,在命名任何東西之前先查看。
  3. 將產品 UI 重建為承載真實字串的即時 DOM,然後用無頭瀏覽器以 3x 到 5x 的倍率將其拍攝成平面底板。介面是重建的。世界藝術是渲染和合成的。沒有偽造。
  4. 切割元件,而非螢幕。 整張螢幕是一塊石板,石板無法被動畫化,只能滑動。交付一個 parts/ 資料夾,裡面是 1600px 或以上的獨立透明物件:每個按鈕、晶片、節點、條、圖塊、徽章、圖示。
  5. 將標誌拆分成自己的圖層。 一個官方的 SVG 可以分成能完美逐像素疊回的圖層。驗證它:與原始圖層疊加後,任何像素上的最大差異應約為 1 of 255,這是抗鋸齒。然後影片組裝標誌,而不是切換到它。
  6. 最佳化。 保持每個檔案小巧(數百 KB),整個工具包數 MB,以便它能被成功載入 Claude Design 專案。
  7. 打開每個檔案並在 KIT.md 中記錄其缺陷。 被裁切的按鈕、缺少 Alpha 通道、錯誤的長寬比、在白色卡片上消失的白色徽章。你在提示的 KNOWN KIT DEFECTS 部分中,將你發現的每個缺陷連同影片必須如何處理它一起寫入。如果你沒發現任何缺陷,請說明你打開了每個檔案且沒發現任何缺陷。

長寬比是一個真正的缺陷類別。將 1200x800 的晶片渲染到 224x160 的盒子中,會將每個晶片水平拉伸 7%,這在審查中足夠微妙,但在每個畫格中都是錯誤的。

已發布的成品可能執行在嚴格的 CSP 下,該策略會封鎖外部主機,因此工具包中的任何東西都不應指向 CDN。所有東西都應該是專案檔案或 data URI。

5. 先撰寫 OM_SCENES

它是大綱,區段名稱將成為提示其餘部分所用的提示詞詞彙。六個區段是一部好影片。十個區段是一場幻燈片秀。

每個 desc 是一句描述物理事件的話,而非一種情緒。「三角形變成一個光圈,鏡頭穿過它,然後拉回成全產品預覽」是一個 desc。「一種速度和可能性的感覺」則不是。

6. 轉換鏈,作為匹配錨點

命名承載影片的那一個物件,並禁止打破它。

每個場景從前一個場景繼承一個可見的物件、形狀、線條或運動向量。永遠不要:場景淡出、空白背景、下一個場景淡入。傳入的節拍在傳出的節拍仍有 25% 到 50% 的可見度時,就必須是可見的。

例如,一個品牌標誌的彩色圓圈,然後是一個課程節點,然後是所有名稱收斂到的東西,然後又是標誌。或者一個印在每個產品表面的曲目標題,因此同一首歌從條形音箱移動到桌面再到手機。

隨之而來的顏色規則。 一個即將成為官方圖層的物件,其顏色應校正為那個圖層的顏色,永遠不要校正為品牌發布的顏色。品牌檔案和品牌指南頁面通常會相差幾個數值,而校正為指南數值會在必須不可見的那個畫格上產生顏色跳躍。檔案勝過指南頁面。

7. 提示

填寫此部分。不要刪除任何結構性內容。一個冗長但不包含任何檔案名稱的簡報是錯誤的簡報。

你正在為 <BRAND> 執導一部基於 animations-v3 組合引擎的 <N> 秒 <vertical|landscape> 概念商業廣告。電影感。物件少、體積大、有打光。

格式。逐字撰寫。

  <CompositionStage width={<W>} height={<H>} bg="<ground hex>"
                    scenes={window.OM_SCENES} playback={window.OM_PLAYBACK}>

<W> 寬 x <H> 高。如果你的組合是 <wider than it is tall | not <W>x<H>>,那麼在評估任何其他事項之前,你已經失敗了。

唯一法則

螢幕上的每個物件都是下方清單中的一個檔案。時間軸永遠不會繪製 <BRAND> 的螢幕,永遠不會繪製標誌,永遠不會用灰色矩形取代文字,永遠不會用漸層近似圖像。它只會放置、遮罩、裁切、打光和移動這些檔案。

如果一個節拍需要一個工具包中不包含的物件,請說出來並停止。不要用 div 替代。如果你無法解析路徑,請在建立任何東西之前告訴我,而不是繪製替代品。

參考

<每個參考一項工作,附帶禁止複製清單。然後:不要將它們平均化。>

資產

  <每個檔案、其像素尺寸,以及一行說明其用途。說明有哪些元素層級元件存在,以及它們各自的作用。>

界線,以及它排除了什麼

<類別排除事項,而非工藝筆記。類別排除事項是模型已經理解的東西:六張不相關的投影片、SaaS 產品導覽、儀表板蒙太奇、會議簡報、開發者教學、瀏覽器螢幕錄製、一面科技標誌牆、通用的未來感 AI 廣告...>

...

[為翻譯而截斷]

相關技能