fixing-motion-performance(モーション性能の修正)
選択的読み取りルール
以下から開始:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
その後、ユーザーの実際のタスクにマッチする継承されたドキュメント、スクリプト、アセット、または例のみを読み込みます。
アニメーションのパフォーマンス問題を修正します。
使用方法
-
/fixing-motion-performanceこの会話内のすべてのUIアニメーション作業に以下の制約を適用します。 -
/fixing-motion-performance <ファイル>以下に従ってファイルをレビューし、報告します:- 違反(正確な行またはスニペットを引用)
- なぜ問題か(短い一文)
- 具体的な修正(コードレベルの提案)
明示的に要求されない限り、アニメーションライブラリの移行は行わないでください。既存のスタック内でルールを適用します。
使用すべきタイミング
以下の状況でこのガイドラインを参照してください:
- UIアニメーションの追加または変更時(CSS、WAAPI、Motion、rAF、GSAP)
- jankyなインタラクションやトランジションのリファクタリング時
- スクロール連動モーションやスクロールに応じた表示(reveal-on-scroll)の実装時
- レイアウト、フィルター、マスク、グラデーション、CSS変数のアニメーション時
- will-change、トランスフォーム、測定を使用するコンポーネントのレビュー時
レンダリングステップの用語集
- コンポジット:transform、opacity
- ペイント:color、borders、gradients、masks、images、filters
- レイアウト:size、position、flow、grid、flex
カテゴリ別ルールの優先順位
| 優先度 | カテゴリ | 影響度 |
|---|---|---|
| 1 | 絶対禁止パターン | 重大 |
| 2 | メカニズムの選択 | 重大 |
| 3 | 測定 | 高 |
| 4 | スクロール | 高 |
| 5 | ペイント | 中~高 |
| 6 | レイヤー | 中 |
| 7 | ブラーとフィルター | 中 |
| 8 | ビュートランジション | 低 |
| 9 | ツール境界 | 重大 |
クイックリファレンス
1. 絶対禁止パターン(重大)
- 同じフレーム内でレイアウトの読み取りと書き込みをインターリーブしない
- 大規模または重要なサーフェス上でレイアウトを連続的にアニメーションさせない
- scrollTop、scrollY、またはスクロールイベントからアニメーションを駆動しない
- 停止条件なしのrequestAnimationFrameループは禁止
- それぞれがレイアウトを測定または変更する複数のアニメーションシステムを混在させない
2. メカニズムの選択(重大)
- モーションにはデフォルトでtransformとopacityを使用
- インタラクションで必要な場合にのみJS駆動のアニメーションを使用
- ペイントまたはレイアウトのアニメーションは、小さく孤立したサーフェスでのみ許容
- ワンショットエフェクトは連続モーションよりも許容されることが多い
- モーションを完全に削除するよりも、技術をダウングレードすることを優先
3. 測定(高)
- 一度測定し、その後はtransformまたはopacityでアニメーション
- すべてのDOM読み取りを書き込みの前にバッチ処理
- アニメーション中にレイアウトを繰り返し読み取らない
- レイアウト的な効果にはFLIPスタイルのトランジションを優先
- 測定と書き込みをバッチ処理するアプローチを優先
4. スクロール(高)
- スクロール連動モーションには、利用可能な場合はScrollまたはView Timelinesを優先
- 可視性と一時停止にはIntersectionObserverを使用
- アニメーションのためにスクロール位置をポーリングしない
- 画面外ではアニメーションを一時停止または停止
- スクロール連動モーションは、大規模なサーフェスで連続的なレイアウトやペイントを引き起こしてはならない
5. ペイント(中~高)
- ペイントを誘発するアニメーションは、小さく孤立した要素でのみ許可
- 大きなコンテナではペイント負荷の高いプロパティをアニメーションさせない
- transform、opacity、またはpositionのためにCSS変数をアニメーションさせない
- 継承されたCSS変数をアニメーションさせない
- アニメーションするCSS変数はローカルにスコープし、継承を避ける
6. レイヤー(中)
- コンポジッタモーションにはレイヤー昇格が必要であり、決して自動的に行われると想定しない
- will-changeは一時的かつ限定的に使用
- 多くのまたは大規模な昇格レイヤーを避ける
- パフォーマンスが重要な場合はツールを使用してレイヤーの動作を検証
7. ブラーとフィルター(中)
- ブラーアニメーションは小さく保つ(<=8px)
- ブラーは短く、一度きりの効果にのみ使用
- ブラーを連続的にアニメーションさせない
- 大きなサーフェスでブラーをアニメーションさせない
- ブラーの前にopacityとtranslateを優先
8. ビュートランジション(低)
- ビュートランジションはナビゲーションレベルの変更にのみ使用
- インタラクションの多いUIではビュートランジションを避ける
- 中断やキャンセルが必要な場合、ビュートランジションを避ける
- サイズ変更はレイアウトを誘発する可能性があるものとして扱う
9. ツール境界(重大)
- 明示的に要求されない限り、アニメーションライブラリを移行または書き換えない
- 既存のアニメーションシステム内でこれらのルールを適用
- 同じコンポーネント内でAPIを部分的に移行したりスタイルを混在させたりしない
よくある修正例
/* レイアウトスラッシング:widthの代わりにtransformをアニメーション */
/* 修正前 */ .panel { transition: width 0.3s; }
/* 修正後 */ .panel { transition: transform 0.3s; }
/* スクロール連動:JSの代わりにscroll-timelineを使用 */
/* 修正前 */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* 修正後 */ .reveal { animation: fade-in linear; animation-timeline: view(); }
// 測定:書き込みの前に読み取りをバッチ処理(FLIP)
// 修正前 — レイアウトスラッシング
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// 修正後 — 一度測定し、transformでアニメーション
const first = el.getBoundingClientRect();
el.classList.add('moved');
const last = el.getBoundingClientRect();
el.style.transform = `translateX(${first.left - last.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });
レビューガイダンス
- 最初に重大なルール(絶対禁止パターン、ツール境界)を徹底
- 意図に合致する最もレンダリング負荷の低い作業を選択
- デフォルト以外の選択をする場合は、それを正当化する制約(サーフェスサイズ、期間、またはインタラクション要件)を明記
- レビュー時は、理論よりも実用的な指摘と具体的な代替案を優先
制限事項
- このスキルは、タスクが上記の範囲に明確に合致する場合にのみ使用してください。
- 出力を環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全境界、または成功基準が不足している場合は、立ち止まって質問してください。