Communitygithub.com

ohad6k/emulo

用于将一句话需求转化为动画电影。将一句简短的任务描述转化为 Claude Design 提示词(使用 animations-v3 引擎语言),同时生成内置的 piece.jsx 文件和联系人表,供渲染前预览。涵盖参考角色、工具包、故事板关卡、动态地板和验证指令。不适用于后端工作、UI 设计或单独营销文案。

emulo 是什么?

Emulo 是一个专门用于将简单创意需求转化为完整动画电影的专业 AI 技能。它不生成描述,而是输出一个可直接上传到 Claude Design 并渲染成影片的工具包文件夹。技能定义了严格的五步流程:加载个人资料、构建文件夹(包括 PROMPT.md、资产、帧)、使用 animations-v3 引擎、分配参考角色并按番位顺序构建影片。它强调使用真实资产而非占位符,将指令嵌入文件名,以及按阶段构建并验收。支持 Claude API、Claude Code 和 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 关键帧
用于硬切的 <Shot from to>按章节条件挂载
一个 <CompositionStage> 作为唯一可导出的根其他任何地方的导出属性

一句话模型:动画是一个元素树,作为一个纯粹的受一维时间轴影响的函数进行渲染,因此没有任何东西在章节边界挂载或卸载,任何对象都可以通过普通插值在整个电影中持久存在、移动或变形。这使得零剪切和一个对象跨电影转变为引擎的默认设置,而不是一个提示词必须为之奋斗的东西。

<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":"标记落下并将颜色抛洒到地面上"}]';</script>
<script>window.OM_PLAYBACK = '{"mode":"loop"}';</script>

缓动,完整列表。 linear;easeIn/easeOut/easeInOut 对应 Quad、Cubic、Quart、Expo、Sine;easeInBack、easeOutBack、easeInOutBack;easeOutElastic。Back 和 elastic 会过冲,因此它们绝不应该出现在徽标或正式品牌文件附近。

仅从 T 渲染。 导出器使用同步提交来定位每一帧,并可能在定位返回的瞬间序列化舞台,因此从效果或私有动画循环绘制的内容会导出过时的。

仅在要求时添加字幕。 只有当需求或用户的视频配置文件要求烧录字幕时,才渲染 <Captions>。许多人稍后自行添加,烧录的字幕会破坏这一点。锁定在屏幕上的副本是一个普通元素,放置在合成期望的位置。

将 bg 设置为电影的底色,绝不是默认的 #0b0b0e,也绝不是 #000000。一个设计好的世界需要某个地方让光线淡出。

预先定义正好三个或四个运动辅助函数,并在它们之外不使用任何缓动或变换:

MOTION.slam    Easing.easeOutExpo     到达与冲击
MOTION.snap    Easing.easeOutBack     芯片着落,过冲上限为 6%
MOTION.drive   Easing.easeInOutQuart  移动、光线、漂移
MOTION.settle  Easing.easeOutQuart    最终解决

3. 分配参考角色。绝不平均它们。

每个参考获得一个角色和一个明确的禁止复制列表。没有“不要平均参考”这一行,模型会将风格混合成烂泥。

参考它的一个角色绝不采用
用户命名的运动类电影变换、深度、尺度对比其色调、其品牌
用户命名的镜头类电影镜头与缓动:事件、保持、稳定其颜色、其产品
品牌自身的素材身份、字体、精确的标记将其界面布局作为模板

将其写入提示词中,形式如下:

将 X 用作以下方面的主要权威:节奏、克制、匹配锚点、尺度对比、镜头推拉、深度、最终保持。
仅将 Y 用于:单色身份、字体、精确徽标、清晰度。

不要复制 X 的设计。不要引入 X 的颜色。不要平均参考。

如果用户在同一引擎上有几部完成的电影,至少阅读三部,并询问它们中相同的是什么:场景列表如何声明、变换链在哪里表达、入口如何相对于它撞击的东西进行计时、最后三秒如何构建。常量是工作流。任何只存在于一部电影中的东西都是那部电影的服装。

按阶段构建,并在阶段之间设门控。 构建前五到八秒。渲染。查看联系人表。然后才能继续。在任何人查看之前构建的二十秒电影是一部二十秒无人能修复的电影,因为缺陷在于概念,而现在概念是承重的。

4. 在编写提示词之前构建工具包

一个冗长详细但没有真实资产的提示词仍然会返回灰色的矩形代替文本,以及手绘形状代替真实标记,因为占位符是模型在没有任何真实内容可放置时唯一能绘制的东西。

Claude Code 构建工具包。Claude Design 对其进行动画。 这种分工就是流程。

  1. 以 1:1 比例测量参考,一个文件,绝不是联系人表。记录节拍、底色、平均亮度、平均饱和度以及占据帧的实际内容。
  2. 品牌摄入。 官方标记通常位于品牌自身的指南或新闻页面上,夹杂在他们的“不要这样做”示例中。渲染亮色和暗色联系人表,在命名任何东西之前查看。
  3. 将产品 UI 重建为携带真实字符串的实时 DOM,然后使用无头浏览器以 3 倍到 5 倍放大率将其拍摄成扁平背景板。界面是重建的。世界艺术是渲染并合成的。没有什么是伪造的。
  4. 分割部件,而非屏幕。 整个屏幕是一块平板,平板无法动画,只能滑动。交付一个 parts/ 文件夹,包含 1600px 及以上的隔离透明对象:每个按钮、芯片、节点、条形、磁贴、徽章、图标。
  5. 将标记分离到其自身的图层中。 官方 SVG 会拆分为可以像素完美堆叠的图层。验证它:堆叠后与原始文件相比,任何像素上的最大差异大约为 255 中的 1,这是抗锯齿的结果。然后,电影组装该标记,而不是切换到它。
  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> 导演一个 <N> 秒的 <垂直|横向> 规格广告,构建在 animations-v3 合成引擎之上。电影感。少量对象,大型,有光照。

格式。请字面编写。

  <CompositionStage width={<W>} height={<H>} bg="<底色十六进制>"
                    scenes={window.OM_SCENES} playback={window.OM_PLAYBACK}>

<W> 宽乘 <H> 高。如果你的合成是 <宽大于高 | 不是 <W>x<H>>,那么你在任何其他事情被评判之前就已经失败了。

唯一法则

屏幕上的每个对象都是下面列表中的一个文件。时间轴从不绘制 <BRAND> 屏幕,从不绘制标记,从不使用灰色矩形来放置文本,从不使用渐变来近似图像。它放置、遮罩、裁剪、光照和移动那些文件。

如果一个节拍需要一个工具包中不包含的对象,请说明并停止。不要用 div 替代。如果你无法解析路径,在构建任何东西之前告诉我,而不是绘制替代品。

参考

<每个参考一个角色,附禁止复制列表。然后:不要平均它们。>

资产

  <每个文件,其像素尺寸,以及一行说明它的用途。说明哪些元素级别的部分存在,以及它们独自的意图。>

禁止事项及其排除范围

<类型排除,而非工艺说明。类型排除是模型已经理解的内容:六张不连续的幻灯片、SaaS 产品导览、仪表盘蒙太奇、会议演示、开发者教程、浏览器屏幕录制、技术徽标墙、通用未来主义 AI 广告。>

场景

  <每个场景,名称、持续时间、物理事件描述。>

转换

  <链。一个对象如何被继承。>

已知工具包缺陷

  <每个文件以及如何处理它。如果无,则说明已打开每个文件且无。>

验证

  <如何确认它有效。>

遵循上述所有内容。在构建之前询问明确的问题。绝不生成带默认 bg 的输出。不满足请停止。

8. Script(可选)

如果需求需要画外音时间线,请在提示词之前将 SCRIPT.md 放在工具包中。脚本是一个描述性的时间线,而不是对话。节拍是同步点:运动到达、相机推动、屏幕完成。

例如,标记与第一声打击同时到达。第二声打击在标记的纹理完成滚动后启动工具提示。相机在文本稳定后的第 3.5 秒处读到屏幕左侧。三行,三个与可见世界绑定的时间事件。

脚本文件指定硬停止。没有脚本的电影由引擎的宽松规则运行:一旦最后一章结束,循环开始,无结束状态。脚本说:最后一帧,相机在 2.4 秒的保持中稳定,第 250 帧是最后一帧,导出 30fps 的 8.33 秒。然后导出器将使用最后一帧的时间线构建只适用于它的背景板。没有脚本,即使所有内容都已构建,该时间线也是不完整的。

9. 验证命令

验证发生在 Claude Code 中,而不是 Claude Design 中。只依赖于文件系统中包含的内容。永远不要要求模型在浏览器中播放。

# 资产完整性
find ATTACH/ -type f | sort
wc -l PROMPT.md

# 像素完整性(验证每个结构资产)
identify -verbose ATTACH/button_.png | grep -E "Geometry|Type|Alpha"

# 合成结构检查
python -c "
import json
with open('PROMPT.md') as f: s = f.read()
# 从脚本标签中提取 OM_SCENES 并验证
start = s.index('OM_SCENES')
open = s.index('[')
close = s.index(']', open)
scenes = json.loads(s[open:close+1])
assert len(scenes) >= 3, '需要至少 3 个场景'
for sc in scenes:
    assert 'name' in sc, '每个场景需要名称'
    assert 'dur' in sc, '每个场景需要持续时间'
    assert 'desc' in sc, '每个场景需要一个物理事件描述'
print('场景有效')
"

# 已知工具包缺陷分析
for f in ATTACH/*; do
  python -c "
from PIL import Image
import sys
img = Image.open('$f')
# 检查透明度
if img.mode != 'RGBA': print('$f: 警告 - 无透明度(模式 $f)')
# 检查尺寸 WxH
print(f'$f: {img.size}')
"
done

# 品牌标记拆分检查
python -c "
import cv2
import numpy as np
# 仅当在工具包中找到图层时才使用
base = cv2.imread('ATTACH/base.png', cv2.IMREAD_UNCHANGED)
layers = [cv2.imread(f'ATTACH/layer_{i}.png', cv2.IMREAD_UNCHANGED) for i in range(5)]
# 验证像素完美堆叠
stacked = sum(layers)
diff = cv2.absdiff(base, stacked)
max_diff = np.max(diff)
assert max_diff <= 2, f'最大差异 {max_diff} - 图层未能像素完美堆叠'
print('标记图层验证通过')
"

# 导出时间线结构完整性检查
python -c "
import re
with open('PROMPT.md') as f: s = f.read()
# 提取所有场景标签:OM_SCENES 部分
m = re.search(r'OM_SCENES.*?\]', s, re.DOTALL)
if m:
    print('OM_SCENES 定义存在')
else:
    print('警告:未找到 OM_SCENES 定义')
"

10. 阶段与门控

阶段之间的门控验证是该模型的保真机制。它不是可选的。

阶段完成条件门控确认
工具包所有资产均就位,KIT.md 具有已知缺陷打开每个文件;记录所有问题
场景结构OM_SCENES 有 3-6 个场景,每个都有 dur 和 descOM_SCENES 验证脚本通过
前 5-8 秒构建、渲染、联系人表联系人表检查
完整的构建整个电影构建,位置 build/导出时间线验证

验证每个阶段的前 5 秒。然后才继续。一个在任何人查看之前构建了 20 秒的阶段会产出一个无人能修复的 20 秒电影,因为概念性缺陷现在已深入结构之中。

11. 交付物检查清单

在将文件夹交给用户之前,请确认所有这些条件为真:

  • PROMPT.md 存在且完整,使用动画引擎的语言
  • ATTACH/ 包含动画引擎 animations-v3.jsx 和所有结构资产
  • 每个资产都是独立的、隔离的对象,长边至少为 1600px
  • 文件名携带指令(例如 REF_03_object-becomes-the-mark.png)
  • START-HERE.md 按正确顺序显式指定包含哪些文件
  • KIT.md 列出每个文件、其像素尺寸及其已知缺陷
  • frames/ 包含反映电影关键帧的参考帧
  • 需(如 SCRIPT.md 存在)已写入并指定硬停止
  • 已知缺陷已记录并在提示词中说明
  • 工具包总大小 ≤ 5 MB,适合包含在 Claude Design 项目中
  • 无资产指向 CDN;所有内容均为本地文件
  • 品牌标记已拆分为独立图层,并验证可像素完美堆叠
  • 需求指出资产缺失的具体情况,并说明替代方案
  • 如果期望本地构建,build/piece.jsx 和 build/frames/ 存在
  • 验证命令在 Claude Code 中运行,不依赖于浏览器播放

此检查清单为最低限度。任何可靠性低于此的工具包都会产生一部带有两处寂静断裂且无解释原因的电影。

相关技能