Communitygithub.com

UI/UXデザイン

ウェブアプリ、SaaS B2B、ダッシュボード、フォーム、テーブル、モバイル向けのインターフェースを、ユーザビリティと検証可能なビジュアルデザインの基準(ニールセンのヒューリスティック、UXの法則、Refactoring UI、人間中心設計、WCAG 2.2 AA、エビデンスに基づくパターン)に従って設計、実装、レビュー、批評します。コードでUIを作成・修正する際、画面やスクリーンショットのレビュー依頼、ヒューリスティック評価やアクセシビリティ評価、2つのデザイン間の比較、フォーム・空状態・ローディング状態・エラー状態・テーブル・ダッシュボードの設計、マイクロコピーの作成、機能リクエストのフロー変換、ユーザビリティテストの準備などに使用します。「UX」や「デザイン」という言葉が明示されていなくても、結果を人が画面で使用する場合は常にこのスキルを適用します。

UXデザイン とは?

このスキルは、UI/UXデザインに関する包括的な知識と実践的なガイドラインを提供します。主にニールセンの10のヒューリスティックス、UXの法則(ヤブロンスキー)、Refactoring UIの戦術的アドバイス、WCAG 2.2 AAアクセシビリティ基準、そしてNN/g、GOV.UK、Baymardなどのエビデンスに基づくパターンを統合しています。このスキルは、プロジェクトのデザインシステムと指示(CLAUDE.md、トークン、プリミティブ、ブランドガイド)を最優先し、その上でアクセシビリティルール(WCAG 2.2 AA、ユーザーを欺かないこと)、エビデンス(NN/g、Baymard、GOV.UK、ISO規格)、そしてRefactoring UIなどの職人技の順に優先順位が設定されています。ユーザーからのリクエストは常に「誰が、なぜ、どのような状況で」というニーズに再構成し、理想的なパスだけでなく、ローディング、エラー、空などのすべての状態を設計することを求めます。このスキルはコード(React、Tailwind CSSなど)での実装、画面やスクリーンショットのレビュー、デザイン案の比較、フローワイヤーフレームの作成など、さまざまな作業に対応しており、具体的で検証可能な推奨事項を提供し、常に優先順位を明示します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JVISERASS/ui-ux-design/tree/main

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

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

ドキュメント

UXデザイン は何をしますか?

パーソナルスキル。3冊の本(Lowdermilk『ユーザー中心設計』、Yablonski『UXの法則』、Wathan & Schoger『Refactoring UI』)とNN/g、WCAG 2.2、公開デザインシステムを独自の言葉で要約。詳細、出典、未検証のものは references/ にあり。このファイルは常に頭に入れておくべき内容。

0. 優先順位

2つのアドバイスが衝突した場合、上位のものが優先される:

  1. プロジェクトのデザインシステムと指示(CLAUDE.md、トークン、プリミティブ、ブランドガイド)。プロジェクトが「角丸0、影なし」と言っているなら、Refactoring UIが影を推奨しても提案しない。奥行きはシステムが許可する方法(罫線、背景、スペース)で実現する。新しいものを発明する前に、既存のトークンとコンポーネントを読むこと。
  2. ハードルール:WCAG 2.2 AAアクセシビリティとユーザーを欺かないこと。プロジェクトのシステムがコントラストやフォーカスに違反している場合は、WCAGの基準とシステム内の代替案を指摘する。
  3. エビデンス:データに基づく研究とガイドライン(NN/g、Baymard、GOV.UK、ISO規格)。
  4. 職人技:Refactoring UIや類似の戦術的アドバイス。デフォルトでは良いが、絶対的な法則ではない。

推奨事項がどのレベルに属するかを常に明記すること:「WCAG 1.4.3(必須)」と「通常はこの方が見栄えが良い」は重みが異なる。

1. 描画前のニーズ確認

リクエストは解決策として届くことが多い(「CSVエクスポートを追加」「ここにボタンを配置」)。その背後にはニーズがあり、文字通りの解決策を設計すると、より多くの画面領域を消費し、より悪い結果を生む傾向がある。そのため、設計前に:

  • リクエストを再構成する:[状況]のとき、[人物]が[結果]を[理由]で望む。状況や理由が埋められない場合は、質問するか仮定を宣言する。
  • 使用状況(ISO 9241-11):誰が、どのタスクを、どこで、何を使って(太陽の下のモバイル、デュアルモニターのデスクトップ、日常的なエキスパートまたは年1回の利用)。「使いやすい」は抽象的な概念ではなく、常に誰か、タスク、コンテキストに対して定義される。
  • 現在の回避策を探す(Excel、WhatsApp、紙):これが本当に必要なものの最良の仕様である。
  • より少ないインターフェースで同じニーズを解決する代替案を少なくとも1つ提示する(存在する場合)。
  • まずはハッピーパス、その直後に状態:ローディング、空(初回/フィルター/権限なし)、エラー、成功、部分。状態のない画面は設計されていない。

