UI/UX Pro Max - デザインインテリジェンス
ウェブおよびモバイルアプリケーション向けの包括的なデザインガイド。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/agentup-frontend/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
このコマンドは:
- 5つのドメインを並行検索(product、style、color、landing、typography)
ui-reasoning.csvの推論ルールを適用して最適な一致を選択- 完全なデザインシステム(パターン、スタイル、色、タイポグラフィ、エフェクト)を返す
- 避けるべきアンチパターンも含む
例:
python3 skills/agentup-frontend/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
ステップ2b:デザインシステムの永続化(Master + Overridesパターン)
デザインシステムを セッション間で階層的に取得 するために保存するには、--persist を追加:
python3 skills/agentup-frontend/scripts/search.py "<query>" --design-system --persist -p "Project Name"
これにより以下が作成される:
design-system/MASTER.md— すべてのデザインルールを含むグローバルな唯一の情報源design-system/pages/— ページ固有のオーバーライド用フォルダ
ページ固有のオーバーライドを使用する場合:
python3 skills/agentup-frontend/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"
これにより以下も作成される:
design-system/pages/dashboard.md— Masterからのページ固有の逸脱
階層的取得の仕組み:
- 特定のページ(例:「チェックアウト」)を構築する場合、最初に
design-system/pages/checkout.mdを確認 - ページファイルが存在する場合、そのルールがMasterファイルを オーバーライド する
- 存在しない場合、
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/agentup-frontend/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/agentup-frontend/scripts/search.py "<keyword>" --stack html-tailwind
利用可能なスタック:html-tailwind、react、nextjs、vue、svelte、swiftui、react-native、flutter、shadcn、jetpack-compose
検索リファレンス
利用可能なドメイン
| ドメイン | 用途 | キーワード例 |
|---|---|---|
product | プロダクトタイプの推奨 | SaaS、e-commerce、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ユーティリティ、レスポンシブ、a11y(デフォルト) |
react | 状態、フック、パフォーマンス、パターン |
nextjs | SSR、ルーティング、画像、APIルート |
vue | Composition API、Pinia、Vue Router |
svelte | Runes、ストア、SvelteKit |
swiftui | Views、State、Navigation、Animation |
react-native | コンポーネント、ナビゲーション、リスト |
flutter | ウィジェット、状態、レイアウト、テーマ設定 |
shadcn | shadcn/uiコンポーネント、テーマ設定、フォーム、パターン |
jetpack-compose | コンポーザブル、Modifier、ステートホイスティング、リコンポジション |
ワークフロー例
ユーザーリクエスト: 「プロフェッショナルなスキンケアサービスのランディングページを作成して」
ステップ1:要件の分析
- プロダクトタイプ:ビューティー/スパサービス
- スタイルキーワード:エレガント、プロフェッショナル、ソフト
- 業界:ビューティー/ウェルネス
- スタック:html-tailwind(デフォルト)
ステップ2:デザインシステムの生成(必須)
python3 skills/agentup-frontend/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
出力: パターン、スタイル、色、タイポグラフィ、エフェクト、アンチパターンを含む完全なデザインシステム。
ステップ3:詳細検索での補足(必要に応じて)
# アニメーションとアクセシビリティのUXガイドラインを取得
python3 skills/agentup-frontend/scripts/search.py "animation accessibility" --domain ux
# 必要に応じて代替タイポグラフィオプションを取得
python3 skills/agentup-frontend/scripts/search.py "elegant luxury serif" --domain typography
ステップ4:スタックガイドライン
python3 skills/agentup-frontend/scripts/search.py "layout responsive form" --stack html-tailwind
その後: デザインシステム + 詳細検索を統合し、デザインを実装。
出力フォーマット
--design-system フラグは2つの出力フォーマットをサポート:
# ASCIIボックス(デフォルト) - ターミナル表示に最適
python3 skills/agentup-frontend/scripts/search.py "fintech crypto" --design-system
# Markdown - ドキュメントに最適
python3 skills/agentup-frontend/scripts/search.py "fintech crypto" --design-system -f markdown
より良い結果を得るためのヒント
- キーワードを具体的に - 「ヘルスケアSaaSダッシュボード」 > 「アプリ」
- 複数回検索する - 異なるキーワードで異なるインサイトが得られる
- ドメインを組み合わせる - スタイル + タイポグラフィ + カラー = 完全なデザインシステム
- 常にUXをチェック - 一般的な問題について「アニメーション」、「z-index」、「アクセシビリティ」を検索
- スタックフラグを使用 - 実装固有のベストプラクティスを取得
- 反復する - 最初の検索で一致しない場合は、異なるキーワードを試す
プロフェッショナルUIのための共通ルール
以下は、UIをプロフェッショナルに見せなくする、見落とされがちな問題です:
アイコンとビジュアル要素
| ルール | 推奨 | 非推奨 |
|---|---|---|
| 絵文字アイコン禁止 | SVGアイコンを使用(Heroicons、Lucide、Simple Icons) | UIアイコンとして🎨 🚀 ⚙️などの絵文字を使用 |
| 安定したホバー状態 | ホバー時にカラー/不透明度のトランジションを使用 | レイアウトを変動させるスケール変換を使用 |
| 正しいブランドロゴ | 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が尊重されている