Communitygithub.com

Omar-Obando/qwen-orchestrator

專業設計系統,包含色盤規則、排版、間距、多頁面架構、服務/產品詳細頁面、導覽限制、無表情符號政策、區塊間距以及部署指南(Astro + Cloudflare)。強制執行多頁面網站結構,並為每個服務和產品建立獨立頁面。

qwen-orchestrator 是什麼?

此技能定義了一套完整的專業設計系統(Design System Skill),專注於建立高品質、多頁面的商業網站。它強制執行一系列嚴格的前端開發規則,包括嚴禁使用表情符號、限制導覽列項目數、確保區塊間距充足,以及最重要的:任何網站專案都必須是多頁面架構,且每個服務或產品都必須擁有獨立的詳細介紹頁面,而非僅有單一的服務清單頁面。此技能推薦使用 Astro 作為靜態網站框架,並搭配 Cloudflare Pages 進行部署,以獲得最佳效能與全球 CDN 加速。對於開發者或 AI 代理來說,這是一個極具價值的指導工具,能確保所產出的網站不僅視覺美觀,也符合現代 SEO 和使用者體驗的最佳實務,避免了常見的設計反模式(如單頁式假網站、擁擠的導覽列和不足的區塊間距)。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

設計系統技能 — 專業 UI/UX、間距與多頁面架構

此技能強制執行專業設計標準:適當的色盤、排版、區塊間距、導覽限制、詳細的服務/產品頁面、零表情符號以及多頁面網站架構。建議技術棧:Astro 用於靜態/內容網站,部署至 Cloudflare Pages。

⚠️ 強制:多頁面網站規則

當使用者要求網站時,絕不能只建立一個單一登陸頁面。

當使用者要求一個網站(例如:「行銷公司網站」、「餐廳網站」、「公司網站」)時,你必須建立一個完整的多頁面網站,至少包含以下頁面:

標準網站頁面 (強制)

頁面用途優先級
首頁英雄區、價值主張、關鍵章節與行動呼籲必備
關於我們公司故事、團隊、使命、價值觀必備
服務服務列表頁面,並包含連結至個別詳細頁面必備
服務詳細每個服務的獨立頁面(例如 /services/web-design)必備
聯絡我們聯絡表單、地圖、電話、電子郵件、營業時間必備
產品/作品集產品列表頁面,並包含連結至個別詳細頁面必備

服務頁面 — 詳細 (非通用)

每個服務都必須有自己的專屬頁面。 服務列表頁面應顯示卡片/摘要,並連結到個別的詳細頁面。

❌ 禁止:
- /services 頁面列出所有服務,但沒有獨立頁面
- 一個通用的 /services 頁面,只有簡短描述
- 每個服務只用 2-3 行文字描述
- 每個服務沒有定價、流程或交付項目

✅ 必要結構:
/services              → 列表頁面(包含圖片、標題、摘要和行動呼籲的卡片)
/services/web-design   → 詳細頁面(描述、流程、交付項目、定價、常見問題、行動呼籲)
/services/seo          → 詳細頁面(描述、流程、交付項目、定價、常見問題、行動呼籲)
/services/social-media → 詳細頁面(描述、流程、交付項目、定價、常見問題、行動呼籲)

每個服務詳細頁面必須包含:

  • 描述:用 3-5 個段落解釋該服務
  • 流程:逐步說明(1. 探索 → 2. 設計 → 3. 開發 → 4. 上線)
  • 交付項目:客戶收到的內容
  • 定價方案或「起價 $X」(或引導至客製化報價的行動呼籲)
  • 常見問題區塊:3-5 個常見問題
  • 行動呼籲:「取得報價」、「預約諮詢」、「開始您的專案」
  • 推薦或案例研究(如果有的話)

產品頁面 — 詳細 (非通用)

每個產品都必須有自己的專屬頁面。 產品列表頁面應顯示卡片,並連結到個別的詳細頁面。

❌ 禁止:
- /products 頁面只有簡單的列表或網格,沒有詳細頁面
- 產品在單張卡片中描述,沒有規格
- 每個產品沒有定價、功能或圖片

✅ 必要結構:
/products              → 列表頁面(包含圖片、名稱、價格摘要和行動呼籲的卡片)
/products/product-a    → 詳細頁面(圖庫、完整描述、規格、定價、評論、相關產品)
/products/product-b    → 詳細頁面(圖庫、完整描述、規格、定價、評論、相關產品)

每個產品詳細頁面必須包含:

  • 圖片圖庫:3-5 張產品圖片
  • 完整描述:功能、規格、材質
  • 定價:清晰的價格顯示
  • 行動呼籲:「加入購物車」、「詢價」、「立即購買」
  • 相關產品區塊
  • 評論/推薦(如果有的話)

根據商業類型的額外頁面

商業類型額外頁面
代理商作品集、案例研究、團隊、流程、定價
餐廳菜單、訂位、圖庫、主廚/故事、私人活動
電子商務商店、產品詳細、購物車、結帳、帳戶、願望清單
SaaS功能、定價、文件、部落格、更新日誌、狀態
作品集專案、關於我、履歷/CV、推薦、聯絡
房地產房源、物業詳細、經紀人、鄰里、貸款試算
醫療保健服務、醫生/團隊、預約、患者入口網站、據點
教育課程、學程、師資、招生、校園生活、行事曆
法律專業領域、律師、推薦、資源、免費諮詢
非營利使命、計畫、影響、參與、捐款、活動

何時詢問頁面

使用 AskUserQuestion 來確認頁面結構:

AskUserQuestion({
  questions: [
    {
      question: "網站應包含哪些頁面?",
      header: "頁面",
      options: [
        { label: "完整網站", description: "首頁 + 關於我們 + 服務 + 產品 + 聯絡我們 (建議)" },
        { label: "標準", description: "首頁 + 關於我們 + 服務 + 聯絡我們" },
        { label: "擴充", description: "完整網站 + 部落格 + 常見問題 + 作品集 + 定價" }
      ]
    }
  ]
})

反模式:單一登陸頁面

