インターフェースフィール は何をしますか?
インターフェースの動きと応答性に関するマスターパス。現在のアプリを40項目(12のアニメーション原則、8つのUX法則、20のUIテクニック)とモーションシステムに対して監査し、レポートを作成し、各項目のパターンで問題を修正します。ほとんどのアプリはリストの半分を既に持っているため、監査ではその旨を報告し、重複して追加しません。速度、ターゲットサイズ、信頼性は常に適用し、装飾は作業ツールでは控えめにします。
プロジェクト自身のデザインシステム、モーショントークン、ルールがここでの内容よりも優先されます。パフォーマンス予算(LCP、INP、バンドルサイズ)、アクセシビリティ、コピーは、これとは別のパスで扱います。
このスキルのファイル
| ファイル | 用途 |
|---|---|
reference.md | 40項目それぞれ:確認方法、修正パターン、スキップ条件、実際の監査で見つかった内容 |
motion.md | モーションシステム:トークン、12のルール、CSSパターン、モーション監査方法 |
audit/census.sh | コード調査:各項目の背後にあるパターンをカウントし、ファイル:行を表示 |
audit/probe.js | ライブページプローブ:実際のヒットターゲットサイズ、持続時間、イージング、数値、見出し、コードフィールド、プレースホルダー |
report-template.md | 監査レポート:項目ごとに1行の判定、作業順序、チェックしていない内容 |
Pass 1: 監査(変更しない)
- まずプロジェクトのデザインシステム、モーショントークン、UIルールを読む。
- プロジェクトルートから調査を実行:
bash <this skill>/audit/census.sh . --show 5。出荷されている表面のみを読みます(依存関係、ビルド、ベンダーコピー、テスト、ベンチマーク、生成ファイル、コメント行は除外;CENSUS_EXCLUDE="dir1,dir2"で追加)。高速実行にはripgrepをインストール;なければスクリプトはperlにフォールバックします。カウントは開くべきリードであり、判定ではありません。 - アプリを起動。主要な各ページで、1440px幅と375px幅、そしてアプリが持つ各テーマで
audit/probe.jsを実行(コンソールに貼り付けるか、ブラウザツールのJavaScriptランナーでawaitする)。ページを1画面ずつスクロールし、位置を復元します。非表示タブには幅がなく、フレームを描画しません:先に表示してください。出力を判断して読む:spacedとマークされたターゲット(次のコントロールとのギャップが下限に達している)は重要度が低い;数値は変化する場合のみtabular-numsが必要;装飾的なモックウィンドウはaria-hiddenにするか、行を無視します。 - スクリプトでは見えない操作を手動で、実際のポインターイベント(ブラウザツールのクリック、合成
.click()ではない)を使って行う:有料または不可逆のアクションを2回素早く押し、サーバーへの影響をカウント;ネットワークと書き込みを600msに制限して押す;すべてのレイヤーを高速で開閉し、閉じかけの状態で再度開き、その不透明度をサンプリング(motion.md「再開の計測」);閉じかけのメニュー内を押す;アクセント付きおよび異なる大文字小文字のクエリを入力;ホバーサブメニューに向かって斜めに移動;レイヤーを開いた状態でAndroidの戻るボタン;電話シートをスワイプ。 report-template.mdからレポートを作成:40行すべて、各項目を there、missing、wrong、skip とその理由、証拠としてファイル:行または数値、そして build または pick を記入。修正前にそれを表示する。
Pass 2: チェックリストに従って修正
- 信頼性を最優先:項目39と、請求を2倍にしたりデータを失う可能性のあるものすべてを、修正前に失敗するテストとともに。
- Build 項目は外観を変えずに動作を変更する(ヒットスロップ、セーフトライアングル、戻るジェスチャー、アクセント折りたたみ、ショートカット、コマンドメニューエントリ、楽観的書き込み、スケルトン、モーショントークン、可逆トランジション)。
reference.mdとmotion.mdのパターンに従い、プロジェクト自身のコンポーネントとトークンを通じて修正し、ロジックにはテストを追加。 - Pick 項目は外観または製品を変更する(コーナー、ブラープレースホルダー、確認の代わりの元に戻す、エラービート、新しいモーションビート、ビュートランジション)。各項目を、スケール1で両方のテーマでbefore/afterとしてベンチマークし、番号付きで分離可能にし、オーナーが選んだもののみをビルド。
- 削除した装飾を新しい装飾で置き換えない。
Pass 3: 検証
調査とプローブを再実行し、数値をレポートと比較する。すべての修正されたインタラクションをユーザーのように駆動し、両方のテーマで、電話幅でも別途確認する。ビルド、テスト、視認承認、デプロイをそれぞれ別の事実として報告し、測定できなかったもの(実機なし、プロダクションビルドなし)を明記する。
チェックリスト
番号は reference.md とレポートに対応。
| # | 項目 | 失敗条件 |
|---|---|---|
| A | アニメーション原則(motion.md) | |
| 1 | スカッシュとストレッチ | ランディングバッジ、ドット、ノブが突然停止する |
| 2 | 予備動作 | 押下に1フレーム以内の状態がない(スケール約0.97、約100ms) |
| 3 | 段取り | 開かれたレイヤーが主要なものを不明瞭にする |
| 4 | ポーズ to ポーズ | 忙しいボタン、ラベル、アイコンの切り替えが幅や内容でジャンプする |
| 5 | フォロースルー | レイヤーのコンテンツがコンテナに溶接されたように到着する |
| 6 | イーズイン、イーズアウト | UIモーションに linear またはデフォルトの ease;3つ以上のイージング |
| 7 | 弧線 | 何かが直線で遠くまで移動する |
| 8 | 二次アクション | 完了したアクションに確認の2番目のビートがない |
| 9 | スナッピータイミング | UI応答が300ms超;1つのサーフェスが他のものと異なる;終了が短くない |
| 10 | 誇張されたフィードバック | 無効な送信が、色のビートなしでわずかな動きのみを示す |
| 11 | ソリッドドローイング | シャドウとレイヤーが光と奥行きで矛盾する |
| 12 | アピール | スケール1でステップ実行した1つの実際のフローに継ぎ目が見える |
| B | UX法則 | |
| 13 | フィッツの法則 | デスクトップで32px未満、または電話で44px未満の実際のターゲット |
| 14 | より大きなヒットエリア | 画像を拡大して成長させたターゲット、または重なり合う兄弟要素 |
| 15 | ヒックの法則 | 1つのメニューブロックに5つ以上の項目 |
| 16 | ミラーの法則 | チャンク化されていないトップレベル項目が約7つ以上 |
| 17 | ドハティのしきい値 | 押下から次の描画まで400ms超で、最初に応答するものがない |
| 18 | ポステルの法則 | クエリのアクセント、大文字小文字、スペースのバリエーションが何も見つからない |
| 19 | ヤコブの法則 | パターンがプラットフォームと異なる動作(ホバーサブメニュー、戻るでレイヤーを閉じる) |
| 20 | 使用頻度 | 毎日のアクションが1ステップまたは1コマンド以上離れている |
| C | 速度とフィードバック | |
| 21 | スケルトンローダー | ルートが空白を描画するか、クリックフレームにスピナーを表示する |
| 22 | 楽観的更新 | 安価で元に戻せる書き込みがサーバーの応答まで何も表示しない |
| 23 | コマンドメニュー | 行き先がクリックでは到達できるが、タイピングでは到達できない |
| 24 | ショートカットヒント | ショートカットのあるコントロールがツールチップにそれを表示しない |
| 25 | 元に戻すトースト | 復元可能な削除に元に戻すがない(オーナーが確認の代わりにするかどうかを決定) |
| 26 | Stale-while-revalidate | 再訪したページが待機し、最後のデータを表示しない |
| 27 | プリレンダリング | 次にありそうなページが意図時にプリフェッチされていない(プロダクションで判断) |
| 28 | ブラープレースホルダー | 読み込み中の画像が灰色のボックス |
| 29 | ビュートランジション | グリッドから詳細への開封に共有要素モーフがない |
| 30 | スワイプで閉じる | 電話シートやドロワーをスワイプで閉じられない |
| 31 | 割り込み可能なアニメーション | 終了中に再開するとゼロから再生 |
| D | プラットフォームと詳細 | |
| 32 | 予測的戻る | レイヤーを開いた状態でAndroidの戻るボタンがページを離れる |
| 33 | ヒットスロップ | 小さなアイコンコントロールに非表示のターゲット拡大がない |
| 34 | セーフエリアインセット | 下部フロートが viewport-fit=cover 下で env(safe-area-inset-*) を無視する |
| 35 | ワンタイムコード自動入力 | コードフィールドに autocomplete="one-time-code" と inputmode="numeric" がない |
| 36 | タブラーニュメラル | 変化する数値がジッタする(tabular-nums なし) |
| 37 | バランスの取れた見出し | 短い複数行見出しにオーファンが残る(text-wrap: balance なし) |
| 38 | 連続コーナー | スクィークルコーナーが考慮されていない(見た目の判断:ベンチマーク) |
| E | 信頼性 | |
| 39 | 冪等性キー | 有料または不可逆アクションの2回の高速押下が2つのサーバー効果を生む |
| 40 | セーフトライアングル | ホバーサブメニューが斜め方向への移動で閉じる |
よくある間違い
- 既存のものを追加する:スケルトン、キャッシュ、モーショントークンはしばしば既にある;判定は there。
- クライアント側の重複排除をお金のガードにする:2回のクリックがボタンを無効にする再レンダリングの前に着地する。サーバー側でガード(条件付き更新、決定論的キー、ロック)し、押下をrefで保持する。
- 画像をターゲットの代わりに拡大する;デスクトップ幅のみでターゲットをチェックし、デスクトップルールが電話の下限を殺す。
- 開閉のキーフレーム:それらは逆転できない。状態属性にトランジションを使用し、離れるレイヤーを
inertにする。 - 元に戻す、コーナー、エラートーンをエンジニアリングの選択として扱う。それらはオーナーに属する。
- 開発サーバーやバックグラウンドタブでプリフェッチやタイミングを判断する。