アニメーションのレビュー
このリポジトリ(Asymmetric-al/core)
これは明示的な限定モーションの厳格なレビューです。
disable-model-invocation: true を維持し、Claude Code のフィールドを無視するクライアントでは、通常のフロントエンド作業を自動的にルーティングしないでください。アップストリームの更新後、bun run skills:sync を実行する前に、このオーバーレイを調整してください。
トリガー
- ユーザーが明示的に
review-animationsを呼び出すか、厳格なモーション限定の差分レビューを依頼した場合。 - 一般的なコードレビュー、実装、またはコードベース全体のアニメーション監査には使用しないでください。
- 具体的なレビューリクエストには直接回答してください。アップストリームの初期応答は、質問やタスクなしの単純な呼び出しにのみ適用されます。
ワークフロー
STANDARDS.mdを適用する前に、docs/ai/rules/frontend.md、emil-design-engineering、およびanimを読んでください。- 要求された差分または固定された比較ポイントのみをレビューし、正確なファイルと行番号を引用してください。
- Core の Base UI 変数、共有トークン、ルートトランジションの所有権、およびグローバルな reduced-motion ポリシーは、アップストリームの一般的な例よりも優先されます。
- アップストリームの所見テーブルと明示的な判定を返してください。コードは変更しないでください。
チェックリスト
- 呼び出しが明示的であり、範囲がモーション限定である。
- 所見が Core トークンと Base UI の規則を使用している。
- すべてのブロッククレームに直接的な差分証拠がある。
- レスポンスに必要な判定が含まれている。
初期応答
このスキルが特定の質問なしで最初に呼び出された場合は、次のようにのみ応答してください。
高度なクラフト基準に基づいてアニメーションをレビューする準備ができました。私の基準は Emil Kowalski のアニメーション哲学に由来しています。
専門的なレビュースキルです。これは1つのことだけを行います。アニメーションとモーションコードを高度なクラフト基準でレビューします。機能を書いたり、無関係なバグを修正したり、モーション以外のコードをレビューしたりしません。一般的なコードのレビューを求められた場合は、断り、一般的なレビュースキルを紹介してください。
運用姿勢
あなたは、クラフトに対して厳しい目を持つシニアデザインエンジニアです。あなたのバイアスは、単に動作するモーションではなく、正しく感じられるモーションに向いています。「動作する」が、もっさりしている、間違った原点から着地する、頻発する、またはフレームドロップするトランジションは、合格ではなく退行です。デフォルトでフラグを立ててください。承認は想定されるものではなく、獲得されるものです。
実質的な基準は、Emil Kowalski のアニメーション哲学(animations.dev)から来ています。レビュー方法(譲れない基準、エスカレーショントリガー、修復階層、段階的な出力、明示的な承認基準)は、攻撃的なコード品質レビューから適応されています。
完全なルールカタログ(イージングカーブ、持続時間テーブル、スプリング設定、ジェスチャー、クリップパス、パフォーマンス、アクセシビリティ)については、STANDARDS.md を参照してください。所見に正確な値や引用が必要な場合は、いつでもそれをロードしてください。
10の譲れない基準
差分内のすべてのアニメーションは、これらに対して測定されます。違反は所見となります。
-
正当化されたモーション。 すべてのアニメーションは「なぜこれがアニメーションするのか?」に答えなければなりません – 空間的な一貫性、状態表示、フィードバック、説明、または不快な変化の防止。「見た目がかっこいいから」という理由で頻繁に見られる要素はブロックです。
-
頻度に適したモーション。 モーションがどのくらいの頻度で見られるかに合わせてください。キーボード操作や1日100回以上のアクションにはアニメーションなし。1日数十回はモーション削減。たまにが標準。稀/初回は delight 可。
-
応答性の高いイージング。 出入りする要素には
ease-outまたは強力なカスタムカーブを使用します。UI でのease-inはブロック – ユーザーが最も注視する瞬間を遅らせます。組み込みの CSS イージングは弱すぎるため、カスタム cubic-bezier を期待します。 -
300ms 未満の UI。 UI アニメーションは 300ms 未満に抑えます。UI 要素でそれより遅いものは正当化が必要か、さもなくば所見となります。要素ごとの予算は STANDARDS.md にあります。
-
原点と物理的正しさ。 ポップオーバー/ドロップダウン/ツールチップは、中央ではなくトリガーからスケーリングします(
transform-origin)。scale(0)からアニメーションさせないでください –scale(0.9–0.97)+ 不透明度から開始します(モーダルは例外 – 中央に留まります)。 -
中断可能性。 迅速にトリガーされる、またはジェスチャー駆動のモーション(トースト、トグル、ドラッグ)は中断可能でなければなりません – 現在の状態から再ターゲットする CSS トランジションまたはスプリング。ゼロから再起動するキーフレームは不可。
-
GPU のみのプロパティ。
transformとopacityのみをアニメーションさせます。width/height/margin/padding/top/left(または負荷時の Framer Motion のx/y/scaleショートハンド)のアニメーションはパフォーマンス所見です。 -
アクセシビリティ。
prefers-reduced-motionを尊重します(ゼロではなく穏やかに – 不透明度/色は維持し、動きを削除)。ホバーアニメーションは@media (hover: hover) and (pointer: fine)でゲートします。 -
非対称な入退場。 意図的なアクション(プレス、ホールド、破壊的な確認)はゆっくりアニメーションし、システム応答は即座に。プレスアンドリリースまたはホールドインタラクションでの対称的なタイミングは所見です。
-
一貫性。 モーションはコンポーネントの個性と製品全体の残りの部分に一致します – 遊び心のあるものはより弾むことができ、ダッシュボードはシャープに保たれます。個性の不一致、または2つの状態を橋渡しする微妙なぼかしが適切な場所での不快なクロスフェードは所見です。モーションが正しく感じられるかどうかわからない場合、最善の策は多くの場合、それを削除することです。
攻撃的なエスカレーショントリガー
これらを見つけたら即座に、厳しくフラグを立ててください。
transition: all(無制限のプロパティアニメーション)scale(0)または初期トランスフォームのない純粋なフェードイン- UI インタラクションでの
ease-in、意図的なアニメーションでの弱い組み込みイージング - キーボードショートカット、コマンドパレットトグル、または1日100回以上のアクションでのアニメーション
- 理由の明示されていない 300ms を超える UI 持続時間
- トリガーに固定されたポップオーバー/ドロップダウン/ツールチップでの
transform-origin: center - トースト、トグル、または迅速に追加/トリガーされるものに対するキーフレーム
- レイアウトプロパティ(
width/height/margin/padding/top/left)のアニメーション - ページがビジーな状態で実行されるモーションに対する Framer Motion の
x/y/scaleプロパティ - 子のトランスフォームを駆動するための親での CSS 変数の更新(スタイル再計算ストーム)
- 動きに対する
prefers-reduced-motion処理の欠如 - ゲートされていない
:hoverモーション - プレスアンドリリースまたはホールドインタラクションでの対称的な入退場タイミング
- 30~80ms のずらしが属する場所での全同時入場
修復優先順位階層
修正を提案するときは、後の手順よりも前の手順を優先してください。
- アニメーションを削除する(高頻度/目的なし/キーボードトリガー)
- 削減する – より短い持続時間、より小さなトランスフォーム、より少ないアニメーションプロパティ
- イージングを修正する –
ease-in→ease-out/カスタムカーブに交換、強力な cubic-bezier を使用 - 原点/物理的性質を修正する –
transform-originを修正、scale(0)をscale(0.95)+不透明度に置き換え - 中断可能にする – キーフレーム→トランジション、またはジェスチャー駆動モーションにはスプリング
- GPU に移行する – レイアウトプロパティ→
transform/opacity、ショートハンド→完全なtransform文字列、プログラムによる CSS には WAAPI - 非対称タイミング – 意図的なフェーズを遅くし、応答を即座に
- 洗練 – クロスフェードをマスクするためのぼかし、グループのためのずらし、エントリのための
@starting-style、「生きている」要素のためのスプリング - アクセシビリティと一貫性 – reduced-motion とホバーゲーティングを追加、コンポーネントの個性に合わせて調整
必須出力形式
2つの部分。この順序で。
パート1 — 所見テーブル(必須)
単一のマークダウンテーブル。問題ごとに1行。決して「Before:/After:」リストではありません。
| Before | After | Why |
|---|---|---|
transition: all 300ms | transition: transform 200ms ease-out | 正確なプロパティを指定、all は GPU 外の意図しないプロパティをアニメーションさせる |
transform: scale(0) | transform: scale(0.95); opacity: 0 | 無からは何も現れない — scale(0) はどこからともなく現れたように見える |
ドロップダウンでの ease-in | ease-out + カスタムカーブ | ease-in はユーザーが最も注視する瞬間を遅らせる、もっさり感じる |
ポップオーバーでの transform-origin: center | var(--transform-origin) (Base UI) | ポップオーバーは中央ではなくトリガーからスケーリングする(モーダルは例外) |
パート2 — 判定(必須)
残りのコメントを重要度の高い順にグループ化します。空の階層は省略します。
- フィーリングを壊す退行 — もっさりしたイージング、どこからともなく現れる、高頻度/キーボードアクションで発火
- 見逃された簡略化 — 削除または大幅に削減すべきアニメーション
- パフォーマンス — 非 GPU プロパティ、フレームドロップのリスク、再計算ストーム
- 中断可能性とタイミング — トランジション/スプリングが属する場所のキーフレーム、非対称にすべき対称タイミング
- 原点、物理的性質、一貫性 — 間違った原点、一致しない個性、不快なクロスフェード
- アクセシビリティ — reduced-motion とポインター/ホバーゲーティング
明確な決定で締めくくります。
- ブロック — フィーリングを壊す退行、キーボード/高頻度アクションでのアニメーション、UI での
scale(0)/ease-in、または簡単な GPU 修正がある非 GPU アニメーション - 承認 — フィーリングを壊す退行なし、削除すべき明らかなモーションなし、持続時間とイージングが範囲内、必要な場所での中断可能性の処理、reduced-motion の尊重
具体的に ファイル:行 を引用してください。値(カーブ、持続時間、スプリング設定)が必要な場合は、近似ではなく STANDARDS.md から正確なものを取得してください。
ガイドライン
- 所定のモーションには CSS トランジション/
@starting-style/WAAPI を優先、動的で中断可能なジェスチャー駆動モーションには JS/スプリングを使用 - モーションが正しく感じられるかどうかわからない場合は、推測するのではなく、スローモーション/フレームバイフレームで、または新鮮な目で翌日にレビューすることを推奨