Communitygithub.com

datassthou64-source/blue-motion-kit

将创作者的配音音频转化为基于研究的、视觉优先的HyperFrames动态图形。适用于当用户提供一个或多个音频文件,并要求转录、分析、研究概念或产品,构建或修改纯动态图形,本地预览,或以连续蓝色渐变风格渲染时。

blue-motion-kit 是什么?

这个技能(Blue Motion Kit)是一个专业化的AI辅助动态图形创作工具,专为将创作者的配音音频转化为基于事实的视觉解释而设计。其核心理念是“视觉优先,文本其次”——每个由配音提及的命名实体(公司、产品、网站等)都必须获得真实的、带来源的视觉资产(如官方标志、真实UI截图),避免使用通用图形或纯文本标签。该技能支持HyperFrames框架,能够在本地或CI/CD环境中工作,使用连续的蓝色渐变风格,并通过一系列严格的检查(如几何错误、帧快照审查)确保输出质量。工作流程包括音频转录、语义节拍提取、研究、故事板、模板适配、预览和渲染输出,与Premiere Pro和DaVinci Resolve兼容。它强调可重复性、文档化和团队协作,所有样式规则、陷阱预防和创作者信息都集中存储在库文件中,便于维护和更新。

兼容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/datassthou64-source/blue-motion-kit/tree/HEAD/.claude/skills/blue-motion

在你喜欢的 AI 中提问

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

文档

Blue Motion 动态图形

围绕配音构建基于事实的视觉解释。优先使用可识别的物体、产品UI语言、官方标志和变化,而非字幕或抽象文本卡片。

首先加载 /motion-visual-sourcing。它拥有本风格所依赖的两条法则——视觉优先,文本其次(删除所有文字,想法仍必须传达清晰)和每个命名实体都必须获得真实的、有来源的资产(为配音中提及的任何公司、产品、网站或仓库获取真实标志、实际UI或网站截图——绝不要使用通用盒子或纯文本名称)。本技能的蓝色渐变决定了外观,而这些法则决定了屏幕上显示的内容。

所有文件的位置

以下所有路径均相对于 KIT,即 blue-motion-kit 仓库的根目录。 bash <this skill folder>/scripts/kit-root.sh 会输出它(它能解析符号链接,因此无论本技能是从仓库加载还是通过链接加载,路径都是正确的)。

路径内容
library/design.md唯一的视觉规范——调色板、字体、物体、运动动词、诚实规则以及论点形状到场景的映射。在冲突时具有最高优先级。在制作故事板之前阅读。
library/scenes/13个来自已批准的Grok Bot构建的配置驱动模板。将 .html + .motion.json 复制到 compositions/ 中,并编辑其 <script> 顶部的 CFG 块;几何图形将从其中重新生成。
library/patterns/早期的静态基元。仍然有效。
library/PATTERNS.md两者的索引。
library/assets/logos/已冻结的、经过验证的官方标志(Grok、Grok Bot、xAI、X、Cursor、Claude、Slack、Instantly、HeyReach、HubSpot、GitHub…)。 SOURCES.md 是来源表。在获取之前先检查这里。
reference/grok-bot/已批准的参考构建:场景源文件、联系表和两个完成的渲染。可以查看,但不要整体复制。
brand/creator.md谁在看,以及创作者如何说话。
KIT/editor.local.md本机的编辑器偏好设置,来自首次运行访谈(项目文件夹、NLE、审批关卡)。如果存在则读取。
references/build-recipe.md(本技能)合成合同和通过 check 的bug。在编写或调试时阅读。
references/scene-patterns.md(本技能)非模板的手工构建设备。
scripts/(本技能)bootstrap-project.sh(新项目)、render_passages.py(导出)、hlg_to_sdr.py(HDR素材修复)、fetch-logo.py(标志解析器)、kit-root.sh。

模板提供了编排、缓动、调色板和寻址安全性。它不提供关于它对于这个节拍是否是正确想法的任何信息。更改文本和隐喻以匹配实际所说的内容;重新研究每个新命名的产品并使用其当前的官方资产。永远不要发布模板的占位符标记。

