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外部依赖
| 类型 | 依赖 |
|---|---|
| package | 兄弟 skill：animation-principles（三支柱 / 三层运动 / 1-3 规则）与 motion-art-direction（Motion Personality 预设）——均属 iart-ai/motion-design-skills 仓库 |
| package | spring(stiffness, damping) 令牌（实现侧能力，文档只给命名位） |
4风险提醒 风险提醒：绿色 · 放心使用
风险提醒：绿色 · 放心使用
- 跨仓引用悬空 — 上游理论（animation-principles / motion-art-direction）在另一仓库；只装 freelance pack 时引用解析不到，使用者需要自行补装或内联最小词汇表（见 second_pass discrepancy）。
- 令牌数值是通用起点而非品牌结论 — instant 100 / base 250 / slow 400ms 等是当代产品 UI 的通行区间；若品牌基调偏戏剧化或偏工业风，需要按 Motion Personality 重算，文档虽提示但未给换算规则。
- 合规性条款无标准出处 — 光敏阈值、reduced-motion 要求等未标 WCAG 条款；面向强监管行业（广播、医疗、教育）时需另行对照当期标准与本地法规。
- 产出是文档，落地仍靠人/工程 — skill 只保证规范的完整性与可实现表述，不校验代码是否真的使用令牌；若无配套评审机制，规范仍可能被一次性数值绕过（文档把它列为常见错误并给修法，但不提供工具）。
风险提醒：绿色，放心使用。纯指令/文档方法论：无脚本、无可执行文件、无网络外发、无凭证读取、无落盘动作，产出是填空式规范文档。注意点（不改档位）：① 它引用姊妹 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结论
适合：适合需要把「品牌怎么动」写成可评审文档的场合：新建品牌动效系统、统一多团队/多产品的动作语言、为设计系统补 motion token、给产品与市场对齐动作基调，或为无障碍评审补 reduced-motion 与光敏条款。也适合接单时作为交付物之一（配合 freelance pack 的其他 skill 使用）。
不适合：不适合：① 只想要某个具体动作的实现代码（应走 animation-principles / gsap-web / remotion-video 等）；② 需要判断层的创意方向与个性预设细节（应走 motion-art-direction，本文档只引用）；③ 只装 freelance pack 且无同作者另一 pack 的场景——上游理论引用会悬空；④ 需要合规级可访问性认证（本文档是工程规范，不是合规报告）。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-28
方式 A · 人下载镜像包下载 brand-motion-guidelines.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent9ea95c6713578b29…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库iart-ai / iart-ai/freelance-motion-skills
原始 GitHubiart-ai/freelance-motion-skills ↗
Stars3
最近推送2026-06-22
本 skill commit
d85c2b4846许可MIT（仓库根 LICENSE：'MIT License' / Copyright (c) 2026 iart.ai；.claude-plugin/plugin.json 的 license 字段亦为 MIT）
本站信息
收录日期2026-09-06
分类设计
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。