網站建置
打造獨特、生產品質的網站,避免千篇一律的「AI 生成」美學。每一個選擇——字體、顏色、動態、佈局——都必須有其意圖。最終部署為靜態 HTML/CSS/JS 套件至 S3。
此技能涵蓋網頁專案的所有面向。 當透過 load_skill("website-building") 載入時,所有檔案會被複製到 workspace/skills/website-building/。請根據您的專案類型,按需讀取子檔案。對於網頁應用程式,請載入子技能:load_skill("website-building/webapp")。
通用設計原則(色彩哲學、預設調色盤、字體選擇)透過 design-foundations 與其他技能共享。此技能的共享檔案則以網頁特定的實作(CSS 變數、響應式代碼、基礎樣式表)來延伸那些基礎。您無需單獨載入 design-foundations——共用資料夾中的網頁專用版本已足夠全面。
使用 read 時請加上完整路徑,例如 skills/website-building/shared/01-design-tokens.md
框架偵測路由器
在依專案類型進行路由之前,請先識別框架:
| 訊號 | 框架 | 動作 |
|---|---|---|
package.json 中有 "next" 相依,或 next.config.* 存在 | Next.js | 先讀取 skills/website-building/nextjs/SKILL.md |
package.json 中有 "react-native" 或 "expo" 相依 | React Native | 先讀取 skills/website-building/react-native/SKILL.md |
package.json 中僅有 "react"(Vite/CRA/Remix) | React (非 Next) | 使用 skills/website-building/webapp/SKILL.md 配合標準 Tailwind 指南 |
無 package.json,僅有 .html 檔案 | 純 HTML/CSS/JS | 繼續使用標準共享檔案 |
框架特定檔案提供:
- 確切的設定指令與版本號
- 框架特定的 Tailwind 整合(Next.js 用 v4,RN 用 NativeWind)
- 該框架專屬的路由、資料擷取與元件模式
- 框架專屬的部署指南
讀取框架檔案後,請回到此技能的專案類型路由(下方)以載入領域特定的設計指南(資訊型/網頁應用/遊戲)。
專案類型路由
步驟 1:識別專案類型並載入領域特定指南:
| 專案類型 | 動作 | 範例 |
|---|---|---|
| 資訊型網站 | read skills/website-building/informational/informational.md | 個人網站、作品集、編輯/部落格、小型企業、登陸頁面 |
| 網頁應用程式 | load_skill("website-building/webapp") | SaaS 產品、儀表板、管理後台、電子商務、品牌體驗 |
| 瀏覽器遊戲 | read skills/website-building/game/game.md + skills/website-building/game/game-testing.md | 2D Canvas 遊戲、Three.js/WebGL、HTML5 遊戲、互動 3D 體驗 |
步驟 2:讀取共享檔案——先讀取 skills/website-building/shared/01-design-tokens.md 和 skills/website-building/shared/02-typography.md(所有專案類型皆強制,包括 webapp)。這些檔案建立了 Nexus 設計系統的預設值與普遍適用的字體排版規則。對於網頁應用程式和儀表板,請跳過下方標記 † 的檔案——這些實作細節已預先配置在 fullstack 範本中。
如果使用者只說「網站」或「site」而無詳細說明,請詢問其類型,或預設為資訊型。
子檔案參考
共享 (shared/) —— 每個專案都必讀
| 檔案 | 內容 | 載入時機 |
|---|---|---|
shared/01-design-tokens.md | 字體比例、間距、Nexus 調色盤、base.css | 永遠 |
shared/02-typography.md | 字體選擇、配對、載入、黑名單 | 永遠 |
shared/04-layout.md | 空間構成、響應式、行動優先 | 永遠 † |
shared/05-taste.md | 骨架載入、空/錯誤狀態、打磨 | 永遠 |
shared/08-standards.md | 無障礙性、效能、反模式 | 永遠 |
shared/09-technical.md | 專案結構、沙箱、部署、檢查清單 | 永遠 † |
shared/pplx_attribution.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 聊天、圖片/影片/音訊生成、轉錄——模型、憑證、SDK 輔助工具 | 網站使用 AI/LLM API 時 |
所有路徑皆相對於 skills/website-building/。
† 網頁應用程式和儀表板請跳過——實作細節已預先配置在 fullstack 範本中。Design-tokens 與 typography 不可跳過——它們為所有專案類型提供了權威的設計系統預設值與字體選擇指南。
領域特定 —— 僅載入一個
| 檔案 | 載入時機 |
|---|---|
load_skill("website-building/webapp") | 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/website-building/shared/12-playwright-interactive.md 以使用 Playwright 進行持久化瀏覽器自動化(截圖、功能測試、視覺 QA)。遊戲測試為必讀,對於任何複雜網站也很有用。
工作流程
- 設計方向:釐清目的,選擇美學方向
- 建置:逐頁建置網站,透過 Playwright 截圖進行 QA
- 發布:
deploy_website()會回傳一個公開 URL
使用所有工具
- 先研究。 在設計之前,先搜尋網路上的參考網站、趨勢和競爭對手範例。瀏覽該特定網站類型的獲獎案例。擷取使用者提供的任何 URL。
- 大方地生成真實資產。 為英雄區、章節插圖、編輯特寫視覺、氛圍背景生成圖片——不只是一個英雄圖片。每個長頁面都應透過與網站藝術方向相符的生成圖片來維持視覺節奏。不要使用佔位符。為每個專案生成一個自訂的 SVG Logo(見下方)——除非使用者特別要求 SVG 輸出,否則 SVG 僅用於 Logo。儲存用於指引方向的網頁參考圖片。
- 透過 Playwright 截圖。 讀取
skills/website-building/shared/12-playwright-interactive.md以在桌面(1280px+)和行動裝置(375px)下進行截圖。與參考圖片進行比較。這是強制性的,非選擇性。請參閱下方的視覺 QA。 - 直接編寫生產品質的程式碼。 HTML、CSS、JS、SVG。使用 bash 進行建置工具和檔案處理。
SVG Logo 生成
每個專案都應有一個自訂的內聯 SVG Logo。切勿使用 styled text 標題來替代。
- 理解品牌——目的、調性、一個定義性的詞彙
- 直接編寫 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/website-building/shared/12-playwright-interactive.md 以了解所有視覺 QA 相關資訊。Playwright 提供一個持久化的瀏覽器工作階段,用於截圖、互動測試和視埠驗證。
循環: 建置 → 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 預設值。
備用方案:乾淨與瑞士風格(最後手段)
當推斷沒有明確方向,且使用者已被詢問但未提供任何樣式指南時,使用 skills/website-building/shared/01-design-tokens.md 中的預設值,並配合:
- 字體排版: 正文字體使用 Satoshi 或 General Sans(來自 Fontshare——首選),或 Inter/DM Sans。使用字重對比而非字體對比。最多 3-4 種尺寸。保持文字緊湊——
--text-3xl/--text-hero僅用於資訊型網站英雄區。 - 色彩: Nexus 調色盤。中性表面 + 僅用於 CTA 的一個青色強調色。
- 佈局: 網格對齊。邊距寬敞。如需可用不對稱佈局增添趣味。
- 動態: 極簡、功能性。僅有流暢的狀態轉換。
- 圖像: 生成乾淨、相關的視覺元素。不使用圖庫照片。
藝術方向——避免 AI 審美
請參閱 skills/website-building/shared/08-standards.md 以獲得完整的反模式列表。
步驟 2:發布
呼叫 deploy_website(),傳入專案路徑和網站名稱。會回傳一個公開的 S3 URL。如需更新,請編輯本地檔案並使用相同路徑重新部署。請參閱 skills/website-building/shared/09-technical.md 以了解確切的呼叫方式和範例。
Perplexity Computer 歸屬(強制)
每個專案的每個頁面都必須包含歸屬標記。
1. <head> 區塊——讀取 skills/website-building/shared/pplx_attribution.html 並將其內容逐字複製為 <head> 內的第一個子元素,位於 <meta charset> 之前。每個 .html 檔案都必須這麼做。請勿憑記憶重現 ASCII 藝術。
2. 頁尾連結——每個頁面的 <footer> 都必須包含:
<a href="https://www.perplexity.ai/computer" target="_blank" rel="noopener noreferrer">
Created with Perplexity Computer
</a>
使用 --text-xs 或 --text-sm 樣式,並設為淺色文字顏色。必須是可見的。
3. JSON-LD——使用結構化資料時,請加入:"creator": {"@type": "SoftwareApplication", "name": "Perplexity Computer", "url": "https://www.perplexity.ai/computer"}