Communitygithub.com

Seenry Motion(インターフェースモーション構築スキル)

インターフェースモーション(プレスフィードバック、メニュー、ツールチップ、ダイアログ、シート、トースト、アコーディオン、タブ、ページトランジション、共有要素トランジション、スクロールエフェクト、ドラッグ&ジェスチャー、数値・アイコン変更など)を構築、レビュー、研究します。アニメーションの要否を判断し、最適なツール、プロパティ、カーブ、時間、スプリング、割り込み処理、動作低減対応を選択し、テスト済みの最新CSSレシピと実行可能なアセットを提供します。また、Seenryのリファレンスから録画されたモーションを研究します。

Seenry Motion(インターフェースモーション構築スキル) とは?

Seenry Motionスキルは、AIエージェント(Claude Code、Cursor、Codexなど)向けに設計された、インターフェースのモーションを体系的に構築・レビュー・研究するためのスキルです。このスキルは、アニメーションを使うべきかどうかの判断から始まり、目的の明確化、最もコスト効率の良いツールの選定、プロパティ・カーブ・時間またはスプリングの選択、割り込み処理と終了動作の計画、そしてアクセシビリティのための動作低減対応までを、段階的にガイドします。CSSトランジション、ビュートランジションAPI、Webアニメーション、Motionライブラリなど、さまざまなプラットフォームとツールをサポートし、テスト済みの最新CSSレシピと実行可能なアセット(アクションメニュー、モーダルサーフェス、ボイスプレゼンスなど)を提供します。Seenry Motion Judgeと呼ばれる評価基準に基づき、AppleやLinearレベルの差別化された高品質なモーションを実現するための詳細なチェックリストと改善プロセスを提供します。このスキルは、コード生成だけでなく、既存のモーションの分析や改善提案にも使用でき、開発者が一貫性のある、目的にかなったインターフェースアニメーションを効率的に構築できるようにします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ayangabryl/seenry-skills/tree/HEAD/skills/seenry-motion

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Seenry Motion(シーンレモーション)

モーションは変化を説明するために存在します。つまり、何がどこから来たのか、入力が何をしたのか、インターフェースが現在どの状態にあるのかを示します。以下の順序に従ってすべてのアニメーションを構築してください。ステップ1と2で、そもそもコードを書くべきかどうかを決定します。

判断を1行で述べて、モーションの選択肢を列挙しないでください。プロジェクトの既存のモーショントークンとコンポーネントを拡張し、並行したセットを追加しないでください。

構築手順

1. そもそもアニメーションさせるべきか? 頻度に基づいて判断します。

人が見る頻度判断
1日100回以上(コマンドメニュー、キーボードショートカット、リストナビゲーションの矢印操作)アニメーションなし。即時。
1日に数十回(ホバー、タブ、トグル)不透明度と色のみ150ms以下、またはなし
たまに(メニュー、ダイアログ、シート、トースト)以下の表の標準モーション
まれに(オンボーディング、初回成功、空から満杯になる瞬間)個性を出す余地あり

キーボードトリガーのアクションは、アニメーションを待ちません。ゲートが「なし」と判断したら、そのように述べて、即座に状態変更を出荷します。

2. 目的を1語で述べる: フィードバック、方向性(どこから来たか、どこへ行ったか)、状態、連続性(急なジャンプを避ける)、説明(マーケティングとオンボーディングのみ)、または喜び(まれな瞬間のみ)。目的がなければアニメーションなし。データを読んでいる人に対して、スタイルのために動かすことは決してありません。

3. 動作する最もコストの低いツールを選ぶ。

ニーズツール
ホバー、プレス、色、クラスまたは属性のトグルCSSトランジション
マウント時の出現、display: none前の終了、ネイティブ<dialog>とpopoverCSSトランジション + @starting-style + allow-discrete
高さをautoにinterpolate-size: allow-keywords、またはグリッド 0fr → 1fr トラック
ルート変更、リスト→詳細、インジケーターの変形View Transitions API
スクロール連動エフェクトanimation-timeline: view() / scroll()
プログラム可能でキャンセル可能、ライブラリ不要Web Animations(element.animate)
速度を持つスプリング、レイアウトアニメーション、ジェスチャー、ReactでのプレゼンスMotion(motion.dev)
コンポーネント全体(トースト、ドロワー、コマンドメニュー、セレクト)メンテナンスされたライブラリ。ライブラリを参照

