1实现原理 · 为什么它能做到

产出是一份「填空即用」的品牌动效规范文档，固定七段并按序撰写（原则 → 令牌 → 动作库 → logo 规则 → 状态反馈 → 无障碍 → do/don't）。

skills/brand-motion-guidelines/SKILL.md

A complete motion guidelines doc has seven parts. Author them in order:

这里在做什么：把「写规范」从自由文体变成有骨架的交付物；顺序本身也是纪律——令牌必须在动作库之前定，否则动作库会退化成一次性数值。

先做规模判断再动手：一个站/一次活动走轻量版，产品走完整七段，跨产品+市场+广播则再加 Motion Personality 预设。

skills/brand-motion-guidelines/SKILL.md

How many surfaces/teams will use this?

这里在做什么：避免「给落地页写七段体系」或「给多团队设计系统写一页纸」两种错配；判断题的另一半是「某个动作该用哪个令牌」。

令牌命名必须语义化（按用途而非字面值），使数值可演进而不引发全局改名。

skills/brand-motion-guidelines/SKILL.md

| Token values renamed constantly | Names are literal (`duration-250`) | Name by purpose (`duration-base`) so values can change |

这里在做什么：这是让规范可被工程实现的关键一步——组件与动作库都引用令牌，改值只需改一处；同类推理还用于「一切动作都要能报出它用的令牌，否则就是一次性数值」。

进出场不对称与 stagger 上限被写成默认规则：出场比入场短、交错 30-50ms。

skills/brand-motion-guidelines/SKILL.md

Default rule: exits are shorter than entrances; staggers use small offsets (30-50ms) so groups feel alive without dragging.

这里在做什么：把动画直觉固化成可核查条款，并解释理由；下游「动作库」表里每个 pattern 都要绑定令牌组合。

无障碍是必需段落而非附录：reduced-motion、光敏阈值、焦点可见、禁止仅靠颜色或动作表意。

skills/brand-motion-guidelines/SKILL.md

- **Photosensitivity**: no more than 3 flashes per second; avoid full-screen high-contrast strobing.

这里在做什么：把可访问性写成规范的一部分（并与 loading/success/error 反馈规则联动：状态必须配文字或图标），同时给出 reduced-motion 的替代策略（换成淡入或即时切换）。

「vibes 式规范」被当作反例：形容词无法实现，必然导致产品内不一致。

skills/brand-motion-guidelines/SKILL.md

Why it fails: no named tokens, no values, no entrance/exit rule, nothing implementable — "smooth" and "snappy" contradict and every engineer interprets them differently

这里在做什么：用反例锁死输出标准（原则要带数值规则、do/don't 要带具体毫秒），这也是它把「常见错误 → 修法」做成清单的原因。

定位是 system-of-record：上游理论（三支柱、三层运动、1/3 规则）与个性预设分别由两个兄弟 skill 提供，本文档只引用不复制。

skills/brand-motion-guidelines/SKILL.md

This doc is the *system-of-record* for a brand's motion; two sibling skills supply the upstream theory and the per-project feel — reference and apply them, don't duplicate their tables:

这里在做什么：明确跨 skill 分工，防止同 pack 内出现三份互相漂移的令牌/曲线表；代价是这条引用跨仓库（见 second_pass）。

模板以可填空文的形式内嵌在 SKILL.md（含版本号、owner、八个分段与 ✅/❌ 占位）。

skills/brand-motion-guidelines/SKILL.md

8. DO / DON'T

这里在做什么：让 agent 直接产出客户可评审的文档骨架，reference/full-template.md 再提供展开版与示例文案。

2核心能力

01七段式规范骨架（原则/令牌/动作库/logo/状态/无障碍/do-don't）

02时长令牌表（instant 100 → slower 600ms）与缓动令牌表（standard/decelerate/accelerate/emphasized/spring 的 cubic-bezier）

03动作库：把入口/出口/过渡/交错等 pattern 逐个映射到令牌组合

04logo 动效规则：可用与「绝不」清单（不拉伸、不自由旋转、不随意改色、不每次出场都动）

05状态与反馈动效：loading/success/error/hover/focus 的规则与「不靠颜色或动作单传信息」