インタビュー、ユーザビリティテスト、ユーザー数、メトリクス、SUSについては → references/centrado-en-usuario.md。

2. 構造とインタラクション(ユーザビリティに最も影響するもの)

ニールセンのヒューリスティックス、一覧チェックリスト:

  1. システム状態の可視性:システムが何が起こっているかを伝える(保存中、保存済み、ロード中、エラー)。
  2. システムと現実世界との一致:データモデルではなくユーザーの言葉を使う。
  3. ユーザーの制御と自由度:元に戻す、キャンセル、戻る。
  4. 一貫性と標準:同じものは同じに見え、同じ動作をし、慣習を尊重する。
  5. エラーの防止:制約、適切なデフォルト値、さまざまな形式の受け入れ。
  6. 記憶よりも認識。
  7. 初心者を妨げずにエキスパート向けのショートカットを提供。
  8. ミニマリストデザイン:各要素は他の要素と競合する。
  9. エラーを明確に示し、修復方法を提案する。
  10. ヘルプとドキュメント。

最もよく使われるUXの法則とその限界:

法則適用注意点
ヤコブ慣習的なパターン;ナビゲーションではなく価値において革新する業界の慣習(ERP、CAD)は一般的なウェブの慣習よりも優先される
フィッツ注目領域の近くに大きなターゲットを配置;最終フィールドの横に送信ボタン「無限大」のコーナーはマウスでのみ有効で、タッチでは無効
ヒック急ぎの場合は選択肢を減らす;推奨オプションを強調;段階的に表示既知のオプションから選択する場合にのみ有効;検索の場合は組織化(順序、グループ、検索)が優先
ミラー/ワーキングメモリチャンキングでグループ化;システムがユーザーの代わりに記憶「7±2」はメニューを制限しない:表示されているものはメモリに負荷をかけない。実際の容量は約4ブロック(Cowan)
テスラー複雑さはシステムが吸収する(デフォルト値、オートコンプリート、計算)隠すことは簡略化ではない:複雑さを移動させるだけ
ポステルさまざまな形式を受け入れ、正規化する受け入れることは黙って推測することではない:曖昧な場合は解釈を表示するか質問する
ピークエンド最も価値のある瞬間と終了時に注意を払う;ネガティブなピークに注意—
フォン・レストルフゾーンごとに1つの強調要素のみすべてを強調すると何も強調されず、広告のように見える可能性がある
応答時間<0.1秒:処理不要;~1秒:軽いフィードバック;2~10秒:スケルトンまたはスピナー;>10秒:% + キャンセルDohertyの「400ms」は1982年の元のレポートには記載されていない;代わりにNielsenの0.1/1/10秒を使用
ゴールグラディエント長いプロセスでは進行状況を表示し、正直に保つ虚偽の進行状況は欺瞞的なパターンである

30の法則、状況別マップ(フォーム、オンボーディング、チェックアウト、テーブル、モバイルなど)、悪用例については → references/leyes-ux.md。

エビデンスに基づくパターン(詳細と出典は → references/patrones.md):

  • フォーム:ラベルは上部に表示し、常に可視(プレースホルダーをラベルとして使用しない);1列;正しい autocomplete と inputmode;電話番号、日付、IBANを複数のフィールドに分割しない;フィールド離脱時または送信時に検証し、修正されたらすぐにエラーを削除(「早く報い、遅く罰する」);エラーはフィールドの横に表示し、何が起こったかと修復方法をラベルの言葉で説明;常に入力内容を保持。
  • ボタン:動詞+目的語(「OK」ではなく「請求書を保存」);ビューごとに1つのプライマリボタン;理由を説明しない無効化ボタンは避ける(クリックを許可し、説明する方が良い);二重送信を防止。
  • 破壊的操作:確認よりも元に戻す;取り返しのつかない操作のみ確認し、失われるものを明示し、アクションを含むボタン(「3件の請求書を削除」/「保持」)を使用。Yes/Noは使用しない。
  • 空状態:空であること(ローディングではない)、ここに何が表示されるか、開始ボタンを表示;何もない間はフィルターと並び替えを非表示にする。
  • テーブル:最初の列に読み取り可能な識別子;数値は tabular-nums で右揃え、小数点以下桁数を統一;固定ヘッダー;アクティブなフィルターが表示された状態でフィルターを可視に;行アクションはマウスホバー時だけでなく常に可視;ドラッグの代替手段。モバイル:レコード確認用カード、比較用に最初の列を固定したテーブル。
  • ダッシュボード:1つのタスク;各数値に比較、単位、期間を含む;円グラフや速度計よりも棒グラフと折れ線グラフ;色には意味を持たせ、唯一の手がかりにしない。
  • ナビゲーション:デスクトップでは可視(ハンバーガーメニューは発見性を低下させる);モバイルでは3~5つのアイコン+テキストの下部ナビゲーションバー;頻繁に使用するものは到達可能なゾーンに、重要なものは上部コーナーに配置しない。
  • マイクロコピー:重要な要素は最初の2語に;単語数を半分に削減;スキャン可能なサブタイトル;能動態の短い文;「お願いします」「おっと」「無効」は使用しない。

