Communitygithub.com

ユーザーエクスペリエンスチェック

プロジェクトのUIを UXの法則30項目(lawsofux.com)に基づいて監査し、実際の問題と具体的な修正案を優先順位付きで報告します。

ユーザーエクスペリエンスチェック とは?

このスキルは、コードベース、ライブURL、スクリーンショットのいずれかを対象に、UXの法則30項目すべて(フィッツの法則、ヒックの法則、ヤコブの法則、ミラーの法則、ドハティ閾値、ポステルの法則、テスラーの法則、フォン・レストルフ効果、ピークエンドの法則、系列位置効果、ツァイガルニク効果、目標勾配効果、ゲシュタルト原理(近接、類似、共通領域、一様な連結、 Prägnanz)、認知負荷、選択過多、チャンキング、オッカムの剃刀、パレートの法則、パーキンソンの法則、美的ユーザビリティ効果、メンタルモデル、フロー、選択的注意、ワーキングメモリ、アクティブユーザーのパラドックス、認知バイアス)に基づいて監査します。各問題について、該当する法則、発生箇所、重大度、具体的な修正案を報告します。ユーザーが明示的に修正を依頼しない限り、自動的な修正は行いません。Web(React, Vue, Svelte, Angular)、モバイル(React Native, Flutter, SwiftUI)など、さまざまなフレームワークをサポートしています。監査後は、優先度の高い問題の修正を提案します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aswin-haridas/skills/tree/HEAD/skills/check-user-experience

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

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

ドキュメント

ユーザーエクスペリエンスチェック は何をしますか?

インターフェースをUXの法則に照らして監査し、実際の問題と具体的な修正案を優先順位付きでレポートします。ユーザーが依頼しない限り、修正は行わずレポートのみを提供します。

ワークフロー

1. 対象の把握

  • コードベース: スタックを特定し、画面/ルート、共有コンポーネント(ボタン、入力、フォーム、ナビ、モーダル、リスト、テーブル)、デザイントークン、ローディング/エラー状態を検索します。ファイル名だけでなく、実際のマークアップとスタイルを読み込みます。
  • ライブURL / ローカルビルド: ブラウザで開き、主要なフローを確認し、デスクトップとモバイルの両方の幅でスクリーンショットを撮り、可能な場合はヒットターゲットと応答時間を測定します。
  • スクリーンショット: 視覚的に評価します。コードのみで確認可能なチェックは「確認不可」とマークします。
  • 3~5の主要なユーザータスク(サインアップ、検索、チェックアウト、Xの作成など)を特定します。監査においてもパレートの法則を適用し、これらのフローを重点的に監査します。

2. すべての法則をチェック

以下の表を確認します。各法則について、リストされたシグナルを探します。具体的な根拠と発生箇所がある所見のみを報告し、一般的なアドバイスでレポートを水増ししないでください。ある法則が満たされている場合は、「合格」リストに1行で記載します。

3. レポート(下記フォーマット)を出力し、高優先度の項目の修正を提案します。

法則:チェックすべき点と修正方法

インタラクションと労力

