Communitygithub.com

datassthou64-source/blue-motion-kit

两个法则,适用于每一个 HyperFrames 动态图形:(1) 视觉优先,文字其次;(2) 旁白中提到的每个具名实体都必须在屏幕上呈现真实、有来源的素材。用于构建或修改任何来自旁白的动态图形、故事板或节拍,当讲述者提到公司、产品、工具、网站或 GitHub 仓库时,当决定某行台词对应的屏幕内容时,当节拍偏离到文字卡片或项目符号列表时,或当需要获取 logo、产品 UI 或网站截图时。适用于所有 HyperFrames 工作流。

blue-motion-kit 是什么?

该技能为 HyperFrames 动态图形设计确立了核心视觉法则:视觉优先、文字其次,且旁白中的每个具名实体都必须有真实的屏幕素材支撑。它提供了从素材获取、验证到贴片构建的完整工作流指引,支持通过 `fetch-logo.py` 获取 logo 与 `npx hyperframes capture` 捕获网站/产品 UI。素材优先使用预先冻结的授权库,遵循由显式 URL → Wikipedia → 实际网站图标等优先级,且所有素材必须本地化存储并遵守合理使用规范。该技能适用于从故事板、选镜到构建与评审的每个环节,确保每个画面都靠视觉机制传递信息,而非依赖文字堆砌。

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

在你喜欢的 AI 中提问

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

文档

视觉优先。文字其次。每个名字都得有真实素材。

两条法则,适用于每一个节拍和每一个工作流。


法则一 — 视觉优先,文字其次

人们不读,他们扫视。 动态图形是一幅动起来的画,而不是带上动画的幻灯片。机制本身承载意义,文字只是给机制贴标签。

在制作之前,对每个节拍进行测试:

从画面中删除所有文字。这个想法还能站住吗? 如果不能,说明视觉还没做好 — 修复视觉,不要加文字。

文字是辅助元素。它只是命名观众正在看的东西,绝不能承载画面本身没有提出的主张。

该做的

  • 展示机制的运动过程:路由、变换、填充、计数、排序、汇聚、分支。
  • 使用真实的 logo、真实的产品 UI、真实的屏幕截图作为证据。
  • 每个主要对象配一个短标签 — 1–3 个词。
  • 只放一个核心数字,且仅当旁白提到它的时候。

不该做的

  • 把旁白直接粘贴到屏幕上。字幕最多两行,绝不能是段落。
  • 制作项目符号列表、议程卡或一大片文字卡片。列表应呈现为星座图或汇聚中心,而不是堆叠的子弹。
  • 因为想法很难可视化就使用文字卡片。越是这种时候越要努力构思视觉,而不是放弃并开始打字。
  • 让标签说一些画面机制没有展示的内容。

注意力分配比例: 大致将 80% 的构建精力放在动画对象上,20% 放在文字上。如果比例反了,说明这个节拍做错了。


法则二 — 每个具名实体都对应一个真实的、有来源的素材

当旁白提到任何在网上存在的东西 — 公司、产品、工具、网站、GitHub 仓库、模型、框架 — 去找到真实的东西并把它放在屏幕上。

具名实体就是证据。观众听到“Clay”并看到真实的克莱徽标时,他们才会相信你。观众听到“Clay”却只看到 Inter 字体拼出的“Clay”字样时,他们不会相信。

永远不要画一个通用盒子、凭空编造一个标志、凭记忆猜测 logo,或者当真实素材存在时只把名字显示成普通文本。

需要获取什么,按价值排序

提到的实体应获取的素材
公司或工具它的真实全彩色 logo 标识
带 UI 的产品该 UI 的真实截图,加上 logo
网站实际网站的抓取 — npx hyperframes capture <url>
GitHub 仓库仓库自己的头像/标识,以及 README 或仓库表面
模型/框架供应商的标识(Anthropic、OpenAI……)
人物只在提供素材的情况下使用。不要抓取他人的照片。

如何获取

首先检查冻结库。 经过验证的标识放在 library/assets/logos/(来源记录在其 SOURCES.md 中)。绝不要重新获取已经冻结并检查过的素材。

Logos — 使用解析器,不要手动查找:

cat > logos.txt <<'EOF'
clay      clay.com
anthropic wikipedia:Anthropic
linkedin  commons:LinkedIn icon
acme      https://acme.com/press/logo.svg
EOF
python3 KIT/.claude/skills/blue-motion/scripts/fetch-logo.py --manifest logos.txt <project>/assets/logos

优先级:显式 URL → Wikipedia → Wikimedia Commons → 网站自己的应用图标 → simple-icons → favicon。优先使用前四种;simple-icons 是单色的,大多数品牌风格要求全彩色。

网站和产品界面 — 抓取真实页面:

npx hyperframes capture https://<site> --json --max-screenshots 12

截图会以分层场景形式本地保存,并下载相关素材。将非零退出码、ok:false 或 BLOCKED.md 视为硬性停止信号 — 绝不要根据不完整的抓取来推断品牌的设计。

构建之前一定要验证 — 始终如此

  • 打开每一个返回的素材。 错误的 logo 比没有 logo 更糟糕。
  • 抓取工具会在文件小于 6 KB 时发出警告,并且 Commons 搜索可能返回近似但不准确的结果(错误的公司、旧标识、粉丝作品)。核实它们。
  • 优先使用当前标识。公司会重新品牌;Wikipedia 可能更新延迟。
  • 记录来源。fetch-logo.py 会自动将记录追加到 assets/logos/SOURCES.md — 保持它。

保持本地化和合法性

  • 将每个素材复制到片段的 assets/ 目录中。渲染时绝对不要使用 CDN 或网络连接。
  • 第三方标识的使用属于指称性使用 — 用于指向正在讨论的对象。不要重新设计 logo、暗示背书或将标识用作自己的品牌。
  • 如果找不到或无法验证真实素材,请说明情况,改用对象类别的视觉替代。不要为了填补空白而编造一个标识。

这些法则在工作流中的体现

  1. 选镜 — 对于每一个窗口,记录 这行台词命名了哪些实体。该列表就是获取清单。一个窗口命名了实体但没有规划素材,就是不完整的选镜。
  2. 故事板 — 每一帧都要陈述其视觉主旨以及所需的具体素材。如果一帧的主旨只能用屏幕上的句子来表达,请重新构思这一帧。
  3. 构建 — 素材放入 assets/,本地引用,目视验证。
  4. 评审 — 眯着眼看快照。如果只有通过阅读才能知道这个节拍想表达什么,就违反了法则一。如果某个知名品牌显示为纯文本,就违反了法则二。

品牌风格依然优先

这些法规定义了什么上屏幕。如何展示则由 library/design.md 决定:获取真实素材,然后用品牌风格(放在盘子上、在深池晕影下、在玻璃卡片内)进行布置。

Individual skills in this repo

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

相关技能