Communitygithub.com

yazzang-homelab/motion-studio

规划长篇或隔夜影片:导演简报(优先规划或直接执行、预算、完成标准)、动画指南 + 故事板、章节子智能体、门控、分段渲染。适用于'隔夜影片'、'音乐视频'、'2分钟短片'。

motion-studio 是什么?

motion-studio 是一个高级 AI 智能体技能,专为使用 Claude Code 等平台的开发者设计,用于规划、制作和交付长篇动画或实拍影片(时长超过约 45 秒)。它将用户的创意转化为一份结构化的导演简报,包括影片的核心概念、预算、风格指南和详细的故事板。该技能采用多智能体架构:一个主会话负责整体规划和门控管理,多个章节动画师子智能体并行处理每个章节的动画编码,从而实现高效工作。它支持三种工作流程:默认的 A 路由、基于 Remotion/HyperFrames 的 B 路由,以及一种创新的“生成-追踪”C 路由,后者利用 AI 视频模型生成基础素材,然后用可定制的代码层重塑动画。该技能强调严格的品质门控(从静态帧到最终渲染),确保一致性、同步性和可定义的完成标准(如响度、无占位符、可重复渲染)。它还通过分块渲染和后台执行来管理长时间运行的任务,适合制作隔夜音乐视频或 2 分钟短片。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/director-brief

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

导演简报(课程步骤 10)

长片即制作。课程中隔夜影片背后的简报描述的不是一个视频;它们雇佣了一个团队:一个用于检查每个决策的单行梗概、参考、工具和预算、角色圣经、节拍表、屏幕文本规则、门控、评审循环和最终交付物。此技能将用户的想法转化为该简报,并引导整个制作流程通过各个门控。对于不超过约 45 秒且无章节的片段,请改用 /motion-studio:motion-reel(该技能使用相同的阈值将更长的影片移交给此技能)。

参数,仅显示一次:

此技能的文件位于 ${CLAUDE_SKILL_DIR}(简报模板是${CLAUDE_SKILL_DIR}/assets/brief-template.md,assets/brief-template.md)。

此技能的成本

它以 max 级别的算力运行:这是 motion-studio 所有技能中最深的推理和最高的令牌使用量。规划错误会在数小时的自主工作中累积放大,因此规划就是耗费这些成本的意义所在。在开始之前应设定用户的预期。课程中报告的数据点:一部隔夜音乐视频运行了约 12 小时,使用了约 80% 的 Max 计划用量,另加 75 美元的图像/视频 API 信用额度;一部 45 秒的手绘短片使用了 163 次模型调用,6270 万令牌(96% 缓存读取),按 API 列表价格计算约 34 美元,耗时约 6.75 小时。保持其他部分更便宜:章节动画师以其自身的算力级别运行(高),而修复和重新渲染是中等算力的工作。如果预算重要,请在计划批准后告知用户使用 /model 降低会话算力级别。

1. 收集输入

只有主会话可以向用户提问(子智能体不能)。如果用户口述了一个长篇简报,则解析它而不是重新询问。否则,一次性在一条消息中询问缺失的信息:

输入原因
单行梗概,以及观众在结尾应感受到什么每个决策都以此为基础进行检查
时长、格式、发布平台章节数量、渲染时间、安全区域
参考(视频、帧、图片库、先前项目仓库)采用的语法、避免的内容
音乐:一首曲目(及其许可证)或“合成”所有内容锁定的节拍网格
路由(A 默认;仅当用户指定 Remotion/HyperFrames 时为 B;C 生成-追踪)以及按变量名命名的 API 密钥工具和花费
预算:模型使用量、付费 API、实际时间何时停止生成
模式:优先规划或直接执行是否在计划后停止

2. 编写 docs/brief.md

  1. 如果没有 studio.json,首先运行 /motion-studio:studio-init(设置 --duration、--bpm、--formats)。
  2. 将 ${CLAUDE_SKILL_DIR}/assets/brief-template.md 复制到 docs/brief.md。用用户的回答填充 A 部分;保持 B 部分不变。
  3. 更新 studio.json 以匹配(标题、时长、fps、bpm、格式、品牌、loop)。
  4. 优先规划:显示填好的简报并停止,直到用户批准。直接执行:在 docs/decisions.md 中记录你为用户做出的每一个决定并继续。

3. 门控 1:计划文档

