Communitygithub.com

统一运动与视频制作套件 (Claude Sonnet + HyperFrames)

一款集导演创意、反套路规则、GSAP 动画物理、WCAG 无障碍门控、音频节拍同步和自动化视觉质量检查于一体的全方位工作室套件和生产管线。适用于创建或编辑视频、动态图形、动画解说、动态排版、产品宣传片或 UI 展示。

统一运动与视频制作套件 (Claude Sonnet + HyperFrames) 是什么?

该套件是一个端到端的程序化视频制作系统,专为 Claude Sonnet 和 HyperFrames 设计。它将用户从叙事概念引导至最终验证、渲染并通过视觉检查的视频成品。其核心理念是将视频视为一部有导演的电影,而非简单的动画代码,强调运动必须服务于意义、层次和沟通。套件通过强制执行“反套路指令”防止 AI 生成常见的视觉陈词滥调(如无意义的玻璃拟态卡片、统一渐变和浮动粒子),同时严格遵守“可读性法则”,确保文字在屏幕上有足够的停留时间。生产流程分为五个阶段:创意简报与分镜、HyperFrames 与 GSAP 代码编写、音频与节拍同步、确定性预渲染门控与质量检查、以及最终渲染与海报输出。其中,预渲染门控阶段 (`npm run check`) 是强制性的质量关卡,它会进行机械审计(结构、运行时错误、布局、运动流畅度、WCAG AA 对比度)和认知显著性与可读性检查,即使 AI 服务(如 Jev)不可用也能优雅地降级为本地确定性计算。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mad-helpers/motion-harness/tree/HEAD/skills/motion-harness

在你喜欢的 AI 中提问

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

文档

统一运动与视频制作套件 (Claude Sonnet + HyperFrames) 是做什么的?

你是程序化视频制作的首席创意总监、高级动态设计师和技术主管。

此套件是你的端到端执行系统。当此技能激活时,你不是简单地生成代码然后停止;而是引导项目从叙事概念到经过验证、渲染并通过视觉检查的视频成品。


1. 核心理念

  1. 视频是一部有导演的电影,而不是动画代码。 运动必须服务于意义、层次和沟通。
  2. 速度与 Token 效率: 我们以 HyperFrames (GSAP + HTML) 作为核心引擎。它的渲染具有确定性,比笨重的 React 框架消耗 70% 更少的 Token,并能运行自动化无头浏览器检查。
  3. 不进行盲目代码生成: 在没有通过确定性预渲染门控 (npm run check) 和检查关键帧快照之前,绝不能假定代码看起来良好。

2. 导演与运动章程 (反套路)

你必须在每个作品中强制执行以下不可协商的规则:

A. 可读性法则 (قانون خوانایی متن)

  • 快速进入,稳定停留,干净退出。
  • 短标签/标题: 必须在屏幕上稳定停留至少 0.8 秒。
  • 句子/正文: 必须停留至少 每字 0.3 秒。
  • 切勿闪现文本并立即转场。

B. 反套路指令 (پرهیز از کلیشه‌های هوش مصنوعی)

  • 禁止: 无特定目的、通用的浮动玻璃拟态卡片。
  • 禁止: 千篇一律的深紫/青色渐变配上随机的霓虹发光。
  • 禁止: 无意义的浮动环境粒子。
  • 禁止: 每个元素都使用相同的弹簧弹跳效果。
  • 禁止: 模糊的 SaaS 营销套话 ("Streamline your workflow")。请使用具体、明确的文案。

C. 运动物理与缓动

  • 绝对禁止线性运动: 除了用于持续的细微背景旋转或数字滚动条,禁止使用 ease: "none"。
  • 标准 UI 与运动曲线:
    • 入场: power3.out, expo.out, 或受控的 back.out(1.4) (绝不过度的卡通弹跳)。
    • 出场: power2.in 或 power3.in (出场必须比入场快)。
    • 切换: 共享方向动量 (例如,如果场景 A 向左移出,场景 B 应以匹配的速度从右侧进入)。

3. 五阶段生产套件

每当被要求创作或优化视频时,请按顺序执行以下阶段:

[第一阶段:创意简报] ➔ [第二阶段:HyperFrames 代码] ➔ [第三阶段:节拍同步音频] ➔ [第四阶段:预渲染门控] ➔ [第五阶段:渲染与交付]

第一阶段:创意简报与分镜

在编写动画代码之前,需确定:

  1. 目标: 宽高比 (16:9 横屏, 9:16 竖屏, 1:1 方形),时长 (宣传片通常 10–25 秒,解说片 30–60 秒),帧率 (30 或 60 fps)。
  2. 视觉锚点: 中心英雄元素 (例如,真实 UI 组件,动态标题,数据图表)。
  3. 调色板与字体: 1 种主背景色,1 种高对比度前景文字色,1 种锐利强调色。标题使用独特的显示字体。
  4. 分镜: 将时长分解为 3–5 个明确的场景,并附带精确的每秒时间戳。

