Communitygithub.com

sandbox-safemode/365-castle-logos

打造獨特、具有生產力等級的網站,避免常見的「AI 垃圾」美學。每個選擇(字型、色彩、動態、版面)都必須經過深思熟慮。部署為靜態 HTML/CSS/JS 套件至 S3。

365-castle-logos 是什麼?

這項技能旨在協助開發者建立獨特且專業的網站,徹底避免 AI 生成內容常見的千篇一律感。它強調整體設計的每個細節(字型、色彩、動態、版面)都必須經過刻意選擇,並最終部署為靜態的 HTML、CSS、JavaScript 套件至 AWS S3。技能涵蓋資訊型網站、網頁應用程式及瀏覽器遊戲等專案類型,並提供明確的專案路由指引,引導使用者載入對應的子技能與領域文件。核心設計哲學(如 Nexus 設計系統的色彩與字型規則)透過共享文件統一管理,各專案類型可依需求擴充。此外,技能還包含嚴謹的工作流程,從藝術方向推斷、SVG Logo 生成,到透過 Playwright 進行視覺 QA 測試,確保最終成品具備一致的高品質與品牌辨識度。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sandbox-safemode/365-castle-logos/tree/HEAD/skills/website-building

在你喜歡的 AI 中提問

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

說明文件

網站建置

打造獨特、具有生產力等級的網站,避免常見的「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.md2D 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.mdSkeleton 載入器、空白/錯誤狀態、打磨細節一律載入
shared/08-standards.md無障礙、效能、反模式一律載入
shared/09-technical.md專案結構、沙箱、部署、檢查清單一律載入 †
shared/03-motion.md捲軸動畫、Motion 函式庫、GSAP SVG 外掛、懸停/游標使用動畫時載入
shared/06-css-and-tailwind.mdTailwind CSS v3、shadcn/ui、現代 CSS使用 Tailwind 時載入
shared/07-toolkit.mdCDN 函式庫、React、Three.js、圖示、地圖、SVG 模式/濾鏡、esm.sh選擇函式庫時載入
shared/10-charts-and-dataviz.mdChart.js、Recharts、D3、KPI、Sparklines需要資料視覺化時載入
shared/11-web-technologies.md框架版本、瀏覽器相容性檢查相容性時載入
shared/12-playwright-interactive.md持久化 Playwright 瀏覽器 QA、螢幕截圖、視覺測試進行測試時載入
shared/19-backend.mdFastAPI/Express/Flask 伺服器、WebSocket、SSE、埠號轉發需要後端時載入
shared/20-llm-api.mdLLM 聊天、圖片/影片/音訊生成、語音轉文字 — 模型、憑證、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.md2D Canvas 遊戲(game.md 的輔助檔案)
game/game-testing.md任何瀏覽器遊戲 — 需與 game.md 一起載入

互動式 QA: 閱讀 shared/12-playwright-interactive.md 以使用 Playwright(螢幕截圖、功能測試、視覺 QA)進行持久化瀏覽器自動化。遊戲測試必備,對任何複雜網站也很有用。


工作流程

  1. 設計方向:釐清目的,選定美學方向
  2. 版本控制:建構專案後在專案目錄中執行 git init。每個主要里程碑完成後以簡短訊息提交。
  3. 建置:逐頁建置網站,使用 Playwright 擷取螢幕截圖進行視覺 QA
  4. 發布:提交所有變更,然後執行 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。絕對不要用樣式化的文字標題來取代。

  1. 了解品牌 — 目的、調性、一個關鍵字
  2. 直接撰寫 SVG — 幾何形狀、字體或抽象標記。一個令人難忘的形狀。
  3. 原則: 幾何/極簡(Paul Rand、Vignelli)。24px 和 200px 都能正常運作。先黑白 — 再以顏色增強。使用 currentColor 以支援深色/淺色模式。
  4. 內嵌實作 使用 aria-label、viewBox、fill="none"、currentColor 描邊
  5. 產生 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

每建置完一個頁面:

  1. 透過 Playwright 擷取桌面(1280px+)和行動裝置(375px)的螢幕截圖
  2. 嚴格評估: 看起來是否專業設計(而非 AI 生成)?字型是否獨特?留白是否充足?是否有清晰的視覺層級?
  3. 在繼續前修正所有問題。 不留下視覺債務。

階段 2:最終 QA(發布前)

  1. 以桌面和行動裝置擷取每個頁面的螢幕截圖
  2. 檢查跨頁面一致性(間距、色彩、字型處理)
  3. 驗證深色模式(至少為首頁擷取兩種主題的螢幕截圖)
  4. 檢查互動狀態:懸停、焦點、啟用、載入、空白、錯誤
  5. 冷啟動第一印象測試:感覺是否精緻且經過深思熟慮?

QA 失敗項目: 文字溢出、間距不一致、色彩偏離標記、缺少深色模式、行動裝置畫面擠壓、AI 通用外觀、佔位符內容、缺少 Logo。


步驟 1:藝術方向 — 先推斷再詢問,先詢問再預設

每個網站都應擁有源自其內容的視覺識別。不要直接跳到 Nexus 備用調色盤。 Nexus 調色盤是當推斷和詢問都失敗時的最後手段,而不是方便的預設選項。

  1. 從主題推斷。 咖啡烘焙商網站 → 大地棕、暖奶油色、手繪風格。金融科技儀表板 → 冷灰板岩、銳利無襯線字體、資料密集。兒童學習應用程式 → 明亮原色、圓角字體、活潑動態。內容本身就告訴你調色盤、字型和間距,使用者甚至不用開口。
  2. 檢查藝術方向表格。 每個領域檔案(informational.md、webapp/SKILL.md、game/game.md)都有一個藝術方向表格,將網站/產品類型映射到概念驅動的方向和記號起點。將這些作為跳板。
  3. 推導五大支柱: 色彩(暖/冷、從主題擷取重點色)、字型(有襯線/無襯線、顯示性格)、間距(緊湊/寬敞)、動態(極簡/表現性)、圖像(照片/插圖/純文字)。
  4. 如果主題確實模糊,請詢問 — 「您想要什麼感覺?」和「有任何參考網站嗎?」一個問題就夠了。
  5. 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。

相關技能