Communitygithub.com

rizkydarm/ClusteringAIAgentsSkills-Python

用於打造具辨識度、生產級品質的網站、登陸頁面與互動式網頁體驗,強調嚴謹的設計與 QA 紀律。

ClusteringAIAgentsSkills-Python 是什麼?

這個技能為 AI 代理提供了一套完整的網站建置工作流程,從初始設計到最終部署與品質確保。其核心哲學是為每個網站打造獨特的視覺識別:要求代理根據主題關鍵詞產生獨一無二的調色盤,並從永不放棄重複使用同一套配色。技能內容涵蓋多種網站類型(資訊型、Web 應用、瀏覽器遊戲),並提供對應的子技能與參考文件。它整合了設計原則(色彩、字體、排版、動畫)、技術實作(Tailwind CSS、React、Three.js)與嚴格 QA 流程(使用 Playwright 進行響應式螢幕截圖與互動測試)。此技能適用於 Claude Code 等平台,能引導代理從藝術方向、調色盤生成、SVG Logo 設計,一路到最終發布與視覺品質驗證,確保產出具有專業設計感而非生成式 AI 常見的平庸外觀。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rizkydarm/ClusteringAIAgentsSkills-Python/tree/HEAD/_skill/website-building

在你喜歡的 AI 中提問

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

說明文件

網站建置

打造具有辨識度的生產級網站,讓每個網站的外觀都不同。每一項選擇——字體、色彩、動態、佈局——都必須源自於主題內容。執行調色盤產生器(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.mdSaaS 產品、儀表板、管理後台、電子商務、品牌體驗
瀏覽器遊戲read skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game.md + skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game-testing.md2D 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.mdSkeleton 載入器、空白/錯誤狀態、打磨總是
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.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、迷你圖需要資料視覺化時
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/AI API 整合參考網站使用 AI API 時

所有路徑均相對於 skills/GENERAL-KNOWLEDGE-WORKER/website-building/。

† Web 應用程式與儀表板請跳過——這些實作細節已在 fullstack 模板中預先設定。設計記號與字體規則不可跳過——它們為所有專案類型提供權威的設計系統預設值與字體選擇指引。

領域特定——載入其中一個

檔案何時載入
read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.mdSaaS、儀表板、管理後台、電子商務、品牌體驗(包含 fullstack 模板的子技能)
webapp/dashboards.md儀表板或資料密集型介面(webapp 的配套檔案)
informational/informational.md個人網站、作品集、編輯、小型企業、登陸頁面
game/game.md瀏覽器遊戲、Three.js、WebGL、互動式 3D
game/2d-canvas.md2D 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。絕對不要使用樣式化的文字標題來替代。

  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 測試流程

每次部署都必須通過視覺 QA。螢幕截圖是品質閘門。

請閱讀 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md 以了解所有視覺 QA 細節。Playwright 提供持久化的瀏覽器工作階段,用於螢幕截圖、互動測試與視窗驗證。

循環: 建置 → Playwright QA → 評估 → 修正 → 重複 → 準備好時部署

階段 1:逐頁 QA

建置每個頁面後:

  1. 透過 Playwright 在桌面(1280px+)與行動裝置(375px)進行螢幕截圖
  2. 嚴格評估: 看起來是專業設計(而非 AI 生成)嗎?字體有特色嗎?留白充裕嗎?有一個清晰的視覺層級嗎?
  3. 在繼續前修正每個問題。 不留視覺債。

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

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

QA 失敗項目: 文字溢出、間距不一致、不符合設計記號的顏色、缺少深色模式、行動版被壓縮、生成式 AI 的平庸外觀、佔位內容、缺少 Logo。


步驟 1:藝術方向——先推斷,再提問,最後才使用預設值

每個網站都應擁有源自其內容的視覺識別。不要直接跳到 Kortix 備用調色盤。 Kortix 調色盤是在推斷與提問都失敗時的最後手段——不是一個方便的預設選項。

  1. 從主題推斷。 咖啡烘焙商網站 → 大地棕、溫暖奶油色、手繪風格。金融科技儀表板 → 冷色石板灰、銳利無襯線字體、資料密集。兒童學習應用 → 明亮原色、圓角字體、活潑動畫。內容本身在用戶說話之前,就告訴你調色盤、字體與間距。
  2. 檢查藝術方向表格。 每個領域檔案(informational.md、webapp/SKILL.md、game/game.md)都有一個藝術方向表格,將網站/產品類型映射到概念驅動的方向與設計記號起點。將這些作為跳板。
  3. 推導五大支柱: 色彩(暖/冷、強調色源自主題)、字體(有襯線/無襯線、標題個性)、間距(密集/寬裕)、動態(極簡/表現力)、圖像(照片/插圖/純文字)。
  4. 如果主題確實模糊,請提問——「您想要什麼樣的氛圍?」以及「有沒有參考網站?」問一個問題就夠了。
  5. 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 啟動預覽或開發伺服器。
  • 如果目標儲存庫已有部署工作流程,請使用該確切的工作流程。
  • 如果沒有既定的部署目標,請交付檔案與經過驗證的本地預覽,而非自行發明一個特定平台的部署流程。

相關技能