4. プロパティを選ぶ。 translate、scale、rotate、opacity、clip-path、filter のみ。scale(0)からの出現は決してしないでください。0.95~0.97、不透明度0から始めてください。ポップオーバーはトリガーからスケールします(transform-origin をトリガー側に)。ダイアログは中央からスケールします。パーセントを使った移動(translate: 0 100%)は、要素自身のサイズで移動します。

5. カーブと時間、またはスプリングを選ぶ。

モーション時間イージング
プレスフィードバック100~160ms--ease-out
ツールチップ、小さなポップオーバー120~200ms--ease-out
メニュー、ドロップダウン、セレクト150~250ms--ease-out
ダイアログ200~250ms--ease-out
シート、ドロワー350~500ms--ease-drawer
画面を横切る要素の移動、変形250~400ms--ease-in-out
ホバー時の色、背景、境界線150msease
プログレス、マーキー、長押し確認の塗りつぶし作業が続く間linear

--ease-out: cubic-bezier(0.23, 1, 0.32, 1)、--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1)、--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1)。インターフェースモーションでは、ease-inは絶対に使用しないでください。これは人が見ている瞬間を正確に遅らせます。プロダクトUIは300ms未満を推奨します。シートの長い移動には理由が必要です。終了は、直接操作や空間関係を維持するために同じ時間が必要な場合を除き、多くの場合、出現よりも約20~30%速くなります。ユーザーがドラッグ、フリック、または途中で反転できるものにはスプリングを使用してください。Motion {type: "spring", duration: 0.5, bounce: 0.2}(プロダクトUIではbounce 0、遊び心のあるものでは≤0.3)、またはレシピのCSS linear() スプリングを使用します。

6. 割り込みと終了を計画する。 可逆的なプロパティ変更にはCSSトランジションを推奨します。現在の値から再ターゲットできるためです。ジオメトリや振り付けにWAAPIが必要な場合は、現在のレンダリング状態をキャプチャし、所有するアニメーションをキャンセルまたは再ターゲットし、古い完了をガードします。2番目の入力は、古いリクエストの後ろにキューイングするのではなく、それを反転または置き換えます。新しい論理状態を即座に公開します。別のプレゼンテーション状態が終了した描画を保持する場合があります。

中断された変更を洗練させる。 コンポーネントに適した場合に、これらのチェックを使用してください。これらは設計上のヒューリスティックであり、保証された評価スコアではありません。出現中と終了中に、50~150ms間隔を含む繰り返し入力を試してください。時間に関する主張をする際には、実際のタイミングを記録してください。

  • 連続性と意味を保持する。 関連するタブ、フィルター、またはステータス状態は、1つのグリッドセル(display:grid、grid-area:1/1)を共有し、不透明度または小さな移動をトランジションできます。非アクティブなコンテンツをフォーカス順序とアクセシビリティツリーから除外します。マウントされていることはインタラクティブであることを意味しません。迅速な退場フェーズ(約65~90ms)と120~160msの入場は、必須のレシピではなく、開始点として使用できます。現在のトランジションが許可した場合にのみアンマウントまたは非表示にします。古い完了が新しい状態を決して隠してはいけません。明示的にキャンセル可能なWAAPIとガードされたネイティブダイアログの終了は有効な代替手段です。
  • 結果を理解しやすく保つ。 偶発的な空白の間隔や、判読できない競合するテキストを避けてください。コンテンツに基づいて、オーバーラップ、短いクロスフェード、または即時置換を選択します。ラベル全体の終了フェードは、テキストをアートワークを通して移動させるよりも安全な場合があります。モーションが利用できないか低減されている間は、適切な静的な手がかりを保持します。不透明度のしきい値を証明として使用するのではなく、実際の可読性を検査します。
  • 移動するもののコピーは1つ。 タイトル、アバター、カバーが新しい場所に移動する場合、重複した描画を避けてください。移動先を、移動体が到着するまで非表示にし、その後一時的なコピーを廃棄します。テキストをアートワークと移動するシェルに対してトレースします。クリップされていないエンドポイントは、読み取り可能なパスを証明しません。
  • ラベルはその結果と一致する。 「支払い済みとしてマーク」のようなラベルが「支払い済み」になることは、その結果と同じ受け入れられたアプリケーション状態に従います。必要に応じてそのフットプリントを予約し、古いテキストやフォーカス可能な重複ラベルを防ぎます。装飾を終了するためだけに、実際の成功状態を遅らせてはいけません。
  • シーケンスはキャンセル可能。 タイピングデモ、段階的な表示、リプレイは、保留中のステップの所有者を共有します。一時停止、反転、新しい入力は、古い作業をキャンセルし、現在の状態から可視モーションを再ターゲットします。古いタイムアウトは、一時停止したシーケンスを再開したり、新しいコンテンツを上書きしたりしてはいけません。
  • 終了したアニメーションを解放する。 CSSまたは確定したスタイルを介して確定状態を確立し、適切な場合には有限の所有するWAAPIアニメーションを解放します。fill:forwardsは、後の状態変更を上書きし続けてはいけません。インタラクションが落ち着いた後、予期しないアニメーションがないか確認します。ただし、意図的なローディングインジケーターがその作業を終えるまで許可します。
  • 各移動は関係性を説明する。 メニューはトリガーから、パネルは端から成長し、関連コンテンツはナビゲーションと一貫して移動します。上記の時間範囲を開始点として使用します。知覚される応答を即座に保ち、長い移動を正当化します。固定された時間を品質の証明として扱うのではなく、割り込みと動作低減をテストします。

