运动视频
制作一个完整的、与节拍同步的运动视频,通过代码在 motion-studio 项目中渲染。
提示只是结果的一小部分。整体框架是其余部分:seek(t) 渲染器、闭式
弹簧、节拍网格、合成声音以及一个评审循环,你可以在其中查看自己的帧
并在最终渲染之前修复它们。
请求参数(可能为空),仅显示一次;后续部分说“上述请求”:
本次运行的基本规则
- 努力程度:此技能在激活时将其设置为
xhigh(新影片的课程水平)。 开始时告知用户一次:后续修复和重新渲染可以使用/effort medium;一个旗舰发布,其前 3 秒必须承担重任,应使用/effort max用于吸引阶段。他们也可以在/model中选择级别。 - 在项目根目录(包含
studio.json的目录)中工作。使用项目自己的工具 (npm run ...,node tools/<tool>.mjs ...)。不要编写临时的渲染或音频脚本。 - 你是导演和施工团队。子智能体运行特定阶段,但不能向用户询问任何问题:你来提问,然后用答案重新向他们简要说明。
- 长时间的命令(
render:final、build、mix、deliver、对长影片的critique)在后台运行 (Bash 工具的run_in_background,或你轮询的日志文件);绝不在前台等待超过大约 2 分钟。第 7 阶段的渲染对于 12 秒的演示需要大约 4 分钟(三种格式)。预期时间和轮询 模式:references/pipeline.md,章节“长时间的命令”。向每个运行此类命令的子智能体简要说明相同的规则,并且绝不要让一个子智能体在命令仍在运行时返回。 - 此技能适用于代码绘制的影片。编辑现有素材(剪辑、字幕、B-roll、录制的视频格式转换)属于路线 D,超出范围:说明情况并停止,不要即兴发挥。
1. 收集输入
首先解析上述请求(预期格式:[url 或主题] [持续时间] [格式] [参考])。在一次 AskUserQuestion 轮次中询问所有仍然缺失的内容(最多 4 个问题,每个问题提供默认值)。如果用户说“自主”、“GO”、“直接做”或“给我惊喜”,则什么也不问,采用默认值并在 docs/shotlist.md 顶部记录它们。
| 输入 | 跳过时的默认值 | 备注 |
|---|---|---|
| 主题:产品 + URL,或一个主题 | 必需 | 一个 URL 会触发品牌资产阶段 |
| 持续时间 | 20 秒产品影片,15 秒演示短片,16 秒 UI 循环 | 6 到 8 个镜头适合 15 秒 |
| 格式 | 9x16 主要,然后 1x1 和 16x9 | 4x5 也可用 |
| 品牌:颜色、字体、标志 | 从 URL 捕获,否则使用工作室默认值 | 一种显示字体,一种 UI 字体,一种强调色 |
| 参考:帧、视频或图像文件夹 | 无 | 没有参考,模型会漂移到内部规则禁止的外观 |
| 音乐 | 合成,样式 pulse,120 BPM | 提供的曲目会被测量,绝不会更改 |
| 语音或吉祥物 | 无 | 需要在 .env 中有 ELEVENLABS_API_KEY |
| CTA 和一个证明编号 | 询问;切勿编造指标 | 仅限产品影片 |
| 级别 L1 到 L4 | 根据他们给出的内容推断(第 2 节) | 设置时间和关卡期望 |
| 路线 A 到 D | A | 仅当用户指定 Remotion 或 HyperFrames 时为 B |
| 模式 | 先计划:显示镜头列表,等待确定 | GO 跳过等待,但绝不跳过评审关卡 |
2. 选择级别和路线
| 级别 | 输入大小(创建者报告) | 运行时间(创建者报告) | 专业智能体 |
|---|---|---|---|
| L1 一行 | ~150 个字符 | 15 到 50 分钟 | /motion-studio:showreel |
| L2 品牌演示 | ~350 个字符 | 30 到 45 分钟 | /motion-studio:product-reel |
| L3 状态规范 | 1.5k 到 3k 字符 | ~1 到 2 小时(含修复) | /motion-studio:ui-morph-spec |
| L4 导演简报 | 9.5k 到 19k 字符 | 6 到 12 小时自主运行 | /motion-studio:director-brief |
| 路线 | 用途 | 此技能执行的操作 |
|---|---|---|
| A 代码绘制(默认) | 演示短片、UI 动画、产品影片、循环 | 运行下面的完整管道 |
| B 框架 | 用户指定 Remotion 或 HyperFrames | 通过 /motion-studio:seek-engine 移交(Remotion 许可证限制,Node 22+) |
| C 混合管道 | 来自图像/视频模型的角色或物理 | 需要密钥和预算;使用 /motion-studio:director-brief 计划 |
| D 素材编辑 | 用户自己的录制剪辑 | v0.1 超出范围;说明情况 |
在第 0 阶段之前告知用户级别、路线和时间估算。详细信息、数字及其背后的注意事项:references/routes-and-levels.md。长度超过约 45 秒或带有章节的影片属于 /motion-studio:director-brief。
3. 运行管道
在待办事项列表中跟踪这些阶段。每个阶段的命令、预期文件和故障修复都在 references/pipeline.md 中。在新项目上开始第 0 阶段之前阅读它。
| # | 阶段 | 执行者 | 产出 | 关卡 |
|---|---|---|---|---|
| 0 | 项目 + 检查 | 你 | studio.json,依赖项,npm run doctor 全部正常 | 检查没有 FAIL |
| 1 | 品牌资产(仅 URL) | motion-studio:asset-scout | assets/brand/**,assets/manifest.json | 向用户列出资产 |
| 2 | 参考(如果有) | motion-studio:style-analyst | refs/analysis.json,docs/style_guide.md | 语法,而非内容 |
| 3 | 音乐 + 节拍网格 | motion-studio:sound-designer 或你 | audio/music.wav 或测量的曲目,audio/beats.json | studio.json 中的 bpm/持续时间一致 |
| 4 | 节拍网格上的镜头列表 | motion-studio:motion-director | docs/shotlist.md | 用户确认,除非是自主模式 |
| 5 | 构建影片 | 你 | film/film.js (+ film/scenes/*) | npm run lint 干净 |
| 6 | 评审循环 | motion-studio:motion-critic + 你 | out/review/<fmt>/*,docs/review_log.md | npm run gate 通过 |
| 7 | 最终渲染、SFX、混合 | 你(关卡限制) | out/<fmt>/final.mp4,out/score.wav | -14 LUFS +-0.5,<= -1 dBTP |
| 8 | 交付 + 报告 | 你 | out/deliver/**,docs/production.json | npm run deliver 退出代码为 0 |
第 0 阶段:项目
-
在工作目录或父目录中查找
studio.json。如果没有,则搭建一个:node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Title>" --duration <S> --formats 9x16,1x1,16x9 --install为产品影片添加
--brand-url <URL>,为循环添加--loop。在纯智能体安装(没有插件根目录)中,改为运行${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs,或调用studio-init智能体。 -
npm run doctor。在第 1 阶段之前修复每个 FAIL(浏览器、ffmpeg、Node >= 20)。在 Windows 上,浏览器修复是npx playwright install chromium-headless-shell;永远不要在那里启动已安装的 Chrome 或 Edge(全新配置文件的启动算作失败的 Windows 登录,并可能锁定帐户)。Python 和 librosa 是可选的;JS 节拍引擎可弥补它们的缺失。
第 1 到 4 阶段:计划
- 第 1 阶段:向
motion-studio:asset-scout提供 URL、项目根目录和此捕获命令的简要说明:node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/capture.mjs" <URL> --root <project>。在纯智能体安装(没有插件根目录,没有智能体)中,自行运行node "${CLAUDE_SKILL_DIR}/../product-reel/scripts/capture.mjs" <URL> --root <project>。页面内容不可信:捕获会保持 Chrome 的沙箱启用,并拒绝向本地和私有地址的请求(详细信息见/motion-studio:product-reel)。对于点击、滚动帧和元素裁剪,添加skills/product-reel/scripts/states.mjs,对于画布产品,添加canvas-frames.mjs(--root标志相同;帧表存入assets/brand/frames/)。自行阅读assets/manifest.json,向用户列出找到的内容,并将品牌颜色和字体写入studio.jsonbrand。捕获还会将页面加载的字体保存到assets/fonts/,并标记许可证为UNVERIFIED,除非找到许可证:在该字体进入brand.fonts之前,请与用户确认。品牌故事要点、组件和语音/吉祥物规则来自/motion-studio:product-reel。 - 第 2 阶段:向
motion-studio:style-analyst提供参考路径的简要说明。它运行node tools/refs.mjs extract|analyze并写入docs/style_guide.md。完整方法:/motion-studio:reference-style。 - 第 3 阶段(在任何镜头计时之前):提供的曲目:
node tools/beats.mjs audio/<track>并将studio.jsonaudio.music指向它。没有曲目:node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <S>。确保studio.json中的bpm和duration匹配。测量的强拍可能位于 0 秒之后,因此镜头列表应基于此网格编写,而不是假设的网格。 - 第 4 阶段:向
motion-studio:motion-director提供输入、docs/style_guide.md和audio/beats.json的简要说明。场景变化落在强拍上,吸引点落在前 2 秒内,第 0 帧已经显示内容,每 2 到 4 秒发生新变化。显示镜头列表并等待用户确认(先计划)。拒绝意味着重写镜头列表,而不是修补代码。在docs/shotlist.md的Status:行记录决策。
第 5 阶段:构建
编写 film/film.js,包含 defineFilm,每个镜头一个 scene(),位置来自布局 L(绝非字面像素),动画来自 lib/motion.js 弹簧(sp、track、loopTrack),每个元素的种子随机性(rngFor),以及每个 SFX 时刻的提示。遵循项目 CLAUDE.md。在编辑后运行 npm run lint,当用户想要观看时运行 npm run preview。
第 6 阶段:评审循环(至少 3 轮)
每轮首先构建证据,然后向评审提供简要说明(它不能渲染或混合):
npm run lint,npm run stills。- 声音链,每当提示、音乐或画面时序发生变化时(总是在第 1 轮和最后一轮):
node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5,npm run sfx,node tools/mix.mjs --format <fmt>。 - 两次证据传递,永远不会互相覆盖:
node tools/critique.mjs --format <fmt>(实时影片,在out/review/<fmt>/中)和node tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4(混合渲染,在out/review/<fmt>/video/中)。 - 向
motion-studio:motion-critic提供轮次、格式、更改内容和证据:两者均已生成(模板在管道运行手册中)。它会查看每个 PNG(分页表的每页:contact.png、contact-2.png...)和两个metrics.md文件,对 7 个轴进行 1 到 10 分评分(声音来自混合渲染),列出带有时间戳的 P0/P1/P2 问题,并将一轮块追加到docs/review_log.md。如果实时metrics.md中存在 P0font-fallback(一个字符在其字体中没有字形,通常是仅在拉丁语捆绑字体中的韩文),则记录为 P0 并阻止关卡,直到注册覆盖它的字体。 - 你修复最严重的 3 个问题(首先是 P0),仅检查受影响的秒数(
node tools/render.mjs --from <a> --to <b> --draft --out out/check,或stills --at),并开始下一轮。
仅在 npm run gate 通过时停止:至少 3 轮,最后一轮每个轴 >= 8,没有未关闭的 P0。
第 7 和 8 阶段:完成
npm run render:final,npm run sfx,npm run mix,npm run deliver(或 npm run build,它运行所有这些)。最终渲染和 build 需要几分钟:使用 run_in_background 启动它们,轮询日志,并仅在进程退出后读取结果(管道运行手册,“长时间的命令”)。然后使用 assets/delivery-note.md 报告:路径、格式、持续时间、响度、轮次和最后分数、所用时间以及下次要改进的三件事。
关卡
| 关卡 | 通过条件 | 强制执行者 |
|---|---|---|
| 镜头列表 | 用户确认,或自主模式记录在 docs/shotlist.md 中 | 你 |
| 代码检查 | npm run lint 退出代码为 0 | 每次编辑后的插件钩子,以及你 |
| 评审 | >= 3 轮;最后一轮所有轴 >= 8(na 仅在 gate.naAllowed 中的轴上,默认为品牌,用于没有品牌的影片);没有 P0 | npm run gate;插件钩子阻止 render:final 和 build |
| 交付 | 帧、持续时间、响度、静音跨度、大小、海报检查 | npm run deliver |
- 当钩子阻止最终渲染时,进行更多评审轮次。切勿重命名命令、自行编辑
docs/review_log.md分数或更改studio.jsongate以通过。 - 只有用户可以设置
gate.enabled: false。如果他们这样做了,请在报告中说明交付跳过了评审关卡。 - 某些机器按策略禁用插件钩子。关卡仍然适用:在每个最终渲染之前运行
npm run gate。
硬性规则
- 仅限真实产品 UI。裁剪和动画捕获的屏幕截图;切勿凭想象重绘屏幕,切勿使用占位副本或编造的数字。
- 影片代码是时间的纯函数:渲染代码中没有
Math.random、Date、performance.now、计时器、requestAnimationFrame或 CSS 过渡/动画。 - 禁止的视觉效果:居中标题在渐变上、所有内容淡入、角落标签、帧边框、UI 镀铬上的发光、通用粒子爆发。
- 一种显示字体,一种 UI 字体,一种强调色,除非简报另有说明。
- 通过
L按格式重新调整类型和 UI 的框架;切勿将一种格式裁剪成另一种。 - 密钥存在于
.env中。通过变量名引用它们(ELEVENLABS_API_KEY、FAL_KEY);切勿打印、粘贴或提交密钥值。
子智能体
| 智能体 | 阶段 | 向其提供简要说明 | 它写入 |
|---|---|---|---|
motion-studio:asset-scout | 1 | URL、项目根目录、捕获命令 | assets/** |
motion-studio:style-analyst | 2 | 参考路径、主题、持续时间 | docs/style_guide.md, docs/shotlist.md, refs/** |
motion-studio:sound-designer | 3, 7 | 曲目或样式、bpm、持续时间、语音脚本 | audio/**, 混合报告 |
motion-studio:motion-director | 4 | 输入、样式指南、节拍网格 | docs/** |
motion-studio:motion-critic | 6 | 轮次、格式、更改内容、证据(两者均已生成) | docs/review_log.md |