06无障碍章节：reduced-motion 替代策略、光敏阈值、焦点可见性

07常见错误→修法表（7 条症状处方）与交付 checklist（9 条自查）

08可填模板（版本/owner/八段与 do-don't 占位）+ 三本 reference 的展开版

3外部依赖

Kind	Dependency / Endpoint
package	兄弟 skill：animation-principles（三支柱 / 三层运动 / 1-3 规则）与 motion-art-direction（Motion Personality 预设）——均属 iart-ai/motion-design-skills 仓库
package	spring(stiffness, damping) 令牌（实现侧能力，文档只给命名位）

4管控建议与判定依据

建议配套管控措施

面向 Agent

可自动加载

面向管理者

登记来源与版本

判定依据（文件路径与关键语句摘要）

SKILL.md: 纯提示词指令与规则文本，无脚本执行与外部影响

审计说明： 。纯指令/文档方法论：无脚本、无可执行文件、无网络外发、无凭证读取、无落盘动作，产出是填空式规范文档。注意点（不改档位）：① 它引用姊妹 skill（animation-principles / motion-art-direction）作为上游理论，二者属另一个仓库（iart-ai/motion-design-skills），只装本 pack 时引用无法解析（见 second_pass）；② 文档含品牌取向建议（克制、少弹、进出场不对称），属审美锚定而非风险。

5第二遍独立确认

[ok] 是否存在任何脚本或可执行片段 — 全目录只有 Markdown；代码块仅含 cubic-bezier 值、spring(stiffness, damping) 这类命名占位与模板文本，无 shell/JS 可执行语句。
[discrepancy] 跨仓引用的两个兄弟 skill 是否能解析 — SKILL.md 的 Related frameworks 要求引用 animation-principles 与 motion-art-direction，但这两个 skill 属 iart-ai/motion-design-skills（另一仓库、另一 pack）。只安装 freelance-motion-skills 时引用悬空（文档既未标注需另装，也未内联最小词汇表），实际使用需同时装 motion pack。
[unlocatable] 无障碍与光敏阈值等条款是否有出处 — 「≤3 次闪光/秒」「聚焦指示不可被动画隐藏」等属通用可访问性实践（对应 WCAG 类准则），但 pin 仓库内未给标准编号或链接；作为文档声明记录，合规场景应自行对照当期 WCAG。
[ok] 「输出是文档不是代码」是否与全文一致 — SKILL.md 在 When to use、常见错误表与交付 spec 三处均强调产出为 structured document；令牌表里的 cubic-bezier 是内容而非实现代码，与声明一致。

6结论

把「品牌动效规范」做成可执行交付：七段骨架 + 令牌表 + 动作库映射 + checklist，写完与否可判定

令牌化命名（按用途而非字面值）解决了规范落地最常见的失败模式——值一改就全局改名

无障碍被写成必需段落并与状态反馈联动（状态必须配文字/图标，不能只靠颜色）

用反例（vibes 式规范）锁死质量标准，避免产出无法实现的形容词文档

明确自己是 system-of-record，理论表交给上游 skill，避免同 pack 内多份漂移的令牌/曲线表

适合： 适合需要把「品牌怎么动」写成可评审文档的场合：新建品牌动效系统、统一多团队/多产品的动作语言、为设计系统补 motion token、给产品与市场对齐动作基调，或为无障碍评审补 reduced-motion 与光敏条款。也适合接单时作为交付物之一（配合 freelance pack 的其他 skill 使用）。

不适合： 不适合：① 只想要某个具体动作的实现代码（应走 animation-principles / gsap-web / remotion-video 等）；② 需要判断层的创意方向与个性预设细节（应走 motion-art-direction，本文档只引用）；③ 只装 freelance pack 且无同作者另一 pack 的场景——上游理论引用会悬空；④ 需要合规级可访问性认证（本文档是工程规范，不是合规报告）。

Install Agent-Ready

① Verified Mirror 2026-09-28

Option A · Direct DownloadDownload brand-motion-guidelines.tar.gz

sha256: 9ea95c6713578b29…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit d85c2b4846.