法則問題となる状況推奨される修正
フィッツの法則 — ターゲットのサイズと距離がヒット時間に影響するタップターゲットが44×44pt(iOS)/ 48×48dp(Android)/ 24×24 CSS px(WCAG 2.5.8 最小、理想的には44px)未満。パディングが不十分なアイコンボタン。プライマリアクションが視線や親指の位置から遠い。破壊的アクションとプライマリボタンの間隔が8px未満で隣接している。パディングを増やすか、::after { inset:-8px } でヒット領域を拡大。プライマリCTAをそれが作用するコンテンツの近く、モバイルでは親指が届くゾーンに配置。破壊的アクションは分離する。
ヒックの法則 — 意思決定時間は選択肢の数と複雑さに比例するナビゲーションに7個以上のトップレベル項目がある。ソートされていない長いメニュー/セレクトがある。1つの画面に同等の重みを持つCTAが多数ある。グループ化、段階的表示(「もっと見る」)、長いリストへの検索/フィルター追加、適切なデフォルト値、1つのプライマリCTA。
選択過多価格/プランページに3~4以上の選択肢があり、おすすめがない。設定がまとまりなく表示されている。多数のフィルターが一度に表示される。おすすめオプションを強調表示、高度なオプションは折りたたむ、比較表を表示。
ドハティ閾値 — 応答時間が400ms未満で生産性が向上する非同期アクションにローディング/保留状態がない。送信時にボタンが無効化されず、進捗が表示されない。小さな読み込みに全画面スピナーを使う。楽観的更新がない。入力にブロッキングなネットワーク呼び出しがある。100ms未満の即時フィードバック、スケルトンスクリーン、楽観的UI、遅延スピナー(約300ms)、検索のデバウンス処理。
ポステルの法則 — 受け入れるものには寛容に厳格な入力形式(電話番号、日付、カード番号でスペースやダッシュを拒否)。メールアドレスが大文字小文字を区別する。トリミングがない。修正方法がわからないバリデーションエラー。ペーストがブロックされている。入力を正規化(トリム、セパレータ除去)、複数の形式を受け入れる、inputmode/autocomplete属性を使用、役立つエラーメッセージ。
テスラーの法則 — 複雑さはなくせない、移動できるだけシステムができることをユーザーが強制されている(既知のデータの再入力、値の計算、推測できるタイムゾーン/国の選択)。自動入力、スマートデフォルト、推論、最後の選択を記憶する。
アクティブユーザーのパラドックス — ユーザーはマニュアルを読まない機能がドキュメントやホバーツールチップでしか発見できない。価値を提供する前に長いオンボーディングツアーがある。空の状態にガイダンスがない。使用時点でのインラインヒント、アクション可能な空の状態、実践による学習型オンボーディング。
フロー不必要な割り込み(モーダル、元に戻せる操作の確認、強制的な再認証)。パワーユーザー向けのキーボードショートカットがない。アクション後にフォーカスが失われる。確認の代わりに元に戻す、フォーカス/スクロール位置を維持、キーボードサポート、コンテキストスイッチを最小化する。

記憶と認知

法則問題となる状況推奨される修正
ミラーの法則 / チャンキング長く分割されていないフォーム。生の長い文字列(ID、電話番号、カード番号がフォーマットされていない)。テキストの壁。10個以上のフラットな項目があるナビゲーション。フォームをグループ/ステップに分割、数字をチャンクでフォーマット、見出しと短い段落を使用。
認知負荷競合する要素で密集した画面。専門用語。同じものに対する一貫性のない用語。装飾的なごちゃごちゃ。非必須要素を削除、一貫したラベル、平易な言葉を使用。
ワーキングメモリユーザーが前の画面の情報(コード、以前の選択)を覚えておく必要がある。プレースホルダーのみのラベルで、入力中に消える。ページをまたいだ比較。コンテキストを表示し続ける(サマリー、固定ラベル、パンくずリスト)、サイドバイサイド比較。
メンタルモデル見た目と異なる動作をするコントロール(リンクのように見えるがナビゲーションを行うボタン、またはその逆)。珍しいメタファー。保存モデルが不明確(自動保存か手動か)。ユーザーの期待に合わせる。システムの状態を明示的にする。
ヤコブの法則 — ユーザーはあなたのサイトが他のサイトと同様に動作することを期待する標準的でない配置(ロゴがホームにリンクしない、カートが右上にない、検索が隠れている)。ネイティブのコントロールを代替のカスタムコントロールで置き換えるが、同等の機能がない。パターンを再発明している。プラットフォームの慣習に従う(HIG / Material / Webの基準)。まずネイティブ要素を使用する。
オッカムの剃刀冗長なステップ、重複したコントロール、プライマリ画面で誰のフローにも必要ない機能。削除するか、セカンダリサーフェスに移動する。
パレートの法則プライマリタスクが埋もれ、ほとんど使われない機能が優先スペースを占めている。80%の時間で使われる20%の機能を前面に出す。
パーキンソンの法則必要以上に時間がかかるフォーム/タスク。オートフィルがない。期待値を設定する進捗表示がない。オートコンプリート、autofill属性、推定時間/ステップを表示する。
選択的注意 / バナーブラインドネス重要な情報が広告のようにスタイルされている、またはバナー/サイドバーに配置されている。重要な警告が溶け込んでいる。キーとなる情報をタスクパスにインラインで配置し、広告のようではなく、かつ明確に区別できるようにする。
認知バイアスダークパターン:事前チェックされたオプトイン、確信犯的恥辱、隠れたコスト、偽の緊急性、誤解を招くデフォルト。排除する。正直なデフォルトにする。高優先度(倫理的および法的リスク)としてフラグを立てる。

知覚(ゲシュタルト)

