Communitygithub.com

Omar-Obando/qwen-orchestrator

プロフェッショナルなデザインシステム。カラーパレットのルール、タイポグラフィ、スペーシング、マルチページアーキテクチャ、サービス/プロダクト詳細ページ、ナビゲーション制限、絵文字禁止ポリシー、セクションスペーシング、デプロイガイド(Astro + Cloudflare)を提供します。個別のサービス/プロダクトページを備えたマルチページWebサイト構造を強制します。

qwen-orchestrator とは?

このスキルは、プロフェッショナルなデザインシステムを強制するルールセットを提供します。具体的には、カラーパレット、タイポグラフィ、セクション間の適切なスペーシング、ナビゲーション項目の最大7つまでの制限、絵文字の完全な禁止、そして何よりもマルチページWebサイトのアーキテクチャを重視します。ユーザーが「Webサイト」を要求した場合、単一のランディングページを作成することを禁止し、ホーム、アバウト、サービス一覧、サービス詳細、プロダクト一覧、プロダクト詳細、コンタクトなどの標準的なページ構成を必須とします。各サービスやプロダクトには、詳細な説明、プロセス、納品物、価格帯、FAQ、CTAを備えた個別の専用ページが必要です。推奨フレームワークはAstroで、Cloudflare Pagesへのデプロイを推奨します。これにより、パフォーマンス、SEO、拡張性に優れた本格的なWebサイトを構築できます。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Omar-Obando/qwen-orchestrator/tree/HEAD/skills/design-system

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

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

ドキュメント

デザインシステムスキル — プロフェッショナルUI/UX、スペーシング&マルチページアーキテクチャ

このスキルは、適切なカラーパレット、タイポグラフィ、セクションスペーシング、ナビゲーション制限、詳細なサービス/プロダクトページ、絵文字ゼロ、マルチページWebサイトアーキテクチャといったプロフェッショナルなデザイン基準を強制します。推奨スタック:静的/コンテンツサイト向けのAstro、デプロイ先はCloudflare Pages。

⚠️ 必須: マルチページWebサイトルール

ユーザーがWebサイトを要求した場合、決して単一のランディングページを作成しないでください。

ユーザーがWebサイト(例:「マーケティングエージェンシーのサイト」「レストランのサイト」「会社のサイト」)を要求した場合、最低限以下のページを含む完全なマルチページWebサイトを作成する必要があります。

標準のWebサイトページ(必須)

ページ目的優先度
ホームヒーロー、バリュープロポジション、主要セクション、CTA必須
アバウト会社のストーリー、チーム、ミッション、バリュー必須
サービス詳細ページへのリンク付きサービス一覧ページ必須
サービス詳細サービスごとの個別ページ(例:/services/web-design)必須
コンタクトお問い合わせフォーム、地図、電話、メール、営業時間必須
プロダクト/ポートフォリオ詳細ページへのリンク付きプロダクト一覧ページ必須

サービスページ — 詳細(汎用的ではない)

すべてのサービスには、独自の専用ページが必要です。 サービス一覧ページは、個別の詳細ページにリンクするカード/サマリーを表示します。

❌ 禁止:
- すべてのサービスが一覧にされているが、個別ページがない/servicesページ
- 短い説明のみの汎用的な/servicesページが1つだけ
- サービスが2〜3行のテキストでしか説明されていない
- サービスごとに価格、プロセス、納品物がない

✅ 必須の構造:
/services              → 一覧ページ(画像 + タイトル + 抜粋 + CTA付きカード)
/services/web-design   → 詳細ページ(説明、プロセス、納品物、価格、FAQ、CTA)
/services/seo          → 詳細ページ(説明、プロセス、納品物、価格、FAQ、CTA)
/services/social-media → 詳細ページ(説明、プロセス、納品物、価格、FAQ、CTA)

