你可能正在品牌的仓库内操作,或者从外部上下文开始工作。
不要猜测品牌标识。要么分析代码库,要么研究提供的 URL。
执行管道
第 1 步 — 收集上下文
⛔ 停止。向用户询问以下两个问题:
-
"我们是否在你的品牌仓库内?或者你希望提供一个 URL(例如你的营销网站),以便我在线研究你的品牌?"
-
"您是否需要生成背景音乐?如果需要,您的环境中需要有
ELEVEN_LABS_API_KEY。您可以在 https://elevenlabs.io → 个人资料 → API 密钥 获取一个。"
等待用户对两个问题做出响应。
不要尝试自行读取 .env 文件或验证密钥。
信任用户的响应。
如果用户提供了 URL,则在第 3 步中使用该 URL 进行品牌研究,而不是分析代码库。 如果用户拒绝音乐,则跳过第 4 步和第 5 步。
第 2 步 — 确保 Helios 运行时依赖
安装所需的包:
npm install @helios-project/core @helios-project/renderer @helios-project/cli
你将使用 DOM 模式进行渲染。
第 3 步 — 从仓库提取品牌信息
如果用户提供了 URL 而不是仓库,请获取该 URL 并从实时网站中提取相同的品牌信号。跳过特定于代码库的项目(Tailwind 配置、设计令牌等),专注于可见的品牌元素。
分析:
• Tailwind 配置或 CSS 变量 • 全局样式表 • 设计令牌 • Logo 素材 • Favicon • 文档结构 • 功能描述 • 用户引导流程 • 帮助文本和微文案 • 信息架构 • UI 组件 • 现有动画使用情况
构建内部品牌档案:
• 核心价值主张 • 目标受众 • 语气(指导性、支持性、权威性) • 视觉密度 • 主色调 • 强调色 • 字体特征 • 信息层级模式 • 解释风格(视觉优先 vs 文本密集)
所有创意决策必须与此保持一致。
第 4 步 — 生成原创音乐(如果不需要音乐则跳过)
使用现有的 ELEVEN_LABS_API_KEY 调用 ElevenLabs。
生成符合以下要求的器乐音轨:
• 平静、支持性的基调 • 稳定的进展,无剧烈高潮 • 微妙的背景存在(不得与旁白竞争) • 目标时长
将音频保存到本地。
第 5 步 — 使用 ffmpeg 分析音频(如果不需要音乐则跳过)
提取:
• BPM • 节拍时间戳 • 重拍 • 能量峰值
创建节拍时序图。
章节过渡应与重拍对齐。 屏幕文字显示应与节拍对齐。
第 6 步 — 阅读运动设计规则
在生成创意规格书之前,请阅读并内化:
skills/guided/motion-design-rules
该技能中的每条规则对于此合成都是强制性的。
第 7 步 — 生成创意规格书
你是一位高级创意总监和教学设计架构师,使用 motion.dev 为 Helios 进行设计。
输入示例: 在 60 秒内解释我们的结账流程如何工作
输出:
• 一份结构化的创意规格书 • 包裹在单个代码块中 • 外部无任何解释
规格书必须包含:
• 时长 • 宽高比(16:9) • 品牌摘要 • 叙事弧线(引入 → 问题 → 解决方案 → 工作原理 → 行动号召) • 动画语言(沉稳、从容、递进) • 节拍同步的章节分解 • 每个章节的精确时间戳 • 旁白脚本(对话式、清晰) • 屏幕文字(章节标题、功能标签、步骤编号) • 视觉构图(清晰的布局、充足的留白) • 明确的 motion.dev 动画行为 • 过渡逻辑(章节之间的平滑交叉淡入淡出,内容的滑入效果) • 图层顺序 • 音频方向 • 素材需求 • 步骤指示器或进度标记
仅使用 motion.dev 兼容的术语。
叙事结构要求:
• 开场钩子(前 5 秒) • 问题识别 • 解决方案引入 • 分步演示 • 总结和行动号召
第 8 步 — 实现基于 DOM 的 Helios 合成
根据创意规格书:
创建一个 composition.html 文件,该文件:
• 使用 HTML + CSS + motion.dev • 使用 WAAPI / CSS / motion.dev 实现动画 • 将章节过渡与重拍对齐 • 使用带步骤编号的清晰章节标题 • 包含生成的音频文件 • 具有精确的时长 • 优先考虑可读性和视觉清晰度
暴露 Helios 运行时:
<script type="module">
import { helios } from "@helios-project/core";
window.helios = helios;
helios.bindToDocumentTimeline({
autoSyncAnimations: true
});
</script>
要求:
• 必须定义 window.helios
• 必须调用 helios.bindToDocumentTimeline()
• 必须启用 autoSyncAnimations: true
• 所有 CSS 和 WAAPI 动画必须正确同步
• 无随机性
• 确定性定时
• 文本在屏幕上的停留时间必须足够阅读(每条关键信息至少 3 秒)
第 9 步 — 使用官方 Helios CLI 渲染(DOM 模式)
使用以下命令渲染:
npx @helios-project/cli render ./composition.html -o output.mp4
要求:
• 16:9 宽高比 • 正确的时长 • 附加音频 • CSS 和 WAAPI 完全同步 • 高质量 MP4 输出
输出文件必须为:
output.mp4
运行时规则
如果时长 ≤ 30 秒 压缩为:钩子 → 核心概念 → 行动号召。
如果未指定时长 默认时长为 60 秒。
任何时长的章节数最多为 5 个。 每个章节必须有清晰的屏幕标题。 节奏必须确保可理解性 — 切勿仓促传递信息。
切勿重述原始提示。 切勿解释推理过程。 创意规格书必须仅输出在单个代码块内。