法則問題となる状況推奨される修正
近接の法則ラベルが誤った入力フィールドに近い。関連のないアイテム間と関連するアイテム間の間隔が同じ。ヘルパーテキストがそのフィールドから遠い。グループ内の間隔を狭く、グループ間の間隔を広くする(間隔スケール)。
類似の法則同じように見える要素が異なる動作をする(クリック可能なテキストと静的なテキストが同一)。同じアクションレベルに一貫性のないボタンスタイル。役割ごとに一貫したビジュアル言語を使用。
共通領域の法則関連するコントロールがグループ化されていない。境界のないカードがコンテンツを混在させている。グループにはカード、セクション、背景領域を使用。
一様な連結の法則ステップや関連アイテムが視覚的にリンクされていない。ステッパー/タイムラインには線、コネクタ、共有コンテナを使用。
Prägnanzの法則過度に複雑なアイコン/イラスト、曖昧な形状。形状を単純化。ラベル付きで認識可能なアイコンを使用。
美的ユーザビリティ効果視覚的な不整合(混在した角丸、ランダムな色、不揃いのグリッド、不整合なタイプスケール)が信頼を損なう。スペーシング/タイポグラフィ/カラーをトークン化。グリッドに揃える。

順序、動機、経験の記憶

法則問題となる状況推奨される修正
フォン・レストルフ効果プライマリCTAが視覚的に区別されていない。すべてが強調されているため何も目立たない。色のみに依存している。ビューごとに1つの強調されたプライマリアクション。形状/サイズ/アイコンも使用する(アクセシビリティ)。
系列位置効果キーとなるナビゲーション項目が長いリストの真ん中にある。最も重要な情報がページの途中に埋もれている。キー項目を最初と最後に配置(例:タブバーではホームを最初、プロフィール/カートを最後に)。
ピークエンドの法則弱いまたは欠落した成功状態(フォーム送信後に何もない、または単なるリダイレクトで終了)。厳しいエラーの行き止まり。突然のフロー終了。明確で満足できる確認、エラーからの役立つ回復、最終ステップを磨き上げる。
目標勾配効果進捗表示のないマルチステップフロー。0から始まる進捗。ステッパー/プログレスバー、残りステップの表示、先行スタートを与える。
ツァイガルニク効果未完了のタスクが忘れられる(下書きがない、ナビゲーションでフォームデータが失われる、プロフィール完了を促す通知がない)。下書きの自動保存、「中断したところから続ける」、完了チェックリスト。

重大度

  • 高 — 主要タスクを妨害または大幅に遅らせる、エラーやデータ損失を引き起こす、アクセシビリティ違反、またはダークパターン。
  • 中 — 一般的なパスで顕著な摩擦や混乱を引き起こす。
  • 低 — 洗練度の問題。セカンダリ画面。

レポート形式

# UX監査 — <アプリ/画面>
スコープ: <監査対象> · 方法: コード / ライブ / スクリーンショット
スコア: <合格した法則数>/30 · 高: n · 中: n · 低: n

## 最初に修正すべきトップ3
1. ...

## 所見
### [高] フィッツの法則 — アイコンボタンが小さすぎる
場所: src/components/Toolbar.tsx:42 (Header.tsx:18 も同様)
問題: 20×20pxのアイコンボタンにパディングなし。モバイルで誤タップが発生。
修正案: `p-3`(44pxターゲット)を追加、または`::after`ヒット領域拡張を追加。
```(コードスニペット、短い場合)```

(…重大度ごとにグループ化、高優先度を先に、1つの所見につき1ブロック…)

## 合格
- ヤコブの法則 — 標準的なナビゲーションとロゴ-ホームのパターン。
- ...

## 確認不可
- ドハティ閾値 — 応答時間を測定するには実行中のアプリが必要。

ルール

  • すべての所見には、法則、場所(ファイル:行、URL + 要素、またはスクリーンショット領域)、観察された問題、および具体的な修正案が必要です。場所がない場合は報告しないでください。
  • 重複は統合します。根本原因1つにつき1つの所見とし、すべての場所をリストアップします。
  • 修正案でアプリのスタイルや個性を変更しないでください。問題を解決する最小の変更を提案してください。
  • ヤコブの法則とターゲットサイズを評価する際は、プラットフォームの慣習(iOS HIG、Material、Web)を尊重してください。
  • アクセシビリティ(コントラスト、フォーカス、ラベル)との重複は問題ありません。関連する法則の下に記載しますが、これを完全なWCAG監査にしないでください。
  • レポート後、高優先度(またはすべて)の所見を修正するかどうかを尋ねてください。モーション/フィードバックの問題(ドハティ閾値、ピークエンドの法則、目標勾配効果)が見つかった場合は、/animate-this-appで対応できることに言及してください。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル