UX Pro Max - デザインインテリジェンス は何をしますか?
Web/モバイルアプリケーション向けの包括的なデザインガイド。50以上のスタイル、97のカラーパレット、57のフォントペアリング、99のUXガイドライン、25のチャートタイプを9つのテクノロジースタックにわたって収録。優先度ベースの推奨機能を備えた検索可能なデータベースです。
適用タイミング
以下の状況でこのガイドラインを参照してください:
- 新しいUIコンポーネントやページを設計するとき
- カラーパレットやタイポグラフィを選択するとき
- UXの問題についてコードをレビューするとき
- ランディングページやダッシュボードを構築するとき
- アクセシビリティ要件を実装するとき
カテゴリ別優先度
| 優先度 | カテゴリ | 影響度 | ドメイン |
|---|---|---|---|
| 1 | アクセシビリティ | 致命的 | ux |
| 2 | タッチ&インタラクション | 致命的 | ux |
| 3 | パフォーマンス | 高 | ux |
| 4 | レイアウト&レスポンシブ | 高 | ux |
| 5 | タイポグラフィ&カラー | 中 | typography, color |
| 6 | アニメーション | 中 | ux |
| 7 | スタイル選択 | 中 | style, product |
| 8 | チャート&データ | 低 | chart |
クイックリファレンス
1. アクセシビリティ(致命的)
color-contrast- 通常テキストは最小4.5:1の比率focus-states- インタラクティブ要素に可視のフォーカスリングalt-text- 意味のある画像には説明的なaltテキストaria-labels- アイコンのみのボタンにはaria-labelkeyboard-nav- Tab順序は視覚順序と一致させるform-labels- for属性を持つlabelを使用
2. タッチ&インタラクション(致命的)
touch-target-size- 最小44x44pxのタッチターゲットhover-vs-tap- プライマリインタラクションにはクリック/タップを使用loading-buttons- 非同期処理中はボタンを無効化error-feedback- 問題の近くに明確なエラーメッセージを表示cursor-pointer- クリック可能な要素にcursor-pointerを追加
3. パフォーマンス(高)
image-optimization- WebP、srcset、遅延ロードを使用reduced-motion- prefers-reduced-motionを確認content-jumping- 非同期コンテンツのスペースを予約
4. レイアウト&レスポンシブ(高)
viewport-meta- width=device-width initial-scale=1readable-font-size- モバイルの本文テキストは最小16pxhorizontal-scroll- コンテンツがビューポート幅に収まることを確認z-index-management- z-indexスケールを定義(10, 20, 30, 50)
5. タイポグラフィ&カラー(中)
line-height- 本文テキストは1.5〜1.75を使用line-length- 1行あたり65〜75文字に制限font-pairing- 見出し/本文のフォントの個性を一致させる
6. アニメーション(中)
duration-timing- マイクロインタラクションには150〜300msを使用transform-performance- width/heightではなくtransform/opacityを使用loading-states- スケルトンスクリーンまたはスピナーを表示
7. スタイル選択(中)
style-match- 製品タイプにスタイルを一致させるconsistency- すべてのページで同じスタイルを使用no-emoji-icons- 絵文字ではなくSVGアイコンを使用
8. チャート&データ(低)
chart-type- データタイプにチャートタイプを一致させるcolor-guidance- アクセシブルなカラーパレットを使用data-table- アクセシビリティのためにテーブル代替手段を提供
使用方法
以下のCLIツールを使用して特定のドメインを検索します。
前提条件
Pythonがインストールされているか確認してください:
python3 --version || python --version
Pythonがインストールされていない場合、ユーザーのOSに基づいてインストールします:
macOS:
brew install python3
Ubuntu/Debian:
sudo apt update && sudo apt install python3
Windows:
winget install Python.Python.3.12
このスキルの使い方
ユーザーがUI/UX作業(設計、構築、作成、実装、レビュー、修正、改善)をリクエストした場合、以下のワークフローに従ってください:
ステップ 1: ユーザー要件を分析
ユーザーリクエストから重要な情報を抽出します:
- 製品タイプ: SaaS、Eコマース、ポートフォリオ、ダッシュボード、ランディングページなど
- スタイルキーワード: ミニマル、遊び心、プロフェッショナル、エレガント、ダークモードなど
- 業界: ヘルスケア、フィンテック、ゲーム、教育など
- スタック: React、Vue、Next.js、またはデフォルトは
html-tailwind
ステップ 2: デザインシステムを生成(必須)
常に --design-system から始めて、理由付きの包括的な推奨事項を取得します:
python3 skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
このコマンドは:
- 5つのドメイン(product、style、color、landing、typography)を並行検索
ui-reasoning.csvの推論ルールを適用して最適な一致を選択- 完全なデザインシステム(パターン、スタイル、カラー、タイポグラフィ、エフェクト)を返却
- 避けるべきアンチパターンも含む
例:
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
ステップ 2b: デザインシステムを永続化(マスター+オーバーライドパターン)
デザインシステムをセッションをまたいだ階層的検索のために保存するには、--persist を追加します:
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name"
これにより以下が作成されます:
design-system/MASTER.md— すべてのデザインルールを含むグローバルな信頼できる情報源design-system/pages/— ページ固有のオーバーライド用フォルダ
ページ固有のオーバーライドを使用する場合:
python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"
これにより以下も作成されます:
design-system/pages/dashboard.md— マスターからのページ固有の逸脱
階層的検索の仕組み:
- 特定のページ(例:「チェックアウト」)を構築するとき、最初に
design-system/pages/checkout.mdを確認 - ページファイルが存在する場合、そのルールがマスターファイルをオーバーライド
- 存在しない場合は
design-system/MASTER.mdのみを使用
コンテキスト対応検索プロンプト:
I am building the [Page Name] page. Please read design-system/MASTER.md.
Also check if design-system/pages/[page-name].md exists.
If the page file exists, prioritize its rules.
If not, use the Master rules exclusively.
Now, generate the code...
ステップ 3: 必要に応じて詳細検索で補完
デザインシステムを取得した後、ドメイン検索を使用して追加の詳細を取得します:
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
詳細検索を使用するタイミング:
| 必要なもの | ドメイン | 例 |
|---|---|---|
| より多くのスタイルオプション | style | --domain style "glassmorphism dark" |
| チャート推奨 | chart | --domain chart "real-time dashboard" |
| UXベストプラクティス | ux | --domain ux "animation accessibility" |
| 代替フォント | typography | --domain typography "elegant luxury" |
| ランディング構造 | landing | --domain landing "hero social-proof" |
ステップ 4: スタックガイドライン(デフォルト: html-tailwind)
実装固有のベストプラクティスを取得します。ユーザーがスタックを指定しない場合、デフォルトで html-tailwind を使用します。
python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind
利用可能なスタック:html-tailwind、react、nextjs、vue、svelte、swiftui、react-native、flutter、shadcn、jetpack-compose
検索リファレンス
利用可能なドメイン
| ドメイン | 使用目的 | キーワード例 |
|---|---|---|
product | 製品タイプの推奨 | SaaS、ecommerce、portfolio、healthcare、beauty、service |
style | UIスタイル、カラー、エフェクト | glassmorphism、minimalism、dark mode、brutalism |
typography | フォントペアリング、Google Fonts | elegant、playful、professional、modern |
color | 製品タイプ別カラーパレット | saas、ecommerce、healthcare、beauty、fintech、service |
landing | ページ構造、CTA戦略 | hero、hero-centric、testimonial、pricing、social-proof |
chart | チャートタイプ、ライブラリ推奨 | trend、comparison、timeline、funnel、pie |
ux | ベストプラクティス、アンチパターン | animation、accessibility、z-index、loading |
react | React/Next.jsパフォーマンス | waterfall、bundle、suspense、memo、rerender、cache |
web | Webインターフェースガイドライン | aria、focus、keyboard、semantic、virtualize |
prompt | AIプロンプト、CSSキーワード | (スタイル名) |
利用可能なスタック
| スタック | 焦点 |
|---|---|
html-tailwind | Tailwindユーティリティ、レスポンシブ、アクセシビリティ(デフォルト) |
react | 状態、フック、パフォーマンス、パターン |
nextjs | SSR、ルーティング、画像、APIルート |
vue | Composition API、Pinia、Vue Router |
svelte | Runes、ストア、SvelteKit |
swiftui | ビュー、状態、ナビゲーション、アニメーション |
react-native | コンポーネント、ナビゲーション、リスト |
flutter | ウィジェット、状態、レイアウト、テーマ設定 |
shadcn | shadcn/uiコンポーネント、テーマ設定、フォーム、パターン |
jetpack-compose | コンポーザブル、Modifier、状態ホイスティング、再コンポジション |
ワークフロー例
ユーザーリクエスト: 「プロフェッショナルなスキンケアサービスのランディングページを作成して」
ステップ 1: 要件を分析
- 製品タイプ: Beauty/Spaサービス
- スタイルキーワード: elegant、professional、soft
- 業界: Beauty/Wellness
- スタック: html-tailwind(デフォルト)
ステップ 2: デザインシステムを生成(必須)
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
出力: パターン、スタイル、カラー、タイポグラフィ、エフェクト、アンチパターンを含む完全なデザインシステム。
ステップ 3: 必要に応じて詳細検索で補完
# アニメーションとアクセシビリティのUXガイドラインを取得
python3 skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux
# 必要に応じて代替タイポグラフィオプションを取得
python3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
ステップ 4: スタックガイドライン
python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind
その後: デザインシステム + 詳細検索を統合してデザインを実装します。
出力フォーマット
--design-system フラグは2つの出力フォーマットをサポートしています:
# ASCIIボックス(デフォルト) - ターミナル表示に最適
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
# マークダウン - ドキュメントに最適
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
より良い結果を得るためのヒント
- キーワードは具体的に -「healthcare SaaS dashboard」 > 「app」
- 複数回検索する - 異なるキーワードで異なる洞察が得られます
- ドメインを組み合わせる - スタイル+タイポグラフィ+カラー=完全なデザインシステム
- 常にUXを確認 - 「animation」、「z-index」、「accessibility」を検索して一般的な問題をチェック
- スタックフラグを使用 - 実装固有のベストプラクティスを取得
- 繰り返す - 最初の検索が合わない場合、別のキーワードを試す
プロフェッショナルUIのための共通ルール
これらは、UIがプロフェッショナルに見えなくなる原因として頻繁に見落とされる問題です:
アイコンと視覚要素
| ルール | 推奨 | 非推奨 |
|---|---|---|
| 絵文字をアイコンにしない | SVGアイコン(Heroicons、Lucide、Simple Icons)を使用 | UIアイコンとして🎨 🚀 ⚙️などの絵文字を使用しない |
| 安定したホバー状態 | ホバー時にカラー/不透明度のトランジションを使用 | レイアウトを動かすscale変換を使用しない |
| 正しいブランドロゴ | Simple Iconsから公式SVGを調査 | ロゴパスを推測したり間違ったものを使わない |
| 一貫したアイコンサイズ | 固定viewBox(24x24)とw-6 h-6を使用 | 異なるアイコンサイズをランダムに混在させない |
インタラクションとカーソル
| ルール | 推奨 | 非推奨 |
|---|---|---|
| カーソルポインター | すべてのクリック可能/ホバー可能なカードに cursor-pointer を追加 | インタラクティブ要素にデフォルトカーソルのままにする |
| ホバーフィードバック | 視覚的なフィードバック(色、影、枠線)を提供 | 要素がインタラクティブであることを示さない |
| スムーズなトランジション | transition-colors duration-200 を使用 | 瞬間的な状態変化、または遅すぎる(>500ms) |
ライト/ダークモードのコントラスト
| ルール | 推奨 | 非推奨 |
|---|---|---|
| ライトモードのガラスカード | bg-white/80 以上の不透明度を使用 | bg-white/10(透過しすぎ)を使用しない |
| ライトモードのテキストコントラスト | テキストに #0F172A (slate-900) を使用 | 本文テキストに #94A3B8 (slate-400) を使用しない |
| ライトモードの控えめテキスト | 最低でも #475569 (slate-600) を使用 | gray-400 またはそれより薄い色を使用しない |
| 境界線の視認性 | ライトモードで border-gray-200 を使用 | border-white/10(見えない)を使用しない |
レイアウトとスペーシング
| ルール | 推奨 | 非推奨 |
|---|---|---|
| フローティングナビバー | top-4 left-4 right-4 のスペーシングを追加 | ナビバーを top-0 left-0 right-0 に固定しない |
| コンテンツパディング | 固定ナビバーの高さを考慮 | コンテンツが固定要素の背後に隠れないようにする |
| 一貫した最大幅 | 同じ max-w-6xl または max-w-7xl を使用 | 異なるコンテナ幅を混在させない |
納品前チェックリスト
UIコードを提供する前に、以下の項目を確認してください:
視覚的品質
- アイコンとして絵文字を使用していない(代わりにSVGを使用)
- すべてのアイコンが一貫したアイコンセット(Heroicons/Lucide)からのものである
- ブランドロゴが正しい(Simple Iconsから確認済み)
- ホバー状態がレイアウトシフトを引き起こさない
- テーマカラーを直接使用(bg-primary)、var() ラッパーは不使用
インタラクション
- すべてのクリック可能な要素に
cursor-pointerがある - ホバー状態が明確な視覚的フィードバックを提供する
- トランジションがスムーズ(150〜300ms)
- キーボードナビゲーション用にフォーカス状態が可視である
ライト/ダークモード
- ライトモードのテキストに十分なコントラストがある(最低4.5:1)
- ガラス/透明要素がライトモードで可視である
- 境界線が両方のモードで可視である
- 納品前に両方のモードをテストする
レイアウト
- フローティング要素が端から適切なスペーシングを持っている
- 固定ナビバーの背後にコンテンツが隠れていない
- 375px、768px、1024px、1440pxでレスポンシブである
- モバイルで水平スクロールが発生しない
アクセシビリティ
- すべての画像にaltテキストがある
- フォーム入力にラベルがある
- 色だけが唯一の指標ではない
-
prefers-reduced-motionが尊重されている