❌ 禁止(當使用者要求「網站」時):
- 只建立一個 index.html 作為唯一的頁面
- 將所有內容放在一個可滾動的頁面中
- 稱之為「網站」,但實際上只是一個單一的 HTML 檔案
- 章節假裝成頁面(例如 #about, #services, #contact)

✅ 必要:
- 每個章節都有獨立的路由/頁面(例如 /about, /services, /contact)
- 每個頁面都有自己的版面、Meta 標籤和 SEO 最佳化
- 導覽選單連結所有頁面
- 共享的頁首/頁尾元件
- 跨所有頁面一致的設計系統
- 每個服務和產品都有個別的詳細頁面

唯一的例外:使用者明確說明「登陸頁面」或「單頁式網站」。


⚠️ 強制:零表情符號政策

專業網站不使用表情符號。沒有例外。

❌ 禁止:
- 🚀 🎯 💡 ✨ 🏆 📱 💻 🛒 📧 📞 ✅ ❌ 🔥 ⭐ 💪 🎨 📊 🔒 🌍 等表情符號出現在網站中
- 使用表情符號作為區塊圖標
- 在標題、按鈕或行動呼籲中使用表情符號
- 在導覽標籤中使用表情符號
- 在 Meta 標題或描述中使用表情符號

✅ 必要:
- 使用圖標庫中的 SVG 圖標 (如 Lucide, Heroicons, Phosphor, Tabler)
- 使用 CSS 形狀或裝飾元素以增加視覺趣味
- 使用適當的圖標元件 (<svg> 或圖標字體)
- 所有標題、按鈕和標籤使用純文字

圖標庫(選用一個,並保持一致):

圖標庫安裝指令風格最適合用於
Lucidenpm install lucide-react簡潔、現代大多數網站
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
行動呼籲區塊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() 實現自適應間距
- 頁尾前的行動呼籲區塊擁有自己獨特背景

⚠️ 強制:導覽限制

導覽選單不可過滿。最多 7 個頂層項目。

導覽規則

  1. 主要導覽列最多 7 個項目
  2. 將相關頁面分組到下拉選單中
  3. 次要連結(隱私權、條款、網站地圖)使用頁尾導覽
  4. 行動版:漢堡選單搭配可折疊區塊
  5. 絕不將所有頁面都放入主要導覽列

建議導覽結構

主要導覽 (最多 5-7 項):
  首頁 | 關於我們 | 服務 ▼ | 產品 | 作品集 | 聯絡我們 | 行動呼籲按鈕

服務下拉選單:
  服務總覽
  ─────────────────
  網頁設計
  SEO 最佳化
  社群媒體
  品牌策略

頁尾導覽 (次要連結):
  隱私權政策 | 服務條款 | 網站地圖 | 常見問題 | 加入我們

導覽反模式

❌ 禁止:
- 主要導覽列超過 7 個項目(雜亂、難以負荷)
- 每個頁面都放在頂層導覽
- 分組內容沒有下拉/巨型選單
- 漢堡選單只是將所有連結扁平地列出
- 導覽項目使用表情符號(例如「🏠 首頁」「📧 聯絡我們」)
- 純文字導覽,沒有視覺層級

✅ 必要:
- 最多 7 個頂層項目,額外的內容分組到下拉選單
- 主要的行動呼籲按鈕(顏色/樣式與導覽連結不同)
- 頁尾包含次要連結(法律、額外資訊)
- 行動版:漢堡選單搭配分組區塊
- 當前頁面連結要有啟用狀態
- 所有導覽項目要有懸停狀態

⚠️ 強制:建議框架 — Astro

對於靜態網站、行銷網站和內容豐富的網站,建議使用 Astro。

為何行銷網站要選 Astro 而非 Next.js

因素AstroNext.js
預設輸出零 JS (僅 HTML)需要 React 執行環境
效能近乎完美的 Lighthouse 分數良好,但需要最佳化
內容導向專為內容網站打造專為網頁應用程式打造
套件大小預設 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 網頁應用程式Next.js + React
電子商務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            # 可重複使用的 meta/JSON-LD
└── styles/
    └── global.css           # 設計令牌

⚠️ 強制:Cloudflare Pages 部署

對於靜態/Astro 網站,部署至 Cloudflare Pages (免費、快速、全球 CDN)。

部署設定

# 安裝 Wrangler CLI
npm install -g wrangler

# 登入 Cloudflare
wrangler login

# 建置專案
npm run build

# 部署到 Cloudflare Pages
npx wrangler pages deploy dist/

Cloudflare Pages 設定

  1. 透過 Git 儀表板連接您的儲存庫
  2. 設定建置指令:npm run build
  3. 設定輸出目錄:dist
  4. 設定環境變數(如有需要)
  5. 設定自訂網域(如有需要)
  6. 啟用自動部署(每次推送時自動重新建置)

⚠️ 強制:色盤規則

顏色基礎

:root {
  --color-primary: #2563eb;     /* 主要品牌色 (藍色) */
  --color-primary-light: #3b82f6;
  --color-primary-dark: #1d4ed8;
  --color-secondary: #7c3aed;   /* 次要品牌色 (紫色) */
  --color-accent: #f59e0b;      /* 強調色 (琥珀色) */
  --color-bg: #ffffff;          /* 背景色 */
  --color-surface: #f8fafc;     /* 表面色 (輕微灰色) */
  --color-text: #1e293b;        /* 主要文字色 (石板灰) */
  --color-text-muted: #64748b;  /* 次要文字色 */
  --color-border: #e2e8f0;      /* 邊框色 */
}

顏色規則

  1. 最多使用 3 種品牌色:一種主要、一種次要、一種強調色
  2. 保持高對比度:文字與背景的對比度至少為 4.5:1
  3. 充足的白色空間:背景色應為白色或非常淺的灰色
  4. 文字色不要用黑色:使用柔和的深灰色(#1e293b)而非純黑色
  5. 限用一種強調色:用於按鈕、連結和重要元素
  6. 不要隨意搭配顏色:使用一致的主題色

⚠️ 強制:排版規則

字型建議

:root {
  --font-sans: 'Inter', system-ui, -apple-system, sans-serif;
  --font-serif: 'Merriweather', Georgia, serif;
  --font-mono: 'JetBrains Mono', 'Fira Code', monospace;
}

排版規則

  1. 正文使用無襯線字型:Inter, system-ui, sans-serif
  2. 標題使用無襯線字型:與正文相同字型家族,或粗體字重
  3. 行高:正文為 1.6-1.8,標題為 1.2-1.3
  4. 字型大小:使用流暢的排版比例(clamp())
  5. 最大寬度:文字區塊不超過 75 個字元(約 720px)
  6. 不要使用 Google Fonts(除非必要):使用系統字型或自行託管

⚠️ 強制:行動版設計規則

響應式設計規則

  1. 預設使用行動優先設計:先設計手機版,再擴展到桌面版
  2. 使用斷點:640px (sm)、768px (md)、1024px (lg)、1280px (xl)
  3. 觸控目標:點擊目標至少為 44x44px
  4. 導覽:行動版使用漢堡選單
  5. 圖片:使用響應式圖片(srcset 和 sizes)
  6. 不要隱藏重要內容:行動版不應隱藏關鍵資訊

⚠️ 反模式:要避免什麼

❌ 絕對禁止:
- 單頁網站偽裝成完整網站
- 服務和產品沒有詳細頁面
- 使用表情符號作為圖標
- 區塊間距不足(內距 < 64px)
- 導覽列超過 7 個項目
- 所有區塊使用相同背景
- 使用純黑色文字(#000)
- 對比度不足
- 行動版上文字太小
- 使用 Google Fonts 而未自行託管
- 在靜態網站上使用 Next.js
- 將靜態網站部署到昂貴或複雜的託管服務

✅ 技能摘要

此技能確保您建立的每個網站都符合專業標準:

  • 多頁面架構:始終有一個完整的網站,而非單一登陸頁面
  • 詳細的服務/產品頁面:每個服務和產品都有其自己的詳盡頁面
  • 零表情符號:專業網站不使用表情符號
  • 間距規則:區塊之間絕不能彼此接觸,且有明確的視覺區隔
  • 導覽限制:導覽列最多 7 個項目,使用下拉選單
  • Astro + Cloudflare:建議的技術棧,可提供最佳效能和簡潔部署
  • 一致的設計系統:顏色、排版和間距在整個網站中保持一致

Individual skills in this repo

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

相關技能