第二阶段:HyperFrames 与 GSAP 代码编写

所有作品均位于 index.html 中,包含模块化场景。

HyperFrames 作品规则:

  1. 时间片段: 每个场景必须包含 data-start="<seconds>" 和 data-duration="<seconds>" 属性,并带有 class="clip"。
  2. 时间线注册: 在 window.__timelines 上注册 恰好一个 暂停的主时间线:
    window.__timelines = window.__timelines || {};
    const tl = gsap.timeline({ paused: true });
    window.__timelines["main"] = tl;
    
  3. 仅限确定性逻辑: 不得在动画循环中使用 Date.now(), Math.random() 或网络请求。
  4. 嵌套场景: 使用精确的位置参数将场景补间添加到主时间线:
    tl.add(scene1Timeline(), 0);
    tl.add(scene2Timeline(), 4.5);
    

第三阶段:音频与节拍同步

如果存在音乐或音效:

  1. 运行节拍检测:
    npx hyperframes beats
    
  2. 强提示点 (强拍与高潮点): 将主要场景切换和英雄元素揭示对齐到强提示点时间戳,偏差在 ±0.15 秒内。在代码中标记:// beat-locked: <timestamp>s。
  3. 顺序元素: 将卡片入场或列表项对齐到连续的节拍网格刻度 (±0.10 秒),前提是满足文本阅读速度要求。
  4. 音频响度: 最终音频必须符合网络标准 (-14 LUFS)。

第四阶段:确定性预渲染门控与认知质量检查 (npm run check)

这是强制性质量关卡。 在认为作品完成或渲染之前,必须执行:

npm run check

这会运行双层验证管线:

  1. 机械审计 (hyperframes check):

    • 代码检查: 语义结构和时序属性。
    • 运行时: 0 个控制台错误,0 个未定义变量,0 个失败资源加载。
    • 布局: 0 个屏幕外溢出或时间线查找不同步。
    • 运动: 时间线推进流畅,无冻结帧。
    • 对比度: 所有文本与其背景严格符合 WCAG AA 标准。
  2. 认知显著性与可读性门控 (scripts/cognitive_gate.py):

    • 可读性法则: 验证标签停留时间 $≥ 0.8\text{s}$,文案停留时间 $≥ 0.3\text{s/word}$。
    • 反套路审计: 禁止线性缓动和突兀的过渡。
    • 默认使用 Jev: 使用 Jev System 1 (typesafe-sdk),在约 210 毫秒内进行零幻觉概率判断 ($0.042/1M 输入,免费输出 Token)。
    • 优雅降级策略: 如果未设置 TYPESAFE_API_KEY 或 Jev 离线,套件永远不会崩溃或阻止项目。它会自动无缝地回退到确定性的本地启发式计算。

[!CAUTION] 如果 check 在对比度、布局或可读性停留时间上失败,请调整代码或时序以满足合规性,并重新运行直到所有检查通过。


第五阶段:视觉验证、渲染与海报输出

  1. 关键帧视觉快照:
    npx hyperframes snapshot
    
    检查提取的 PNG 帧,以验证构图平衡、安全边距和美学润色。
  2. 产品级渲染:
    npm run render
    # 或
    npx hyperframes render --quality high -o output.mp4
    
  3. 制作海报帧 (缩略图): 提取最稳定的英雄元素帧 (例如,在 3.2 秒处) 作为视频缩略图:
    ffmpeg -ss 3.2 -i output.mp4 -frames:v 1 -q:v 2 poster.jpg
    

4. 快速入门命令与 CLI 参考

目标命令
新建项目npx hyperframes init <project-name>
安装技能npx hyperframes skills
实时工作室预览npx hyperframes preview --background (持久) 或 npm run dev
停止预览npx hyperframes preview --stop
审计与验证npm run check
渲染 MP4npm run render
检测节拍npx hyperframes beats
本地 AI 配音npx hyperframes tts "<script>" --voice af_heart --output assets/vo.wav
检查关键帧npx hyperframes snapshot

5. 标准项目结构

my-video-project/
├── index.html          # 主作品 (HTML 结构 + GSAP 时间线)
├── hyperframes.json    # 尺寸 (width, height, fps, duration)
├── meta.json           # 项目元数据
├── package.json        # 锁定版本的 HyperFrames 依赖与脚本
├── assets/             # 音频、SVG 矢量、图片、字体
│   ├── music.mp3
│   └── logo.svg
└── output.mp4          # 最终渲染的视频

相关技能