文件内容编写者
docs/style_guide.md调色板、字体、节奏、转场、纹理、禁用外观style-analyst 子智能体(参考 /motion-studio:reference-style),或由你编写
docs/STORYBOARD.md核心理念、演员阵容、整体串联线索、带有定时镜头和转场的章节motion-director 子智能体,或由你编写
docs/shotlist.md节拍网格上的每个镜头(小节)、摄像机、文本、音效motion-director
章节计划(在 STORYBOARD 中)强拍上的章节边界,每个章节的所有者你

在对任何内容进行计时之前,测量或合成音乐(/motion-studio:sound-design):章节和镜头时间应为 grid.bar(n) 值,而非猜测。保持章节时长为 8 到 30 秒,以便一个子智能体可以在一个会话中完成并检查一个章节。motion-director 只编写 docs/**(角色守卫钩子强制执行此规则)。

4. 门控 2:装备和指南

  1. 在任何章节动画师开始之前,从项目 docs/ 中的模板编写 docs/ANIMATION_GUIDE.md,以便每个章节以相同风格编码:章节如何工作、所有权、布局和保留区域、共享 API、共享元素、带有绘制时间预算的风格规则以及精确的检查命令。
  2. 在 film/scenes/shared_<name>.js 中自行构建共享元素(英雄角色、UI 套件、调色板辅助函数)。章节动画师导入它们但从不编辑。渲染每个元素在所有状态下的静态图像。
  3. 对每个章节进行桩代码,以便在章节进行过程中影片可以端到端渲染:
// film/scenes/ch03_build.js(由主会话编写的桩代码;章节动画师将替换镜头)
import { chapter } from '../../lib/timeline.js';
export const BARS = [12, 20];                          // 来自 docs/STORYBOARD.md 的小节跨度(null = 到结尾)
export default function ch03(ctx) {
  const FROM = BARS[0] === 0 ? 0 : ctx.grid.bar(BARS[0]);
  const TO = BARS[1] == null ? ctx.dur : ctx.grid.bar(BARS[1]);
  return chapter({ name: 'ch03_build', from: FROM, to: TO, shots: [], cues: [] });   // 无镜头 = 占位卡片
}
  1. 一次性地连接 film/film.js。buildFilm 接受 scenes 内的 chapter() 结果,展平其场景并合并其提示。影片级图层(字幕、章节间转场)放置在工厂函数的 overlays: Scene[] 中:它们在每个场景之后绘制,按数组顺序,遵循相同的 from <= t < to 规则(在影片最后一帧包含结尾),且它们从不计为镜头,因此静态标签、评论镜头边界和预览条仅列出章节镜头。章节代码保持不变;不要包装或修补章节 draw 函数。overlays 也接受嵌套数组、null 和 chapter() 结果,因此一个章节可以提供自己的叠加场景。要堆叠普通场景,请为场景指定一个 layer 编号(默认为 0):场景按 (layer, from) 顺序绘制。
import { defineFilm, scene } from '../lib/timeline.js';
import ch01 from './scenes/ch01_hook.js';
import ch02 from './scenes/ch02_problem.js';
import ch03 from './scenes/ch03_build.js';

const CHAPTERS = [ch01, ch02, ch03];

export default defineFilm((ctx) => ({
  scenes: CHAPTERS.map((make) => make(ctx)),
  overlays: [
    scene(0, ctx.dur, 'captions', (g, lt, c) => { /* 影片级字幕:从影片时间 c.t 绘制 */ }),
    // 每个需要转场的章节接缝处的一个短场景,从网格计时
    scene(ctx.grid.bar(12) - 0.2, ctx.grid.bar(12) + 0.2, 'seam-ch02-ch03', (g, lt, c) => { /* 擦除或闪烁 */ }),
  ],
  cues: (grid) => [{ t: grid.bar(0), type: 'hit' }],   // 影片级提示;章节提示自动合并
}));

5. 分派章节

