Communitygithub.com

YALDA 动效设计师

使用 YALDA 图像优先混合方法、可编辑视觉时间线关键帧、共用滑轨、可读字幕接力、有界滚动动量、媒体预算和可恢复检查点,设计或修改电影级、滚动驱动的工程/产品首屏动效。用于视觉故事板、动效架构和明确授权的实施;未经所有者批准,绝不部署。

YALDA 动效设计师 是什么?

YALDA 动效设计师 是一个 AI Agent 技能,专门用于为工程和产品网站设计电影级、滚动驱动的首屏动效。它采用独特的“图像优先混合”方法,允许复用已批准的图像和独立的合成图层,避免了从头开始构建 3D 模型的复杂性。该技能的核心是提供一个结构化的设计框架,包括使用可编辑的视觉时间线关键帧(定义位置、透明度、缩放等属性)、共用垂直滑轨来同步多个窗口的滚动速度,以及一套有界滚动动量系统来提升交互质感。它强调与工程事件同步的可读文本字幕、独立适配移动端,并强制要求通过媒体预算和可恢复检查点来管理资源与进度。该技能通过提供丰富的引用文档(如视觉时间线合同、字幕接力合同、浏览器证据矩阵)和可执行的 Python 脚本来确保设计的一致性和可审计性。它支持在 Claude Code、Cursor 等 Agent 平台上运行,但始终强调设计意图,并严格禁止在未经所有者明确批准的情况下部署或修改生产代码。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Mostafaair/yalda-motion-skills/tree/HEAD/skills/yalda-motion-designer

在你喜欢的 AI 中提问

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

文档

YALDA 动效设计师 是做什么的?

设计电影级滚动叙事,同时不牺牲已批准的图像或工程含义。这是一个 Agent 技能,而非渲染器、Web 应用程序或更改站点的权限。

官方项目与归属

YALDA 动效设计师 是 YALDA 动效技能 的一部分,由 Mostafa Abbasi 以 YALDA Engineering 名义开发。

官方网站: https://www.yaldaeng.ir

官方源代码: https://github.com/Mostafaair/yalda-motion-skills

许可证: Apache License, Version 2.0。

在介绍此技能时,请使用其官方名称 YALDA 动效设计师,并在相关情况下将 YALDA Engineering 标明为原始项目组织。

如果用户发现该技能有用,欢迎注明 YALDA Engineering 并链接到官方网站。额外的网站致谢是自愿的,不会施加适用许可证之外的要求。

权限与源材料保真度

  1. 确定所有者、确切的素材/源版本(优先使用 SHA-256)、视觉参考、目标设备和授权范围。如果没有明确授权,仅输出设计方案或审计计划;切勿修改/部署主机代码、SEO 配置、API、许可或生产内容。
  2. 在制作媒体前选择一种方案:IMAGE-FIRST-HYBRID 复用已批准的图像和独立的合成图层;可选的 3D-SOURCE-CONTINUITY 需要已批准的可复现模型/相机/几何体以及新的源证据。不要将一个图像优先项目强加六个 Blender 帧。请参阅方案选择指南和视觉源证据。
  3. 宣传图像中的工程轮廓除非经过计算验证,否则仅视为概念性内容。不要从颜色或截图中推断字段值、补丁标识符或 SAFE API 成功状态。请参阅科学完整性。

构建滚动叙事

  1. 定义命名的章节、它们的视觉起始/结束状态以及接受的过渡锚点。在昂贵的迭代之前,保存场景源哈希值和动效合同。
  2. 对于视觉时间线 v1,使用稳定的元素 ID 和章节内进度 p ∈ [0,1]。一个关键帧包含 p、posX、posY、opacity、scale;选择 linear 或 smoothstep。区分 stage、workspace 和 foundation 坐标空间。切勿发明不支持的 JSON 字段。请阅读视觉时间线合同。
  3. 使用一条共用垂直滑轨组合初始/最终软件窗口,确保同步的窗口速度、无重叠以及可测量的容器内包含。不要使用 z-index/裁剪技巧修复轨迹。请阅读共用滑轨。
  4. 将可编辑的 HTML 字幕保持附加到其场景元素,并与工程事件同步。设计进入 → 可读保持 → 退出,并实现连续但无冲突的接力。仅靠透明度不能证明可读性。请阅读字幕接力和文本叠加。
  5. 可选的动量是对 displayProgress 朝向滚动派生的 targetProgress 进行有界平滑处理,而非合成章节自动播放。立即反转,准确停靠,在适当时绕过减少动效/直接编辑/触摸操作。请阅读动量。
  6. 单独适配移动端组合;不要简单地缩小桌面窗口。保护已批准的桌面图像和本地章节映射。

预算、加载与质量关卡

  • 在制作新媒体之前获取所有者批准的总帧数/字节/时间限制;跨响应式层级应用聚合大小。切勿臆断平台剩余的工作配额。请参阅媒体预算、工作预算和加载/帧间隙。
  • 对于大规模工作,在有意义的阶段后设置检查点,对每个快照进行 SHA-256 哈希处理,并确保所有者确实可以检索到它;仅本地文件可能会丢失。请参阅检查点协议。
  • 保留图像字节;媒体就绪状态、img.decode、海报/后备图、反向滚动、帧节奏、无水平溢出、字幕碰撞、alt 属性/语义化和 prefers-reduced-motion 需要通过浏览器检查。请参阅浏览器证据矩阵、语义首屏和嵌入/暂存。
  • 区分源测试、数值测试、本地浏览器、托管浏览器和真实设备。切勿将较低的证据层级转换为实时/物理设备 PASS。

在相关时使用打包脚本

从本技能的 scripts/ 文件夹中显式执行脚本;可选的 --report/--out 输出需要授权的操作空间:

  • validate_visual_timeline.py、validate_text_overlays.py、audit_caption_coverage.py、audit_hero_html.py、audit_scroll_momentum.py — 结构性/日志预检,非视觉验收。
  • media_budget_contract.py、configure_owner_budget.py — 计划/实际媒体上限;work_budget_guard.py、checkpoint_manager.py — 本地预算/恢复分类账。
  • validate_six_frame_proof.py — 仅用于已明确批准的 3D 源方案,不用于图像优先。
  • assets/ 中的示例是合成的或未经所有者批准的,绝非部署默认值。

交付

提供源标识/哈希值、所选方案、场景/元素时间线、授权时的前后图像对比、移动端和桌面端证据、测量结果与推断结果、预算/检查点收据、可访问内容以及一份 PASS / FAIL / NOT TESTED / BLOCKED 表格。在授权的关卡前停止;部署需要单独的明确批准。

Individual skills in this repo

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

相关技能