各サービス詳細ページには以下を含める必要があります:

  • 説明: サービスを説明する3〜5段落
  • プロセス: ステップバイステップ(1. ディスカバリー → 2. デザイン → 3. 開発 → 4. ローンチ)
  • 納品物: クライアントが受け取るもの
  • 価格帯 または「〜から」価格(またはカスタム見積もりのCTA)
  • FAQセクション: 3〜5のよくある質問
  • CTA: 「見積もりを依頼」「相談を予約」「プロジェクトを開始」
  • お客様の声やケーススタディ(利用可能な場合)

プロダクトページ — 詳細(汎用的ではない)

すべてのプロダクトには、独自の専用ページが必要です。 プロダクト一覧ページは、個別の詳細ページにリンクするカードを表示します。

❌ 禁止:
- シンプルなリストやグリッドのみで、詳細ページがない /products ページ
- 仕様なしの1つのカードで説明されているプロダクト
- プロダクトごとに価格、機能、画像がない

✅ 必須の構造:
/products              → 一覧ページ(画像 + 名前 + 価格抜粋 + CTA付きカード)
/products/product-a    → 詳細ページ(ギャラリー、完全な説明、仕様、価格、レビュー、関連商品)
/products/product-b    → 詳細ページ(ギャラリー、完全な説明、仕様、価格、レビュー、関連商品)

各プロダクト詳細ページには以下を含める必要があります:

  • 画像ギャラリー: 3〜5枚のプロダクト画像
  • 完全な説明: 機能、仕様、素材
  • 価格: 明確な価格表示
  • CTA: 「カートに入れる」「見積もりを依頼」「今すぐ購入」
  • 関連プロダクトセクション
  • レビュー/お客様の声(利用可能な場合)

追加ページ(ビジネスタイプに基づく)

ビジネスタイプ追加ページ
エージェンシーポートフォリオ、ケーススタディ、チーム、プロセス、価格
レストランメニュー、予約、ギャラリー、シェフ/ストーリー、プライベートイベント
Eコマースショップ、プロダクト詳細、カート、チェックアウト、アカウント、ウィッシュリスト
SaaS機能、価格、ドキュメント、ブログ、チェンジログ、ステータス
ポートフォリオプロジェクト、自己紹介、履歴書/CV、お客様の声、お問い合わせ
不動産物件一覧、物件詳細、エージェント、近隣情報、住宅ローン計算機
ヘルスケアサービス、医師/チーム、予約、患者ポータル、所在地
教育プログラム、コース、教員、入学案内、キャンパスライフ、カレンダー
法律業務分野、弁護士、お客様の声、リソース、無料相談
非営利ミッション、プログラム、インパクト、参加方法、寄付、イベント

ページについて質問するタイミング

AskUserQuestion を使用してページ構成を確認します:

AskUserQuestion({
  questions: [
    {
      question: "Webサイトに含めるページはどれですか?",
      header: "ページ",
      options: [
        { label: "フルサイト", description: "ホーム + アバウト + サービス + プロダクト + コンタクト(推奨)" },
        { label: "スタンダード", description: "ホーム + アバウト + サービス + コンタクト" },
        { label: "拡張", description: "フルサイト + ブログ + FAQ + ポートフォリオ + 価格" }
      ]
    }
  ]
})

アンチパターン: 単一ランディングページ