3. ビジュアルデザイン(Refactoring UIの要点)

値とCSS/Tailwindの詳細は → references/diseno-visual.md(§11がチートシート)。

  • レイアウトではなく機能から始める、そしてグレースケールで:グレーで階層が機能しない場合、色では修正できない。色は最後に追加する。
  • 値よりもシステム:間隔、フォントサイズ、色、影、角丸の固定スケールを定義し、それらから選択して決定する。コードではトークンを使用;理由のない恣意的な値(p-[13px])は使用しない。
  • サイズではなく、ウェイトと色で階層を作る:2~3のテキストトーン(プライマリ、セカンダリ、ターシャリ)と2つのウェイト(標準とセミボールド/ボールド);400未満は使用しない。何かを強調することは、多くの場合、競合するものを薄くすることである。
  • ラベルは最後の手段:それ自体で説明可能な形式(「在庫:12」よりも「12点在庫あり」);ラベルが必要な場合は値よりも軽くする。セクションタイトルは小さなラベルとして機能することが多い:視覚的な階層は h1…h6 の階層に従う必要はない。
  • スペーシング:多すぎるくらいの余白から始めて削る;非線形スケール(4, 8, 12, 16, 24, 32, 48, 64, 96…)で、各ステップが次のステップの約25%未満にならないようにする;グループ間のスペースはグループ内よりも広くする(ラベルはフィールドに近接)。
  • 幅:画面全体に引き伸ばさない;コンポーネントごとに max-width を設定;段落は45~75文字;サイドバーは固定幅、コンテンツはフレキシブル。
  • テキスト:手動で作成したタイポグラフィスケール(12/14/16/18/20/24/30/36/48…)をpxまたはremで使用(emは不可);本文は約1.5、見出しは約1~1.25の行間;大きな見出しはトラッキングをやや詰め、大文字はトラッキングを広く;異なるサイズを混在させる場合はベースラインを揃える;テキストの中央揃えは2~3行のみ。
  • 色:8~10のグレー(わずかに色味を帯びたもの)と、色ごとに5~10のトーン(100~900)を事前に定義。できればOKLCH(知覚的に均一な明るさ)で;両端でクロマを高く;色付き背景にグレーテキストは絶対に使用しない(同じ色のトーンを使用);バッジは反転コントラスト(薄い色付き背景と濃い同色テキスト);色は唯一の合図として使用しない。
  • 重要度に基づくボタン、セマンティクスではない:プライマリは塗りつぶし、セカンダリはアウトラインまたは薄い塗りつぶし、ターシャリはリンク風。破壊的操作は、それが主要なアクションである場合(確認ダイアログの最終ボタン)にのみ大きく赤くする。
  • 奥行き(システムがサポートする場合):上からの光;約5つの影(2層);境界線を減らす(スペース、背景、または影で分離);アクセントボーダーで色を追加。影なし:背景の違いと細い罫線。
  • 画像:アイコンはスケーリングしない(背景付きの形状に配置);ユーザーがアップロードした画像は object-fit: cover の固定コンテナに配置;画像上のテキストにはコントラストを保証するオーバーレイが必要。
  • ダークモード:セマンティックトークンを再割り当てし、反転させない;浮上レベルに応じて明るくなる表面;彩度を抑えたアクセント。
  • 数字:比較または更新されるものすべてに font-variant-numeric: tabular-nums を使用。

4. アクセシビリティ:譲れない最低限

