Emulo 视频
你将一个需求转化为一部电影。不是提示词,而是一部电影:构建它的提示词、合成文件以及可供他人查看的帧。
0. 在写任何内容之前加载配置文件
- 在当前技能目录上两级找到
emulo.py;如果直接检查仓库,则回退到./emulo.py。 - 将解析后的绝对路径存储为
EMULO_PY,然后运行python "$EMULO_PY" plugin profile-path --domain video。 - 如果退出码非零,给出确切的恢复指令并停止加载个人上下文。绝不替换通用创意角色。
- 完整读取每个返回的路径。第一个是核心工作配置文件,第二个是视频配置文件。两者优先级均高于以下内容:当用户自己挖掘的规则与本技能中的默认规则冲突时,以用户的规则为准。
- 如果项目有自己的视频文档或路由器,请先读取它们,并遵循它们涵盖的任何内容。
1. 你需要交付的内容
一个用户可以上传到 Claude Design 并获取一部电影的文件夹。 这就是交付物。不是聊天消息中的提示词,不是电影描述,也不是想法列表。一个文件夹。
在项目中构建它,文件夹名称以品牌或电影名称命名,结构如下:
| # | 制品 | 存在理由 |
|---|---|---|
| 1 | PROMPT.md | 需求。一页,使用引擎的语言 |
| 2 | START-HERE.md | 上传顺序。 哪些文件,按什么顺序,放在一条消息中。没有它,用户只能猜测,而猜测总是错的 |
| 3 | ATTACH/ | 电影所需的所有资产,包括 animations-v3.jsx 本身 |
| 4 | frames/ | 参考帧,其文件名携带指令 |
| 5 | KIT.md | 清单:每个文件、其像素尺寸、已知缺陷 |
可选地,仅在完成以上五项之后:build/piece.jsx 加上 build/frames/,在本地构建并渲染的电影,以便在其他人之前查看。这是验证,不是交付物。没有本地构建的工具包仍然可以交付。没有工具包的本地构建则不行。
决定文件夹是否有效的三件事
将引擎放入 ATTACH/ 中。 animations-v3.jsx 与资产一起放在文件夹中。Claude Design 需要它被要求编写的运行时。遗漏它是导致好的提示词产生差电影的一个常见原因。
独立的部件,而不是整个屏幕的截图。 每个文件一个对象,透明,长边至少 1600px,加上电影宽高比的大背景板。整屏放入会变成一块平板,看起来像是损坏的。这样构建的电影因缺少资产而失败的概率远高于因提示词长度。
将指令放在文件名中。 REF_03_object-becomes-the-mark.png 提供了教学;而 ref3.png 则不会。上传它们的用户会保留文件名,因此每个文件都将其自身的教训带入上下文中。
说明缺失的内容。绝不虚构替代品。
如果某个资产不存在,在 PROMPT.md 中的单独标题下说明,并说明要改为做什么。承认两个缺失资产的需求是可用的。安静地伪造它们的需求会产生一部带有两个断裂节拍且无法解释原因的电影。
每个提示词都包含,并按此顺序按名称引用
- 用引擎语言编写的需求:
OM_SCENES、CUES、命名的Easing - 转换链,作为匹配锚点:什么变成了什么
- 资产列表,使用真实文件名,这样没有一个节拍因缺少部件而被阻塞
- 此特定电影的故障条件,而非通用的
- 验证命令,这样“它有效”的声明就有一个输出作为依据
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 比例测量参考,一个文件,绝不是联系人表。记录节拍、底色、平均亮度、平均饱和度以及占据帧的实际内容。
- 品牌摄入。 官方标记通常位于品牌自身的指南或新闻页面上,夹杂在他们的“不要这样做”示例中。渲染亮色和暗色联系人表,在命名任何东西之前查看。
- 将产品 UI 重建为携带真实字符串的实时 DOM,然后使用无头浏览器以 3 倍到 5 倍放大率将其拍摄成扁平背景板。界面是重建的。世界艺术是渲染并合成的。没有什么是伪造的。
- 分割部件,而非屏幕。 整个屏幕是一块平板,平板无法动画,只能滑动。交付一个
parts/文件夹,包含 1600px 及以上的隔离透明对象:每个按钮、芯片、节点、条形、磁贴、徽章、图标。 - 将标记分离到其自身的图层中。 官方 SVG 会拆分为可以像素完美堆叠的图层。验证它:堆叠后与原始文件相比,任何像素上的最大差异大约为 255 中的 1,这是抗锯齿的结果。然后,电影组装该标记,而不是切换到它。
- 优化。 保持每个文件较小(几百 KB),整个工具包几 MB,以便能够成功携带到 Claude Design 项目中。
- 打开每个文件并在
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 和 desc | OM_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 中运行,不依赖于浏览器播放
此检查清单为最低限度。任何可靠性低于此的工具包都会产生一部带有两处寂静断裂且无解释原因的电影。