9を達成する。 モーション判定では、7は正しいが一般的、8は明らかにプレミアム、9はAppleやLinearレベルの差別化されたものです。ラウンドは同じいくつかの理由で7~8で停滞します。実行を費やす前に、これらすべてを処理します。

  • 一度に1つのコンポーネント。 各コンポーネントを単独で、--labels "<Row>"を使用して9になるまで判定し、各コンポーネントの最良のバージョンを保持します。カタログの全体は最も弱い行に従うため、多くの行を一度に修正しても決して改善せず、行を下げる変更は、判定が提案した場合でも元に戻されます。
  • すべての修正を適用する。見出しとなるものだけではない。 繰り返し発生する小さな項目(ホバー、プレス、クローズコントロールのフィードバック)は、何度もstatesを7に留めます。--prev <last motion.json>は、上昇しなかった基準と、再度修正するよう求められたインタラクションをリストします。check.mjsが自動的に渡します。
  • 修正後に戻ってくる問題は構造的な問題。 タイミングの再調整では、交差するパスを修正できません。共有要素は、状態間で相対的な配置を維持します。タイトルがカバーの下にある場合は、詳細ビューでもその下に留まり、互いに通過することはありません。
  • 空のフレームは禁止。 撮影されたすべての瞬間(30~320ms)で、変更された領域に実際のコンテンツが表示されます。シェルは成長するにつれてコンテンツを運びます。ストリーミング応答は最初の単語から成長します。空白の回答ボックスや、待ってから消えるスケルトンを決して表示しないでください。
  • コンポーネントごとに1つの洗練されたアイデア。 持続するものは移動し、新しいものはその原因から生まれます。フェード、4pxの移動、ラベルの交換では7です。
  • 開いた場所で閉じる。 コントロールから開くサーフェスは、同じ場所から閉じます。コントロールがその閉じる場所になる(またはその場で置き換えられる)ため、手は移動しません。同じ色を維持する必要はありません。場所とサイズを維持します。
  • 1回の実行はスコアではない。 1回の判定実行(それ自体が3回の中央値)では、変更されていないコードで1ポイントしか動きません。2回の異なる実行が両方とも9に達した場合にのみ9を受け入れ、同じ実行回数でバージョンを比較します。

7. 動作低減と入力ゲートを一緒に出荷する。 prefers-reduced-motion: reduceでは、動き、パララックス、ぼかし、ループを削除し、理解を助ける短い不透明度の変更は残します。@media (hover: hover) and (pointer: fine)でホバーモーションをゲートします。アニメーション化されたすべての状態変更には、モーションが実行されない場合のための静的な手がかり(ラベル、アイコン、色)も残します。

レシピ

プレスフィードバック、メニューとポップオーバー、ツールチップ、ダイアログ、シート、トースト、アコーディオン、段階的な出現、タブインジケーター、ページと共有要素のトランジション、スクロールリビール、アイコンのスワップ、数値変更、長押し確認、ドラッグして閉じる(速度予測とラバーバンド付き)、クロスフェードマスキング、テーマ切り替え、初回レンダリング抑制については、レシピから始めてください。ネイティブCSSレシピは、パッケージテストによってChromiumで実行されています。

実行可能なアセット