工作流程

  1. 阅读 brand/creator.md,如果存在则阅读 editor.local.md。

  2. 使用必需的 HyperFrames、动态图形、媒体使用和 CLI 技能。

  3. 只检查提供的音频。除非编辑明确要求重复使用,否则忽略该音频的先前工作。

  4. 搭建项目脚手架:bash SKILL_DIR/scripts/bootstrap-project.sh PROJECTS_DIR/<video-slug> AUDIO... (PROJECTS_DIR 来自 editor.local.md;默认为 KIT/projects)。它会复制启动器、渐变、标志和两个模板代,并打印每个音频文件的时长。

  5. 使用单词时间戳转录每个文件(npx hyperframes transcribe assets/audio-01.<ext> --dir . 或当前的媒体使用路径)。进行理智检查并纠正明显的专有名词错误(Clay、n8n、Instantly、HeyReach、Prospeo、Apify、Grok、Cursor、Claude Code、Codex、MCP)。

  6. 对于多个文件,保留原始文件并将其顺序放置在一条时间线上。使用 ffprobe 获取精确偏移。

  7. 将转录转换为语义节拍:时间范围、含义、视觉主题、动作和研究需求。

  8. 在绘制之前研究不熟悉的概念和当前的产品品牌。优先使用官方来源,将解析的资产保存在本地,并在 RESEARCH.md 中记录来源。标志:python3 SKILL_DIR/scripts/fetch-logo.py --manifest logos.txt assets/logos,然后打开它返回的每个文件。

  9. 在创作之前为整个音频制作故事板(STORYBOARD.md)。目标是每4-8秒一个完整的视觉场景。如果 editor.local.md 要求故事板签字批准,请在此处停止并展示它。

  10. 将蓝色渐变视频放在父时间线上,每个动态图形段落一个不中断的剪辑,并保持每个场景透明,这样背景就不会在剪切处重置。

  11. 适配语义上最小匹配的模式。不要仅仅因为模板存在而强行将主题塞入其中。

  12. 运行 npx hyperframes check,然后截取 每个 场景的回报帧并查看图像。几何错误——物体落在错误的坐标、一个元素滑过另一个元素——会通过 check 的静默检查,并且只会出现在帧中。

  13. 打开本地预览(npm run dev)并向编辑提供URL。在编辑明确批准之前不要渲染(除非 editor.local.md 设置为自动渲染)。

  14. 批准后,使用默认脚本导出。不要运行完整时间线渲染。

    python3 SKILL_DIR/scripts/render_passages.py PROJECT_DIR
    

    它会将每个动态图形段落渲染为 renders/MGNN-<label>.mp4。它会先将任何HLG素材转换为SDR,并检查每个文件是否为1920×1080、30 fps、帧计数、音频和SDR BT.709。然后它会写入 premiere-cuts.xml,该文件将每个文件放置在其在VO时间线上的实际位置(可导入Premiere Pro和DaVinci Resolve)。使用 --dry-run 列出段落,使用 --only 3,8 重新渲染某些段落,使用 --xml-only 重新构建XML。然后查看每个文件的一帧;脚本检查无法看到丢失的图层。详情及原因:references/build-recipe.md §7。

  15. 以简短的交接结束:项目路径、渲染文件、XML以及任何您无法验证的资产。

SKILL_DIR 是本技能的文件夹:KIT/.claude/skills/blue-motion。

速度和令牌纪律

  • 重用确切的渐变、风格令牌和经过验证的场景基元。
  • 仅研究影响事实视觉的名词:产品、标志、界面、工作流程或物理对象。
  • 对于简单事实,优先使用一个权威来源;仅在信息含糊不清时添加更多来源。
  • 保持 BRIEF.md、RESEARCH.md 和 STORYBOARD.md 简洁。
  • 重用笔记本电脑、仓库窗口、应用磁贴和路由的精确几何图形。
  • 显示快照或本地预览,而不是叙述CSS选择。

不可妥协的事项

外观和诚实规则在 library/design.md §9–10中:没有面部摄像头,没有字幕或文本卡片,1-3个单词的标签,板上的真实来源标记,以及没有任何伪造。除此之外:

  • 笔记本电脑屏幕保持接近16:9的比例,已固定的设备从不脉动或改变尺寸。
  • 移动物体连续运动。除非叙述描述停止,否则不要中途暂停。对于来回的想法,使用平滑的乒乓运动。
  • 使每个场景都有一个主导的视觉想法和清晰的状态变化,使用具体的动词:拆分、复制、同步、拉动、推送、搜索、组装、路由、解锁、比较、变换。

修改工具包本身

一个新的持久性规则(样式调用、默认资产、新的陷阱)应归入其唯一的存放位置——外观规则放入 library/design.md,陷阱/步骤放入本技能,创作者信息放入 brand/creator.md——绝不能放入项目的笔记或代理的内存中。然后提交它,以便每个编辑器都能获取到(参见工具包根目录的 CONTRIBUTING.md)。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能