1仕組みと動作原理
成果物は「空欄を埋めるだけですぐに使える」ブランドモーション規約ドキュメントであり、所定の7セクションを順序通りに執筆します(原則 → トークン → モーションライブラリ → ロゴルール → 状態フィードバック → アクセシビリティ → Do/Don't)。
A complete motion guidelines doc has seven parts. Author them in order:
着手前に規模を判定:単一サイトや単発キャンペーンは軽量版、プロダクト全体は完全な7セクション構成、複数プロダクト+マーケティング+配信をまたぐ場合は Motion Personality プリセットを追加します。
How many surfaces/teams will use this?
トークン命名は必ずセマンティック(リテラル値ではなく用途ベース)にし、値が変更されても全体のリネームが発生しないようにします。
| Token values renamed constantly | Names are literal (`duration-250`) | Name by purpose (`duration-base`) so values can change |
イン/アウトの非対称性とスタッガーの上限をデフォルトルールとして定義:退場は入場より短く、スタッガーは30〜50msに設定します。
Default rule: exits are shorter than entrances; staggers use small offsets (30-50ms) so groups feel alive without dragging.
アクセシビリティは付録ではなく必須セクション:reduced-motion、光過敏性閾値、フォーカス可視性、色や動きのみによる情報伝達の禁止を含みます。
- **Photosensitivity**: no more than 3 flashes per second; avoid full-screen high-contrast strobing.
「フィーリング重視の曖昧なガイドライン」をアンチパターンとして排除:形容詞だけでは実装できず、プロダクト内の不整合を招きます。
Why it fails: no named tokens, no values, no entrance/exit rule, nothing implementable — "smooth" and "snappy" contradict and every engineer interprets them differently
system-of-record(正統な記録システム)として位置付け:上流理論(3つの柱、3層の運動、1/3ルール)やパーソナリティプリセットは兄弟スキルから提供され、本文書では参照のみ行い重複定義は避けます。
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.md 内に穴埋め可能なテンプレートを直接内包(バージョン番号、オーナー、8つの区分、✅/❌ プレースホルダーを含む)。
8. DO / DON'T
2コア機能
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推奨統制措置と判定根拠
- SKILL.md: プロンプト指示およびルールテキストのみで構成され、スクリプト実行や外部への副作用はありません
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結論
9ea95c6713578b29…