❌ 禁止(ユーザーが「Webサイト」を要求した場合):
- index.html だけを作成すること
- すべてのコンテンツを1つのスクロール可能なページにまとめること
- 単一のHTMLファイルを「Webサイト」と呼ぶこと
- セクションをページとして扱うこと(例:#about, #services, #contact)

✅ 必須:
- セクションごとに個別のルート/ページ(例:/about, /services, /contact)
- 各ページが独自のレイアウト、メタタグ、SEO最適化を持つこと
- すべてのページにリンクするナビゲーションメニュー
- 共有のヘッダー/フッターコンポーネント
- すべてのページで一貫したデザインシステム
- 各サービスとプロダクトに個別の詳細ページ

唯一の例外: ユーザーが明示的に「ランディングページ」または「ワンページサイト」と言った場合。


⚠️ 必須: 絵文字禁止ポリシー

プロフェッショナルなWebサイトで絵文字を使用してはいけません。絶対にです。

❌ 禁止:
- 🚀 🎯 💡 ✨ 🏆 📱 💻 🛒 📧 📞 ✅ ❌ 🔥 ⭐ 💪 🎨 📊 🔒 🌍 などの絵文字をWebサイトのどこにも使用しないこと
- セクションアイコンとしての絵文字
- 見出し、ボタン、CTAでの絵文字
- ナビゲーションラベルでの絵文字
- メタタイトルやメタディスクリプションでの絵文字

✅ 必須:
- アイコンライブラリ(Lucide、Heroicons、Phosphor、Tabler)のSVGアイコンを使用する
- 視覚的な興味を引くためにCSSシェイプや装飾要素を使用する
- 適切なアイコンコンポーネント(<svg>またはアイコンフォント)を使用する
- すべての見出し、ボタン、ラベルにプレーンテキストを使用する

アイコンライブラリ(1つを使用し、一貫性を保つこと):

ライブラリインストールスタイル最適な用途
Lucidenpm install lucide-reactクリーンでモダンほとんどのWebサイト
Heroiconsnpm install @heroicons/react太字で明確ダッシュボード、SaaS
Phosphornpm install @phosphor-icons/react柔軟、6ウェイト汎用性の高いプロジェクト
Tablernpm install @tabler/icons-reactアウトライン管理パネル

⚠️ 必須: セクションスペーシング

セクションが互いに接触してはいけません。すべてのセクションに余裕が必要です。

最小スペーシングルール

要素最小パディング(上下)CSS変数
ページセクションvar(--space-20) (80px)--section-padding
ヒーローセクションvar(--space-32) (128px)--hero-padding
フッター上部パディングvar(--space-32) (128px)--footer-padding
ヘッダーの高さvar(--space-16) (64px)--header-height
コンテンツブロック間var(--space-12) (48px)--block-gap
CTAセクションvar(--space-20) (80px)--cta-padding

セクションスペーシングCSS

:root {
  --section-padding: clamp(4rem, 8vw, 6rem); /* 64-96px */
  --hero-padding: clamp(6rem, 12vw, 10rem); /* 96-160px */
  --footer-padding: clamp(5rem, 10vw, 8rem); /* 80-128px */
  --header-height: 4rem; /* 64px */
  --block-gap: clamp(2rem, 4vw, 3rem); /* 32-48px */
}

section {
  padding-top: var(--section-padding);
  padding-bottom: var(--section-padding);
}

.hero {
  padding-top: var(--hero-padding);
  padding-bottom: var(--hero-padding);
  min-height: 70vh;
}

footer {
  padding-top: var(--footer-padding);
  padding-bottom: var(--space-12);
  margin-top: 0; /* フッターのスペーシングを絶対に潰さない */
}

/* 交互のセクションに異なる背景を設定 */
section:nth-of-type(even) {
  background-color: var(--color-surface);
}
section:nth-of-type(odd) {
  background-color: var(--color-bg);
}

スペーシングのアンチパターン

❌ 禁止:
- フッターが上のセクションに直接接触している(隙間がない)
- パディングが64px未満のセクション(窮屈に感じる)
- パディングが96px未満のヒーローセクション(視覚的なインパクトが弱い)
- 主要セクションでmargin: 0を使用する
- すべてのセクションが同じ背景色(視覚的な分離がない)
- モバイルでのスペーシングが狭い(セクションパディング48px未満)

✅ 必須:
- フッターには常に十分な上部パディング(128px+)を確保する
- すべてのセクションに明確な視覚的分離(スペーシング+背景の交互)を設ける
- ヒーローは少なくとも70vhを取り、十分なパディングを確保する
- モバイルセクションではclamp()を使用して適応的なスペーシングを実現する
- フッターの前のCTAセクションには独自の明確な背景を持たせる

⚠️ 必須: ナビゲーション制限

ナビゲーションメニューを飽和させてはいけません。トップレベルの項目は最大7つです。

ナビゲーションルール

  1. メインナビゲーションバーは最大7項目
  2. 関連ページをドロップダウンメニューの下にグループ化する
  3. フッターナビゲーションをセカンダリーリンクに使用する(プライバシー、利用規約、サイトマップ)
  4. モバイル: 折りたたみ可能なセクションを持つハンバーガーメニュー
  5. すべてのページをメインナビに入れてはいけない

推奨ナビゲーション構造

メインナビ(最大5〜7項目):
  ホーム | アバウト | サービス ▼ | プロダクト | ポートフォリオ | コンタクト | CTAボタン

サービスのドロップダウン:
  サービス概要
  ─────────────────
  Webデザイン
  SEO最適化
  ソーシャルメディア
  ブランド戦略

フッターナビ(セカンダリーリンク):
  プライバシーポリシー | 利用規約 | サイトマップ | FAQ | 採用情報

ナビゲーションのアンチパターン

❌ 禁止:
- メインナビバーに7つ以上の項目がある(乱雑で圧倒される)
- すべてのページがトップナビにある
- グループ化されたコンテンツにドロップダウン/メガメニューがない
- すべてのリンクをフラットにリストするだけのハンバーガーメニュー
- 絵文字を含むナビ項目(例:「🏠 ホーム」「📧 コンタクト」)
- 視覚的階層のないテキストのみのナビ

✅ 必須:
- 最大7つのトップレベル項目、残りはドロップダウンの下にグループ化する
- プライマリCTAボタン(ナビリンクとは異なる色/スタイル)
- フッターにはセカンダリーリンクを含める(法的、その他)
- モバイル: グループ化されたセクションを持つハンバーガーメニュー
- 現在のページリンクにアクティブ状態を設定する
- すべてのナビ項目にホバー状態を設定する

⚠️ 必須: 推奨フレームワーク — Astro

静的Webサイト、マーケティングサイト、コンテンツ重視のサイトには、Astroを推奨します。

マーケティングサイトにおけるAstroとNext.jsの比較

要素AstroNext.js
デフォルト出力JSゼロ(HTMLのみ)Reactランタイムが必要
パフォーマンスほぼ完璧なLighthouseスコア良いが、最適化が必要
コンテンツ重視コンテンツサイト向けに設計Webアプリ向けに設計
バンドルサイズデフォルトで0KB JS~80KB+ Reactランタイム
学習曲線簡単(HTML + コンポーネント)中程度(React + SSRの概念)
マルチフレームワークアイランドでReact/Vue/Svelteを使用可能Reactのみ
SEO完璧(静的HTML)良い(設定が必要)
ホスティングCloudflare Pages、Vercel、NetlifyVercel(最適化)、その他

いつ何を推奨するか

プロジェクトタイプ推奨フレームワーク
マーケティング/エージェンシーサイトAstro + Tailwind
レストラン/地域ビジネスAstro + Tailwind
ポートフォリオ/履歴書Astro + Tailwind
ブログ/コンテンツサイトAstro + Tailwind
ランディングページAstro または HTML/Tailwind
SaaS WebアプリNext.js + React
EコマースNext.js + React
ダッシュボード/管理React + Vite
モバイルアプリFlutter または React Native

Astroプロジェクトのセットアップ

npm create astro@latest my-site
cd my-site
npx astro add tailwind

Astroページ構造

src/
├── pages/
│   ├── index.astro          # ホーム
│   ├── about.astro          # アバウト
│   ├── services/
│   │   ├── index.astro      # サービス一覧
│   │   ├── web-design.astro # サービス詳細
│   │   ├── seo.astro        # サービス詳細
│   │   └── social-media.astro
│   ├── products/
│   │   ├── index.astro      # プロダクト一覧
│   │   └── [slug].astro     # 動的プロダクト詳細
│   ├── contact.astro
│   ├── blog/
│   │   ├── index.astro      # ブログ一覧
│   │   └── [slug].astro     # ブログ記事
│   └── 404.astro
├── layouts/
│   └── BaseLayout.astro     # 共有HTMLシェル
├── components/
│   ├── Header.astro
│   ├── Footer.astro
│   ├── ServiceCard.astro
│   ├── ProductCard.astro
│   └── SEO.astro            # 再利用可能なメタ/JSON-LD
└── styles/
    └── global.css           # デザイントークン

⚠️ 必須: Cloudflare Pagesへのデプロイ

静的/Astroサイトは、Cloudflare Pagesにデプロイします(無料、高速、グローバルCDN)。

デプロイのセットアップ

# Wrangler CLIをインストール
npm install -g wrangler

# Cloudflareにログイン
wrangler login

# プロジェクトをビルド
npm run build

# デプロイ
npx wrangler pages deploy dist

Cloudflare Pagesのダッシュボード設定(初回のみ)

  1. Cloudflareダッシュボード → Workers & Pages → プロジェクトを作成
  2. リポジトリをGithub/GitLabに接続
  3. ビルド設定:
    • ビルドコマンド: npm run build
    • ビルド出力ディレクトリ: dist
  4. 環境変数を追加(必要な場合)

カスタムドメイン設定

# またはダッシュボードで設定
npx wrangler pages project create my-astro-site --production-branch main

デザイントークン(CSS変数)

:root {
  /* カラーパレット */
  --color-primary: #2563eb;    /* 青600 */
  --color-secondary: #7c3aed;  /* 紫600 */
  --color-accent: #f59e0b;     /* 琥珀色500 */
  --color-bg: #ffffff;
  --color-surface: #f8fafc;
  --color-text: #1e293b;
  --color-text-secondary: #64748b;

  /* タイポグラフィ */
  --font-heading: 'Inter', -apple-system, sans-serif;
  --font-body: 'Inter', -apple-system, sans-serif;
  --font-mono: 'JetBrains Mono', monospace;

  /* フォントサイズ */
  --text-xs: 0.75rem;
  --text-sm: 0.875rem;
  --text-base: 1rem;
  --text-lg: 1.125rem;
  --text-xl: 1.25rem;
  --text-2xl: 1.5rem;
  --text-3xl: 1.875rem;
  --text-4xl: 2.25rem;
  --text-5xl: 3rem;
  --text-6xl: 3.75rem;

  /* ラインハイト */
  --leading-tight: 1.25;
  --leading-normal: 1.5;
  --leading-relaxed: 1.625;

  /* スペーシング */
  --space-1: 0.25rem;
  --space-2: 0.5rem;
  --space-3: 0.75rem;
  --space-4: 1rem;
  --space-5: 1.25rem;
  --space-6: 1.5rem;
  --space-8: 2rem;
  --space-10: 2.5rem;
  --space-12: 3rem;
  --space-16: 4rem;
  --space-20: 5rem;
  --space-24: 6rem;
  --space-32: 8rem;

  /* 角丸 */
  --radius-sm: 0.25rem;
  --radius-md: 0.5rem;
  --radius-lg: 0.75rem;
  --radius-xl: 1rem;
  --radius-full: 9999px;

  /* シャドウ */
  --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
  --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1);
  --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1);
  --shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1);

  /* トランジション */
  --transition-fast: 150ms ease;
  --transition-normal: 250ms ease;
  --transition-slow: 350ms ease;

  /* コンテナ */
  --container-max: 1280px;
  --container-padding: clamp(1rem, 5vw, 2rem);
}

スキルチェックリスト

  • マルチページ構造(最低6ページ以上)
  • サービス詳細ページ(サービスごとに個別)
  • プロダクト詳細ページ(プロダクトごとに個別)
  • 絵文字がない(代わりにSVGアイコン)
  • アイコンライブラリが一貫して使用されている
  • セクションスペーシングが正しい(clamp()を使用)
  • 背景色が交互になっている
  • ナビゲーションが最大7項目
  • プライマリCTAボタンがある
  • フッターにセカンダリーナビゲーションがある
  • アクティブなナビゲーション状態がある
  • デザイントークンがCSS変数で定義されている
  • すべてのページにレスポンシブデザインが適用されている
  • メタタグとSEO(タイトル、説明、OGタグ)がある
  • Astroを使用している(可能な場合)
  • Cloudflare Pagesにデプロイされている(可能な場合)
  • すべてのページがHTTPSで動作している
  • 読み込み時間が3秒未満(Lighthouse)
  • モバイル対応

ドキュメント

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル