mcpField
M
motion-video

motion-video

github.com/bestagentkits创意与媒体130155 次安装5 周前更新
代码仓库

关于 motion-video

用于制作脚本化动态图形视频的技能,涵盖节拍同步剪辑、语词同步揭示和音频质量测量。它提供两种视觉风格参考及从素材到渲染的制作流程。

主要功能

  1. 01两种视觉风格参考
  2. 02脚本化视频制作流程
  3. 03节拍网格拟合与音乐拼接
  4. 04语音对齐与混音测量
  5. 05检查、快照与渲染验证

适用场景

  1. 01制作新的动态图形视频
  2. 02为现有视频另建项目改换风格
  3. 03调整音乐节奏或音频混音
  4. 04渲染并编码社交视频

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/bestagentkits/motion-video-skill --skill motion-video

安装后在 Claude Code 中输入/motion-video确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/templates/
hyperframes.json
index-skeleton.html
assets/templates/data/
cues.example.json
music-arrangement.example.json
music-plan.example.json
outro-plan.example.json
script.example.json
sfx.example.json
assets/templates/scripts/
align-voiceover.mjs
arrange-music.mjs
build-timeline.mjs
generate-audio-assets.mjs
references/
audio-and-beat-sync.md
composition-contract.md
production-pipeline.md
style-comic-spiderverse.md
style-glass-keynote.md
scripts/
fit-beat-grid.py
measure-mix-balance.py
verify-arrangement.py
scripts/tests/
test_audio_tools.py

详细介绍

动态视频

制作一个 1920×1080、30 fps 的动态图形视频,让场景切换精准落在音乐节拍上,让内容揭示与口播词语同步,音频达到广播级清晰度。整个工作流完全通过脚本完成:事实 → 脚本 → multix 音频 → 强制对齐 → 节拍网格 → 按小节拼接音乐 → 时间线 + 混音 → HTML 合成 → lint/check/快照 → 渲染 → 重封装 → 社交媒体编码。

两个成片版本展示了各自风格应有的感觉。这里不会刻意打包它们的工作项目:生成的配音、音乐和音效文件体积较大,且受服务提供方许可限制。先研究已发布的演示,再根据 assets/templates/index-skeleton.html 和风格参考制作每个新视频。

风格风格参考公开演示感觉
漫画多元宇宙references/style-comic-spiderverse.mdDewee v3.34 漫画版,151 s 社交媒体编码版喧闹、有趣、手工感
玻璃主题演讲references/style-glass-keynote.md同一作品的 144 s 版本高端、沉稳、清晰

范围

此技能适用于:

  • 使用任一风格制作新视频、将现有视频改编成另一种风格并作为独立项目保存,以及部分返工(更换音乐、重新定时高潮段、重新混音、重新渲染、社交媒体编码)。
  • 通过 multix CLI 处理音频:Gemini TTS 配音、ElevenLabs 音效、ElevenLabs 音乐创作方案、ElevenLabs 强制对齐。

此技能不适用于:

  • 生成式文生视频素材(直接使用 multix Seedance/Veo)。
  • React/Remotion 合成或通用 HyperFrames 问题(使用 hyperframes 或 remotion 技能)。
  • 向社交账号发布内容:生成文件后由用户自行发布。

工作方式

  1. 操作文件前先确定目标:主题与来源、风格(从两种风格中选择,或以它们为基础创建新风格)、时长、配音语言(默认英文配音 + 越南语字幕)、结尾、标志。只有在风格或事实来源不明确时才提问。
  2. 创建 assets/videos/<slug>/(绝不覆盖已完成的版本),并按照仓库约定在 plans/ 下创建计划。复制此技能的 assets/templates/ 中的模板:scripts/*.mjs、data/*.example.json(重命名为 .json)、hyperframes.json、将 index-skeleton.html 另存为 index.html,以及 scripts/fit-beat-grid.py。
  3. 按照 references/production-pipeline.md 逐步执行。每一步都会写入下一步要读取的文件,因此不要调整顺序。
  4. 按照 references/audio-and-beat-sync.md 做好音乐:拟合节拍网格,拼接小节,让高潮段落落在脚本需要的位置,验证拼接效果,并测量配音与音乐的平衡。
  5. 根据 references/composition-contract.md 和所选风格参考,从 assets/templates/index-skeleton.html 开始构建 index.html。对于重复出现的场景类型(数据、示意图、图表、终端、图形、片尾),应遵循演示中该场景的编排方式,而不是另创一种。
  6. 只有在“完成标准”中的每项检查都通过后才算完成;报告测量数值,而非主观印象。

凭据仅保留在 multix 自身的配置中。绝不打印 API 密钥,也不要将其复制到项目文件、计划或报告中。

完成标准

  • hyperframes lint 和 check 均通过;已审阅每个场景的快照。
  • verify-arrangement.py 报告每个片段的偏差均在 ±2 ms 以内,且 measure-mix-balance.py 显示音乐音量比语音低约 4–6 dB。
  • ffprobe 检查结果:1920×1080、30 fps、时长符合预期、AAC 48 kHz 立体声;ebur128 约为 −14 LUFS,峰值 ≤ −1 dBFS;blackdetect 检查确认淡入淡出之外没有黑屏。
  • build-timeline 未输出任何片段、重叠或缺失单词警告。
  • 屏幕上显示的事实均可追溯到步骤 1 中收集的来源。

资源

  • references/production-pipeline.md:从脚手架搭建到社交媒体编码和工作室预览的所有命令,以及重建表。
  • references/audio-and-beat-sync.md:配音、音效提示、音乐方案、小节拼接编排、锚点、混音数值和闪避处理的陷阱。
  • references/composition-contract.md:TIMING 结构、辅助函数、确定性、场景时间窗口、字幕、吉祥物、渲染器限制、签名。
  • references/style-glass-keynote.md / references/style-comic-spiderverse.md:每种风格对应的设计令牌、字体、图层、组件、转场和字幕外观。
  • scripts/fit-beat-grid.py <music> [--min-bpm N --max-bpm N]:BPM、BEAT0 和逐小节的鼓点/能量表。
  • scripts/verify-arrangement.py <project> [--tolerance-ms 2]:每个片段的拼接延迟;发生偏移时以状态码 1 退出。
  • scripts/measure-mix-balance.py <project>:根据 build-timeline.mjs --stems 测量语音下方与间隙中的音乐音量。
  • scripts/tests/:python -m unittest discover -s scripts/tests(需要 ffmpeg、numpy、scipy)。
  • assets/templates/:项目脚本(generate-audio-assets、align-voiceover、arrange-music、build-timeline)、示例数据文件和合成骨架。

评论

支持 Markdown