網站建置
打造具有辨識度的生產級網站,讓每個網站的外觀都不同。每一項選擇——字體、色彩、動態、佈局——都必須源自於主題內容。執行調色盤產生器(bun run shared/generate-palette.ts "關鍵字")來為每個專案建立獨特的色彩方案。絕對不要在不同的網站間重複使用同一套調色盤。
此技能涵蓋網頁專案的一切需求。 根據您的專案類型,視需要閱讀本目錄下的子檔案。若為 Web 應用程式,請一併閱讀 skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md。
通用設計原則(色彩哲學、預設調色盤、字體選擇)透過 design-foundations 與其他技能共享。此技能的共享檔案則針對網頁實作(CSS 變數、響應式記號、基礎樣式表)延伸這些基礎。您不需要另外載入 design-foundations——shared/ 中的網頁專用版本已足夠完整。
使用 read 指令搭配完整路徑,例如 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md
專案類型路由
步驟 1:識別專案類型並載入領域特定指引:
| 專案類型 | 動作 | 範例 |
|---|---|---|
| 資訊型網站 | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/informational/informational.md | 個人網站、作品集、編輯/部落格、小型企業、登陸頁面 |
| Web 應用程式 | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md | SaaS 產品、儀表板、管理後台、電子商務、品牌體驗 |
| 瀏覽器遊戲 | read skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game.md + skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game-testing.md | 2D Canvas 遊戲、Three.js/WebGL、HTML5 遊戲、互動式 3D 體驗 |
步驟 2:讀取共享檔案——先讀取 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md 與 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/02-typography.md(所有專案類型,包含 webapp,皆為必讀)。這些檔案建立了 Kortix 設計系統的預設值與通用字體規則。對於 Web 應用程式與儀表板,請跳過下方標記 † 的檔案——這些實作細節已在 fullstack 模板中預先設定。
如果使用者只說「網站」或「site」而無細節,請詢問類型,或預設為資訊型。
子檔案參考
共享檔案 (shared/)——每個專案皆適用
| 檔案 | 涵蓋內容 | 是否載入 |
|---|---|---|
shared/01-design-tokens.md | 字級縮放、間距、Kortix 調色盤、base.css | 總是 |
shared/02-typography.md | 字體選擇、配對、載入、黑名單 | 總是 |
shared/04-layout.md | 空間組成、響應式、行動優先 | 總是 † |
shared/05-taste.md | Skeleton 載入器、空白/錯誤狀態、打磨 | 總是 |
shared/08-standards.md | 無障礙、效能、反模式 | 總是 |
shared/09-technical.md | 專案結構、沙盒、部署、檢查表 | 總是 † |
shared/head-defaults.html | <head> 的歸屬區塊 | 總是 † |
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、迷你圖 | 需要資料視覺化時 |
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/AI API 整合參考 | 網站使用 AI API 時 |
所有路徑均相對於 skills/GENERAL-KNOWLEDGE-WORKER/website-building/。
† Web 應用程式與儀表板請跳過——這些實作細節已在 fullstack 模板中預先設定。設計記號與字體規則不可跳過——它們為所有專案類型提供權威的設計系統預設值與字體選擇指引。
領域特定——載入其中一個
| 檔案 | 何時載入 |
|---|---|
read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md | SaaS、儀表板、管理後台、電子商務、品牌體驗(包含 fullstack 模板的子技能) |
webapp/dashboards.md | 儀表板或資料密集型介面(webapp 的配套檔案) |
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: 閱讀 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md 以了解如何使用 Playwright 進行持久化瀏覽器自動化(螢幕截圖、功能測試、視覺 QA)。遊戲測試必讀,對任何複雜網站也很有用。
工作流程
步驟 0:載入所有必讀檔案(先做這個,平行處理)
一次讀取所有這些檔案——每個專案都必須執行:
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/02-typography.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/04-layout.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/05-taste.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/08-standards.md")
然後從下方的步驟 1 載入領域特定檔案(informational、webapp 或 game)。
步驟 1:產生獨一無二的調色盤
使用描述主題的關鍵字執行調色盤產生器:
bun run skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/generate-palette.ts "主題關鍵字"
選擇最佳的和諧方案,必要時自訂。
步驟 2:設計與建置
使用產生的調色盤建置網站,並遵循所有已載入的設計指引。
步驟 3:預覽
透過靜態伺服器展示:show(type: "url", url: "http://localhost:3211/open?path=/workspace/project/index.html")
使用每項工具
- 先研究。 在設計之前,搜尋網路上的參考網站、趨勢與競爭對手範例。瀏覽特定網站類型的獲獎範例。擷取使用者提供的任何 URL。
- 大方地產生真實素材。 為英雄區、章節插圖、編輯專題視覺、氛圍背景產生圖片——不只一張英雄圖。每個長頁面都應有與網站藝術方向相符的視覺節奏。不要使用佔位符。每個專案都產生一個自訂 SVG Logo(見下方)——SVG 僅用於 Logo,除非使用者特別要求 SVG 輸出。儲存能提供方向的網頁參考圖片。
- 透過 Playwright 進行螢幕截圖。 閱讀
skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md,在桌面(1280px+)與行動裝置(375px)進行螢幕截圖。與參考圖比較。這是強制的,非選擇性。請參閱下方的視覺 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 測試流程
每次部署都必須通過視覺 QA。螢幕截圖是品質閘門。
請閱讀 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md 以了解所有視覺 QA 細節。Playwright 提供持久化的瀏覽器工作階段,用於螢幕截圖、互動測試與視窗驗證。
循環: 建置 → Playwright QA → 評估 → 修正 → 重複 → 準備好時部署
階段 1:逐頁 QA
建置每個頁面後:
- 透過 Playwright 在桌面(1280px+)與行動裝置(375px)進行螢幕截圖
- 嚴格評估: 看起來是專業設計(而非 AI 生成)嗎?字體有特色嗎?留白充裕嗎?有一個清晰的視覺層級嗎?
- 在繼續前修正每個問題。 不留視覺債。
階段 2:最終 QA(發布前)
- 在桌面與行動裝置為每個頁面進行螢幕截圖
- 檢查跨頁面一致性(間距、色彩、文字處理)
- 驗證深色模式(至少為首頁擷取兩種主題的螢幕截圖)
- 檢查互動狀態:懸停、焦點、啟用、載入中、空白、錯誤
- 冷啟動第一印象測試:感覺是否經過打磨且刻意為之?
QA 失敗項目: 文字溢出、間距不一致、不符合設計記號的顏色、缺少深色模式、行動版被壓縮、生成式 AI 的平庸外觀、佔位內容、缺少 Logo。
步驟 1:藝術方向——先推斷,再提問,最後才使用預設值
每個網站都應擁有源自其內容的視覺識別。不要直接跳到 Kortix 備用調色盤。 Kortix 調色盤是在推斷與提問都失敗時的最後手段——不是一個方便的預設選項。
- 從主題推斷。 咖啡烘焙商網站 → 大地棕、溫暖奶油色、手繪風格。金融科技儀表板 → 冷色石板灰、銳利無襯線字體、資料密集。兒童學習應用 → 明亮原色、圓角字體、活潑動畫。內容本身在用戶說話之前,就告訴你調色盤、字體與間距。
- 檢查藝術方向表格。 每個領域檔案(
informational.md、webapp/SKILL.md、game/game.md)都有一個藝術方向表格,將網站/產品類型映射到概念驅動的方向與設計記號起點。將這些作為跳板。 - 推導五大支柱: 色彩(暖/冷、強調色源自主題)、字體(有襯線/無襯線、標題個性)、間距(密集/寬裕)、動態(極簡/表現力)、圖像(照片/插圖/純文字)。
- 如果主題確實模糊,請提問——「您想要什麼樣的氛圍?」以及「有沒有參考網站?」問一個問題就夠了。
- Kortix 備用——僅在推斷與提問都無結果時使用。 如果已經問過用戶且未獲得方向,而且主題本身也無明確訊號,則回退到 Kortix/Swiss 預設值。
備用方案:乾淨且 Swiss 風格(最後手段)
當推斷未產生明確方向,且已向用戶提問但未獲得風格指引時,使用 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md 中的預設值,搭配:
- 字體: Satoshi 或 General Sans 內文(Fontshare——首選),或 Inter/DM Sans。使用字重對比而非字型對比。最多 3-4 種尺寸。保持文字緊湊——
--text-3xl/--text-hero僅用於資訊型網站的英雄區。 - 色彩: Kortix 調色盤。中性底色 + 一個青綠色強調色,僅用於 CTA。
- 佈局: 網格對齊。寬裕的邊距。在不對稱處增加趣味。
- 動態: 極簡、功能性。僅限流暢的狀態轉換。
- 圖像: 產生乾淨、相關的視覺素材。不使用圖庫照片。
藝術方向——避免 AI 美感
請參閱 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/08-standards.md 以取得完整的反模式清單。
步驟 2:發布
先使用真實的本地預覽指令,並僅使用目標專案的實際部署工作流程來發布。請參閱 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/09-technical.md 以了解建議的預覽與交付流程。
交付
- 總是在本地先驗證網站。
- 使用
pty_spawn啟動預覽或開發伺服器。 - 如果目標儲存庫已有部署工作流程,請使用該確切的工作流程。
- 如果沒有既定的部署目標,請交付檔案與經過驗證的本地預覽,而非自行發明一個特定平台的部署流程。