为每个章节生成一个 chapter-animator 子智能体(motion-studio:chapter-animator),可并行处理多个。为每个智能体提供以下简报:其文件(film/scenes/chNN_<name>.js)、其跨度(其桩代码中的 BARS 导出,以及用于检查命令的相同以秒为单位的跨度)、其 STORYBOARD 部分,以及“遵循 docs/ANIMATION_GUIDE.md”。角色守卫钩子允许章节动画师仅写入 film/scenes/**(film/scenes/shared_* 除外,章节动画师对其保持只读,而是报告共享文件中的错误)和 out/check/**。每个返回一份报告:构建了什么、检查静态图像、已知问题以及在共享文件中发现的错误。你修复共享文件,重新运行整部影片的检查,并在报告显示问题时重新简报章节。

章节跨度是以小节为单位的,在章节工厂内部使用 ctx.grid 计算,因此连续的章节总是相互衔接并遵循已测量的轨道。镜头时间是取自网格的绝对影片秒数(shots: [{ at: grid.bar(13), name: 'assemble', draw }, ...]);每个镜头运行到下一个镜头的 at 时间,其 draw(g, lt, c) 从镜头开始处接收 lt。一个超出其章节跨度的镜头会导致 chapter() 抛出异常并停止加载影片(例如,字面上的 TO = 4 会拒绝一个位于 grid.bar(1) = 4.003 秒的镜头,一旦已测量的轨道将第一个强拍置于 2.0 秒)。

6. 门控 3 到 8

门控操作检查
3 静态帧node tools/stills.mjs --shots(每个镜头一个静态帧)评审轮次(/motion-studio:critique-loop)
4 分镜动画npm run animatic(半分辨率,30 fps,无模糊),使用真实或占位轨道节奏:每次阅读都在下一个节拍之前结束
5 最难示例对最难处理的 2 到 4 秒执行 node tools/render.mjs --from A --to B --out out/checknode tools/critique.mjs --strip-at <t>;确定性;同步
6 完整通过无剩余占位符(node tools/stills.mjs --shots 中没有以 /placeholder 结尾的镜头标签)对整部影片进行评审轮次
7 润色和声音/motion-studio:sound-design:配乐或节拍、提示、音效、配音同步指标、声音轴
8 最终npm run build简报 B6 中定义的完成标准

长片以可恢复的片段形式渲染:node tools/render.mjs --format all --final --chunk 10 写入 out/<fmt>/.parts/seg_<a>_<b>.mp4,并在中断后重新运行时跳过已完成的片段。在后台运行长时间渲染(使用 Bash 工具的 run_in_background,或轮询日志文件),而不是阻塞会话,且前台等待时间切勿超过约 2 分钟。以 60 fps 和 4 个子帧为三种格式预算约 20 秒的实际时间来渲染每秒影片(一部 2 分钟的影片大约需要 40 分钟渲染);/motion-studio:motion-reel 的管道运行手册包含模式以及所有其他命令的预期时间。章节动画师或任何其他子智能体,在其启动的命令仍在运行时不得返回。

7. 路由 C:生成-追踪(可选)

仅当简报选择路由 C 并列出密钥(按变量名:.env 中的 FAL_KEY、ELEVENLABS_API_KEY)和预算时使用。视频模型提供了很难手工编码的物理效果、时机和面部特征;代码层提供用户拥有的一致外观。观众看到的是代码层。

  1. 使用用户选择的服务,遵循其自身文档,生成角色表 and 基础镜头。将所有结果保存在 refs/base/ 下,并附带清单行(服务、模型、提示、种子、成本、许可证)。在达到预算时停止。
  2. 提取帧以供研究:node tools/refs.mjs extract refs/base/shot01.mp4 --every 0.1 --out refs/base/shot01。
  3. 在该时序之上用代码重新绘制每个镜头(查看帧,用弹簧和轨道重建运动)。基础素材在渲染时从不从网络加载;如果某个镜头合成基础帧,请在 setup() 中从本地文件加载它。
  4. 验证同步:相同时间点上代码层和基础帧的静态图像,以及网格上的音频提示。对任何存在漂移的镜头重新运行此步骤。

密钥:绝不打印、回显、记录或粘贴密钥。工具自行读取 .env;在提示和文档中命名变量。

8. 完成标准和报告

简报的 B6 是合同:交付的 MP4 响度为 -14 LUFS ±0.5 且 <= -1 dBTP,至少 3 轮评审,每项指标 >= 8 且无 P0(npm run gate),重新渲染产生相同的帧(评审确定性检查加上两次 --hash 渲染的 framesDigest 值相等),每种格式的精确时长和帧数,以及所有交付物存在(npm run deliver 检查大部分内容并写入 docs/production.json)。以 B7 报告结束:交付物、每轮得分、实际花费、已知缺陷、下次将改进的内容。

鸣谢:简报框架遵循课程的步骤 10;填充/保持原样分割、优先规划与直接执行以及完成标准遵循 @pradeepXkapoor 的一个公共模板模式(已重新措辞);验收门控改编自 athemeroy/awesome-opus-5-5-videos 的 docs/production-brief.md(CC BY 4.0);指南加故事板子智能体模式研究自 JohnHeibel/PDoomVideo(仅为理念,未重复使用文本)。

下一步:从门控 3 开始,每个门控之后运行 /motion-studio:critique-loop,然后运行 /motion-studio:ship-formats 进行交付。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

相关技能