網站建置
打造獨特、具有生產力等級的網站,避免常見的「AI 垃圾」美學。每個選擇(字型、色彩、動態、版面)都必須經過深思熟慮。部署為靜態 HTML/CSS/JS 套件至 S3。
此技能涵蓋所有網頁專案需求。 當透過 load_skill("website-building") 載入時,所有檔案都會被複製到 workspace/ 目錄下。請依據您的專案類型閱讀相關子檔案。若為網頁應用程式,請載入子技能:load_skill("website-building/webapp")。
通用設計原則(色彩哲學、預設調色盤、字型選擇)透過 design-foundations 與其他技能共享。此技能的共享檔案會以專屬網頁實作(CSS 變數、響應式記號、基礎樣式表)來擴充那些基礎。您不需要單獨載入 design-foundations — shared/ 中的網頁專用版本已經完整涵蓋。
使用帶有完整路徑的 read 指令,例如 shared/01-design-tokens.md
專案類型路由
步驟 1:識別專案類型並載入領域特定指引:
| 專案類型 | 操作 | 範例 |
|---|---|---|
| 資訊型網站 | read informational/informational.md | 個人網站、作品集、社論/部落格、小型企業、登陸頁面 |
| 網頁應用程式 | load_skill("website-building/webapp") | SaaS 產品、儀表板、管理後台、電子商務、品牌體驗 |
| 瀏覽器遊戲 | read game/game.md + game/game-testing.md | 2D Canvas 遊戲、Three.js/WebGL、HTML5 遊戲、互動式 3D 體驗 |
步驟 2:閱讀共享檔案 — 首先閱讀 shared/01-design-tokens.md 和 shared/02-typography.md(所有專案類型皆為必讀,包含網頁應用程式)。這些檔案建立了 Nexus 設計系統的預設值與通用字型規則。對於網頁應用程式和儀表板,請跳過下方以「†」標記的檔案 — 這些檔案包含已預先配置在 Fullstack 範本中的實作細節。
如果使用者只說「網站」或「site」而沒有提供細節,請詢問類型或預設為資訊型網站。
子檔案參考
共享檔案 (shared/) — 每個專案都需要
| 檔案 | 涵蓋範圍 | 載入時機 |
|---|---|---|
shared/01-design-tokens.md | 字級、間距、Nexus 調色盤、base.css | 一律載入 |
shared/02-typography.md | 字型選擇、配對、載入、黑名單 | 一律載入 |
shared/04-layout.md | 空間構成、響應式設計、行動優先 | 一律載入 † |
shared/05-taste.md | Skeleton 載入器、空白/錯誤狀態、打磨細節 | 一律載入 |
shared/08-standards.md | 無障礙、效能、反模式 | 一律載入 |
shared/09-technical.md | 專案結構、沙箱、部署、檢查清單 | 一律載入 † |
shared/03-motion.md | 捲軸動畫、Motion 函式庫、GSAP SVG 外掛、懸停/游標 | 使用動畫時載入 |
shared/06-css-and-tailwind.md | Tailwind CSS v3、shadcn/ui、現代 CSS | 使用 Tailwind 時載入 |
shared/07-toolkit.md | CDN 函式庫、React、Three.js、圖示、地圖、SVG 模式/濾鏡、esm.sh | 選擇函式庫時載入 |
shared/10-charts-and-dataviz.md | Chart.js、Recharts、D3、KPI、Sparklines | 需要資料視覺化時載入 |
shared/11-web-technologies.md | 框架版本、瀏覽器相容性 | 檢查相容性時載入 |
shared/12-playwright-interactive.md | 持久化 Playwright 瀏覽器 QA、螢幕截圖、視覺測試 | 進行測試時載入 |
shared/19-backend.md | FastAPI/Express/Flask 伺服器、WebSocket、SSE、埠號轉發 | 需要後端時載入 |
shared/20-llm-api.md | LLM 聊天、圖片/影片/音訊生成、語音轉文字 — 模型、憑證、SDK 輔助工具 | 網站使用 AI/LLM API 時載入 |
所有路徑皆相對於 ``。
† 網頁應用程式與儀表板請跳過 — 這些實作細節已預先配置在 Fullstack 範本中。Design-tokens 與 typography 不可跳過 — 它們為所有專案類型提供權威的設計系統預設值與字型選擇指引。
領域特定檔案 — 請載入一個
| 檔案 | 載入時機 |
|---|---|
load_skill("website-building/webapp") | SaaS、儀表板、管理後台、電子商務、品牌體驗(附 Fullstack 範本的子技能) |
skills/website-building/webapp/dashboards.md | 儀表板或資料密集介面(網頁應用程式輔助檔案) |
informational/informational.md | 個人網站、作品集、社論、小型企業、登陸頁面 |
game/game.md | 瀏覽器遊戲、Three.js、WebGL、互動式 3D |
game/2d-canvas.md | 2D Canvas 遊戲(game.md 的輔助檔案) |
game/game-testing.md | 任何瀏覽器遊戲 — 需與 game.md 一起載入 |
互動式 QA: 閱讀 shared/12-playwright-interactive.md 以使用 Playwright(螢幕截圖、功能測試、視覺 QA)進行持久化瀏覽器自動化。遊戲測試必備,對任何複雜網站也很有用。
工作流程
- 設計方向:釐清目的,選定美學方向
- 版本控制:建構專案後在專案目錄中執行
git init。每個主要里程碑完成後以簡短訊息提交。 - 建置:逐頁建置網站,使用 Playwright 擷取螢幕截圖進行視覺 QA
- 發布:提交所有變更,然後執行
deploy_website()取得公開 URL
善用每個工具
- 先研究。 在設計之前,搜尋網路上的參考網站、趨勢和競爭對手範例。瀏覽該特定網站類型的獲獎範例。擷取使用者提供的任何 URL。
- 大方地產生真實素材。 為 Hero 區域、章節插圖、社論功能視覺、氛圍背景產生圖片 — 而不僅僅是一張 Hero 圖片。每個長頁面都應有視覺節奏,並使用符合網站藝術方向的產生圖片。不要使用佔位符。為每個專案產生一個自訂 SVG Logo(請參閱下方)— SVG 僅用於 Logo,除非使用者特別要求 SVG 輸出。儲存可提供靈感的網站參考圖片。
- 使用 Playwright 擷取螢幕截圖(僅限複雜網站)。 對於多頁面網站、網頁應用程式、儀表板和遊戲,閱讀
skills/website-building/shared/12-playwright-interactive.md以在桌面(1280px+)和行動裝置(375px)上擷取螢幕截圖。簡單的單頁靜態網站則跳過 Playwright — 請參閱下方的視覺 QA 說明。 - 直接撰寫正式程式碼。 HTML、CSS、JS、SVG。使用 bash 進行建置工具和檔案處理。
SVG Logo 生成
每個專案都獲得一個自訂的內嵌 SVG Logo。絕對不要用樣式化的文字標題來取代。
- 了解品牌 — 目的、調性、一個關鍵字
- 直接撰寫 SVG — 幾何形狀、字體或抽象標記。一個令人難忘的形狀。
- 原則: 幾何/極簡(Paul Rand、Vignelli)。24px 和 200px 都能正常運作。先黑白 — 再以顏色增強。使用
currentColor以支援深色/淺色模式。 - 內嵌實作 使用
aria-label、viewBox、fill="none"、currentColor描邊 - 產生 Favicon — 必要時簡化為 32x32 版本
如需 SVG 動畫(DrawSVG、MorphSVG),請參閱 shared/03-motion.md。如需 SVG 模式/濾鏡,請參閱 shared/07-toolkit.md。
視覺 QA 測試流程
何時使用 Playwright QA
簡單網站跳過 Playwright。 單頁靜態網站不需要 Playwright 螢幕截圖。直接審查程式碼,然後部署。Playwright QA 會顯著增加時間,對簡單的靜態內容不值得。
複雜網站使用 Playwright。 多頁面網站、網頁應用程式、儀表板、遊戲以及任何具有互動功能(表單、購物車、篩選器、圖表、拖放)的網站,都必須使用 Playwright QA。閱讀 skills/website-building/shared/12-playwright-interactive.md 以使用持久化瀏覽器自動化。
Playwright QA 流程(僅限複雜網站)
循環: 建置 → Playwright QA → 評估 → 修正 → 重複 → 準備好後部署
階段 1:逐頁 QA
每建置完一個頁面:
- 透過 Playwright 擷取桌面(1280px+)和行動裝置(375px)的螢幕截圖
- 嚴格評估: 看起來是否專業設計(而非 AI 生成)?字型是否獨特?留白是否充足?是否有清晰的視覺層級?
- 在繼續前修正所有問題。 不留下視覺債務。
階段 2:最終 QA(發布前)
- 以桌面和行動裝置擷取每個頁面的螢幕截圖
- 檢查跨頁面一致性(間距、色彩、字型處理)
- 驗證深色模式(至少為首頁擷取兩種主題的螢幕截圖)
- 檢查互動狀態:懸停、焦點、啟用、載入、空白、錯誤
- 冷啟動第一印象測試:感覺是否精緻且經過深思熟慮?
QA 失敗項目: 文字溢出、間距不一致、色彩偏離標記、缺少深色模式、行動裝置畫面擠壓、AI 通用外觀、佔位符內容、缺少 Logo。
步驟 1:藝術方向 — 先推斷再詢問,先詢問再預設
每個網站都應擁有源自其內容的視覺識別。不要直接跳到 Nexus 備用調色盤。 Nexus 調色盤是當推斷和詢問都失敗時的最後手段,而不是方便的預設選項。
- 從主題推斷。 咖啡烘焙商網站 → 大地棕、暖奶油色、手繪風格。金融科技儀表板 → 冷灰板岩、銳利無襯線字體、資料密集。兒童學習應用程式 → 明亮原色、圓角字體、活潑動態。內容本身就告訴你調色盤、字型和間距,使用者甚至不用開口。
- 檢查藝術方向表格。 每個領域檔案(
informational.md、webapp/SKILL.md、game/game.md)都有一個藝術方向表格,將網站/產品類型映射到概念驅動的方向和記號起點。將這些作為跳板。 - 推導五大支柱: 色彩(暖/冷、從主題擷取重點色)、字型(有襯線/無襯線、顯示性格)、間距(緊湊/寬敞)、動態(極簡/表現性)、圖像(照片/插圖/純文字)。
- 如果主題確實模糊,請詢問 — 「您想要什麼感覺?」和「有任何參考網站嗎?」一個問題就夠了。
- Nexus 備用 — 僅在推斷和詢問都得不到結果時使用。 如果已經詢問過使用者但沒有得到方向,且主題也沒給出明確訊號,才回退到 Nexus/Swiss 預設。
備用方案:乾淨 & Swiss(最後手段)
當推斷沒有明確方向,且使用者已被詢問但未提供風格指引時,使用 shared/01-design-tokens.md 中的預設值,搭配:
- 字型: Satoshi 或 General Sans 正文(Fontshare — 優先選用),或 Inter/DM Sans。偏重字重對比而非字型對比。最多 3-4 種尺寸。保持文字緊湊 —
--text-3xl/--text-hero僅用於資訊型網站的 Hero。 - 色彩: Nexus 調色盤。中性底色 + 一個青綠色重點色(僅用於 CTA)。
- 版面: 網格對齊。邊距寬敞。必要時採用不對稱以增加趣味。
- 動態: 極簡、功能性。僅有流暢的狀態轉換。
- 圖像: 產生乾淨、相關的視覺素材。不使用庫存照片。
藝術方向 — 避免 AI 美學
完整的反模式清單請參閱 shared/08-standards.md。
步驟 2:發布
使用專案路徑和網站名稱呼叫 deploy_website()。回傳一個公開的 S3 URL。若要更新,編輯本地檔案並使用相同路徑重新部署。詳細的呼叫方式和範例請參閱 shared/09-technical.md。