WCAG 2.2 AAが目標(EUではEN 301 549 V4.1.1が要求)。A/AAの55の基準、ARIA、モーダル、ライブリージョン、テスト手順を含む完全なチェックリストは → references/accesibilidad.md。

  • ARIAよりもネイティブHTML(button、a href、label、fieldset、dialog);クリック可能な div はゼロ。
  • コントラスト:テキスト ≥ 4.5:1;大きいテキスト(≥ 24px、または太字で≥ 18.66px)、入力ボーダー、情報を伝えるアイコン、フォーカスは ≥ 3:1。WCAG 2.xの計算式で測定(APCAではない)。
  • 完全なキーボード操作;可視フォーカス(:focus-visible)、ヘッダーや固定バーで隠れない(scroll-padding);モーダル内にフォーカスを閉じ込め、Escで閉じ、閉じた後はフォーカスを元の場所に戻す。
  • ターゲットサイズ ≥ 24×24 px CSS(法的最低限);タッチでは44~48 pxで設計。
  • ドラッグするものすべてにドラッグなしの代替手段がある(カンバン、並べ替え、スライダー)。
  • エラーはフィールドの横にテキストで表示し、aria-invalid と aria-describedby を使用;色だけに依存しない。
  • 非同期状態は role="status"(緊急の場合は alert)で通知し、リージョンは事前にマウントしておく。
  • ログイン:ペースト可能;autocomplete を username、current-password、one-time-code で使用;認知テストは不要。
  • 同じプロセス内で既に入力された情報を再要求しない。
  • 320pxで水平スクロールなしでリフロー(データテーブルを除く);200%ズーム;prefers-reduced-motion。
  • axeが緑でもアクセシブルとは限らない:GOV.UKの調査では、最良のツールでもバリアの約41%しか検出できなかった(すべてのツールを組み合わせて約71%)。Dequeはaxeがインシデントの約57%を検出すると推定。キーボードでの操作とスクリーンリーダーでの簡単なテストも必要。

5. リクエストに応じた作業方法

コードでのUI実装または改善

  1. プロジェクトのデザインシステム(トークン、プリミティブ、既存の類似コンポーネント)を読み、作成する前に再利用する。
  2. ニーズ、コンテキスト、状態を記述する(§1)。
  3. まずグレースケールで機能と階層を構築;その後、トークンを使用してスペーシング、タイポグラフィ、色を追加。
  4. 状態をカバーする:default、hover、focus-visible、active、disabled(理由付き)、loading、空、エラー、成功。
  5. 確認:モバイル幅(320~380 px)とデスクトップ、キーボード、コントラスト、長いテキストまたは極端なデータ(60文字の名前、7桁の金額、0行と500行のリスト)。ブラウザが利用可能な場合は実際の画面を確認:スクリーンショットはコードでは見えないものを明らかにする。

画面、スクリーンショット、PRのレビュー

§2~§4を実行し、以下を返す:

  1. 要約:2~3行で、何が機能しているかと最もコストのかかる問題。
  2. 発見事項:重大度順(Nielsenスケール:4 壊滅的、公開前に修正 · 3 メジャー · 2 マイナー · 1 コスメティック)。各項目に:場所、違反している原則(ヒューリスティック、法則、またはWCAG基準番号)、影響を受けるユーザーとその影響、具体的な修正(値、コンポーネント、コピー)、必須と好みを区別。重大度は単一評価者によるものであることを宣言。
  3. クイックフィックス:最大5つ、最も影響が大きく労力が少ないもの。
  4. 未解決の質問:データまたはユーザーによってのみ解決できるもの。

代替案間の決定

主なタスクとコンテキスト(§1)に対して比較し、好みで判断しない。差異が実際の動作に依存する場合は、その旨を伝え、それを解決するための最も安価なテスト(5ユーザーテスト、A/Bテスト、分析)を提案する:references/centrado-en-usuario.md §5。

コードなしでの設計(フローまたはワイヤーフレーム)

再構成されたニーズ、ハッピーパスのフローとその状態、各画面の構造(決定ごとに原則を付けて)、ユーザー検証が必要な事項を納品する。

6. 行動ルール

  • 一般的な表現よりも具体的に:「コントラストを改善」ではなく、「Tailwind v3のセカンダリテキストを gray-400 から gray-600 に上げる(2.5:1 → 7.6:1、白地;WCAG 1.4.3は4.5:1を要求)」のように言う。
  • 推奨事項ごとに理由を1行添え、出典を明記する。
  • トークンを使用する:CSSの生の値ではなく、デザイントークン(--color-text-secondary、spacing-4)を参照する。
  • 解決策の範囲を理解する:このガイドはすべてのUIをカバーするものではなく、十分な情報に基づいた決定を下すための枠組みを提供する。答えるよりも質問することが重要。

関連スキル