要求された変更焦点となるルート
アクションメニューまたは短いステータスラベルオリジナルのアクションメニュー、ステータススイッチ、プロダクトトランジション。メニューが開閉のアニメーションを要求された場合、終了フェーズを通じてそのサーフェスを保持します。閉じる際の条件付きアンマウントはそのフェーズをスキップします。ステータストランジションの場合、テキストを予約されたスロット内で移動します。単なるテキスト置換やドットの色変更だけでは不完全です。アプリケーションが実際のアクションを所有します。
フロー内の開示または変化するジオメトリオリジナルの展開カード、ジオメトリヘルパー、サーフェスパターン。フォーカスを保持し、現在のジオメトリから再ターゲットします。
フォーカスされたモーダルタスクオリジナルのモーダルサーフェス、サーフェスパターン。トップレイヤーとフォーカス動作にはネイティブダイアログを使用します。終了が完了してから閉じるようにし、反転は保留中の閉じるをキャンセルできるようにします。
変化する数値またはアイコン数値トランジション、アダプター。小さな整数カウントの場合は、桁のセマンティクスを再構築するよりも、オリジナルのカウントポップヘルパーを推奨します。実際のアクセシブルな値を1つ保持します。すべての桁を非表示にして、プレーンな<strong>にaria-labelを設定しないでください。桁トランジションには位置ごとのモーションが必要です。単位は固定しておきます。
ライブ音声入力または出力オリジナルの音声プレゼンスは、アプリケーションが所有する状態と正規化されたオーディオレベルを受け入れます。コントロールとアナウンスをDOMに保持します。生成されたデモ信号はマイクアクティビティではありません。
ローディングまたはプロセスのプレゼンスオリジナルのシグナルフィールド、バウンダリトレース、ローディングパターン。アニメーション時間は進捗ではありません。
デコードされた画像または表現力豊かなマテリアルオリジナルの画像リビール、反射ソリッドとリムサーフェス、ポインターチルト、サーフェスエフェクト、表現力豊かなエフェクト。置き換えがロードされている間は有用なコンテンツを保持します。反射とチルトは、マテリアルに目的がある場合にのみ使用します。
新しいインタラクティブコンポーネントの設計(概要、状態グラフ、モーションスコア、入力コントラクト、チェックリスト)インタラクションクラフト
トーストまたはバナースタックフィードバックパターンとオリジナルの通知リデューサー。アクティブ状態からオーバーフローをその終了前に削除します。3つのアイテムスタックで4番目のイベントをテストします。
まれな完了したマイルストーンオリジナルの確認バースト。最初にアプリケーション状態に成功を記録し、次に有限の装飾を再生します。確定した結果は、それがクリアされた後も表示されたままである必要があります。
選択されたタブまたは順序付けられたページ変更共有ハイライトにはオリジナルの選択サーフェス、関連ビューには方向ステージ。アプリケーションが選択、パネル、ルート、履歴を所有します。他の構造にはナビゲーションパターンを使用します。
スクロールまたは調整されたシステムスクロール振り付け、ワークドスコア、システム振り付け、モーションインデックス。

この変更に必要なガイドとヘルパーのみを選択してください。バンドルされているオリジナルアセットは再利用可能な開始点であり、名前付きソースコンポーネントの自動的な代替品や、それに対する忠実性の証明ではありません。コピーしたサードパーティランタイムがある場合は、ライセンスを保持してください。オリジナルのSeenryアセットはリポジトリのMITライセンスを使用します。

絶対に出荷しないもの

絶対にしない代わりに
1日100回以上またはキーボード駆動のアクションに対するアニメーション即時変更
transition: allプロパティを明示的に指定
ease-in による出現--ease-out
不透明度と移動以外のプロパティ上記の許可リストのみ
スケール0からの出現0.95~0.97
固定された時間だけを品質の証拠として使用する割り込みと動作低減をテストする
終了前にアンマウントする終了フェーズを完了させる
ユーザーのドラッグに固定時間アニメーションスプリング

既存のプロジェクトへの適用

このガイドは、モーションがスクラッチから構築されているか、既存のコードベースに段階的に導入されているかにかかわらず機能します。既存のプロジェクトで作業する場合:

  1. 監査: 構築手順を使用して各アニメーションを評価します。目的を特定し、ツールの選択を検証します。
  2. トークン化: 共通のカーブ、時間、動作低減設定をCSSカスタムプロパティとして抽出します。
  3. 1つずつ置き換える: 現在の動作を変更せずに、最も影響の大きいアニメーションから始めて、新しいパターンに置き換えます。
  4. テスト: 各変更を出現、終了、割り込み、動作低減に対してテストします。

目的は、すべてのプロジェクトモーションを一貫性があり、目的にかなった、高いスコアにすることです。プロジェクトが進むにつれて、最初の監査は新しいアニメーションのガイドとして機能します。

関連リソース

関連スキル