Communitygithub.com

WebBuild – 讓網站不再像 AI 生成

為本地商家打造專業、具辨識度、可直接提案的商業網站,包含滾動驅動的『3D』英雄區塊(AI 影片隨滾動逐格播放)、即時 Three.js / React Three Fiber 場景、GSAP + Lenis 動態與經過調色的影片著色器。

WebBuild – 讓網站不再像 AI 生成 是什麼?

WebBuild 是一套專為 AI 代理器(如 Claude Code、Cursor、Codex)設計的技能,目標是幫助商家建立真正值得付費的網站,杜絕任何「AI 生成感」。它涵蓋從需求梳理、參考網站逆向工程、設計系統(字型、色彩、佈局、文案)、英雄區塊/素材管線、效能與無障礙、視覺 QA 截圖、AI 生成痕跡檢測(slop linter)、部署到向本地商家提案的完整流程。 本技能支援多種英雄模式:靜態圖片、經過色彩調製的影片、由 AI 生成關鍵幀並透過滾動控制的『3D』幀動畫,以及即時的 Three.js / R3F 場景。它內建多個腳本,例如 `teardown.mjs` 可分析參考網站的技術棧與設計元素,`shoot.mjs` 擷取多裝置滾動截圖與效能指標,`slop_check.py` 則能在出貨前自動檢查常見的 AI 生成痕跡與遺留的佔位符。 WebBuild 的獨特價值在於它把「避免看起來像 AI 生成的」作為核心設計原則,搭配具體的反模式檢查清單。使用者只要提到「3D 網站」、「滾動動畫」、「Awwwards 風格高價網站」、Three.js/GSAP/Spline,或想重建某個商家網站來提案銷售,或抱怨網頁看起來太模板化,都可以直接啟用此技能。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Harishisonline/webbuild-skill/tree/main

在你喜歡的 AI 中提問

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

說明文件

WebBuild – 讓網站不再像 AI 生成 是做什麼的?

打造讓商家願意付費的網站:專屬於他們、在手機上快速載入、一個令人難忘的亮點,並且沒有任何「這是 AI 做的」的感覺。工藝主要體現在寫程式之前的選擇,以及在完成後誠實地審視結果。

以下路徑皆相對於技能資料夾(scripts/、references/、assets/)。

0. 專案初始化(2 分鐘)

  • 新網站 → 將 assets/starter/ 複製到專案資料夾(純 HTML + CSS + ES 模組、固定 CDN 引入、無建置步驟:可部署到任何平台,易於修改)。僅在使用者要求或專案已使用 Next.js / Astro / R3F 時才使用這些框架(詳見 references/3d-playbook.md §5)。
  • 既有專案 → 保留其框架、設計代碼與元件;此技能僅添加方向、動態與 QA,而非重寫。
  • 在專案中建立 BUILD_NOTES.md。它作為跨上下文重置的記憶:摘要、決策、待解問題、已驗證的修正。

1. 需求釐清——挖掘真實的業務

收集(從使用者、商家現有網站、Google 商家檔案、Instagram):品牌名稱、銷售項目、地點、成立時間、一個主要行動(來電 / 預約 / 下單 / 詢價 / 到訪)、真實佐證(評價數量與分數、年資、執照、媒體報導)、真實照片、標誌/色彩、營業時間、地址、電話。將 references/design-system.md §2 中的 5 行簡報寫入 BUILD_NOTES.md。

絕對不要捏造事實——虛構的評價、統計數據、價格或地址一旦被業主讀到,就會立刻摧毀信任。取而代之的是:

  • 針對未知資訊巧妙迴避,讓示範版本看起來仍像完成品:例如用「Pune 的 Koregaon Park」代替捏造的門牌號碼;用「Google 評分 4.7」代替虛構的引述;列出服務名稱但不寫價格,或只在已知時寫「起價 ₹……」。
  • 當某項事實確實必要(如電話、完整地址、營業時間),使用可見的 {{佔位符}} ——slop_check.py 會阻擋出貨直到它被填寫。
  • 將所有未知與假設整理成一張「請詢問客戶」清單,放在最終報告中。

對於創作者或頻道網站,請事先索取(或擷取)後台數據與頭像:YouTube Studio / Instagram Insights 截圖,若已連接則加上 vidIQ 等工具。用真實數據建構的「成果」區塊才是賣點。

如果需求很模糊且使用者在線上,最多問 3 個問題(業務類型 + 城市、主要行動、任何他們喜歡的網站)。如果使用者希望你直接進行,就做出合理的假設、記錄下來,然後繼續前進。

2. 參考(當使用者指定網站、提供錄製畫面,或要求「重建」時)

遵循 references/reverse-engineer.md:使用 node scripts/teardown.mjs <網址> 測量參考網站的技術棧、字型、色板、媒體與著色器證據,並擷取滾動截圖;螢幕錄影會轉換為影格,供你閱讀並製作為逐拍動態規格。當快速分析無法解釋某個效果時,使用 REA 引擎深入分析:scripts/rea-teardown.sh <網址> 會擷取頁面、指紋辨識套件並匯出所有腳本,讓你了解其實際建構方式(指南在 references/rea/ 中)。記錄「觀察 → 推論 → 決策」。學習技術,但絕不抄襲品牌、文案、素材或程式碼。

3. 方向規劃——先規劃,再挑戰規劃

閱讀 references/design-system.md(反 AI 生成痕跡規則——經典的以及較新的「有品味的 AI」跡象,如奶油色 + 赤陶色、全大寫標題、編輯風格的細線)。在 BUILD_NOTES.md 中撰寫:

  • 4–6 個從商家提取的命名色彩代碼、字型配對與角色、圓角語言
  • 每個區塊的 ASCII 線框(變化節奏——不要一直英雄區塊 → 3 張卡片 → 標誌列 → 客戶推薦)
  • 一個標誌性時刻以及它為何適合此商家
  • 3 個使其獨特的原則

然後根據 AI 生成痕跡清單審查規劃,對每個看起來像預設的選擇,為此商家證明其合理性,或加以修改。問自己「如果換掉標誌,這個設計會不會看起來像任何其他商家的?」通常能在代價最低的階段發現大部分問題。

對於難以決定的方向,在使用者決定前,展示 2–3 個真正不同的方向(每個方向提供靜態圖或快速 HTML 草稿)——如果已安裝,21st-ui-explore 可以協助。

4. 英雄區塊——選擇最能服務商家的模式

references/3d-playbook.md §1 有決策表。簡短版:

  • 靜態(優質照片/版面)——適合餐廳、美食、沙龍、診所、服務業。通常是正確選擇。
  • 影片——氣氛循環,最好使用 assets/starter/grade.js 進行調色處理,讓 AI 或圖庫素材擁有訂製調色(顆粒感、光暈、lift/gamma/gain、暗角)。選擇一個 LOOK 並保持微妙。
  • 幀動畫——「10K 美元等級的 3D 網站」:AI 生成起始/結束關鍵幀 → 首幀/末幀影片 → scripts/frames.sh → 由滾動控制的 Canvas。閱讀 references/scroll-video-playbook.md 了解關鍵幀規則、提示與混合技巧。
  • 即時場景——當 3D 就是產品故事時使用即時 Three.js / R3F(可設定產品、建築、科技)。主體必須是商家的東西,絕不能用預設的繩結。
  • 全頁 3D——當業主說「3D 網站」時,他們通常指的是全頁 3D,而非只有英雄區塊。使用一個固定場景,每個區段設定一個攝影機位置(references/3d-playbook.md §6)。

使用已連接的工具(Higgsfield / Kling / kie.ai / Nano Banana MCP 或技能)生成素材,或要求使用者放入檔案。如果沒有任何工具可用,則使用明確標示的佔位符建構,並列出需要生成的素材以及提示詞。

5. 建構

順序:設計代碼(styles.css :root)→ 語意化的 HTML 區塊(使用真實文案)→ 在 390px 與 1440px 進行佈局 → 英雄模式 → 最後加入動態。

  • 文案規則:references/design-system.md §8(成果 + 地點 + 具體細節、真實的行動呼籲動詞、禁用詞彙)。
  • 商業網站必要項目:摺疊區域以上一個明顯的行動呼籲、底部再一個、tel: / 預約 / 表單、營業時間 + 地址 + 地圖連結、真實佐證、標題 + 描述 + OG 圖片、LocalBusiness JSON-LD、favicon、當主要行動是來電時,手機版需有固定的來電/預約列。
  • 動態:一個標誌性時刻 + 平穩的 150–300 毫秒微回饋;使用 ease-out,絕不使用 bounce;僅操作 transform/opacity;減少動畫模式顯示最終狀態。
  • 元件:在自行編寫複雜效果前,先搜尋 references/resources.md 中的元件庫(21st.dev、React Bits、Aceternity、Motion Primitives……),然後根據設計代碼重新設定樣式。在靜態網站中,將 React 元件以原生 JavaScript 重建,而不是為了單一效果引入 React。
  • 頁尾:依照 references/design-system.md §11 建構(品牌區塊、包含平台標誌的連結欄位、聯絡按鈕、超大字型標誌、底部列)。業主會用它來評斷整個網站。起始版中已包含小型建構者標示;客戶可要求移除。
  • 按鈕與滾動:遵循 references/design-system.md §12(觸感 0.16 秒按鈕、透過起始版的 cursor.js 提供游標光環、不使用原生滾動條:起始版的 blockbar.js 會取代它)。
  • 在宣布完成之前,重新閱讀 references/design-system.md §10:那些即使通過所有規則,業主仍然稱為 AI 生成痕跡的事物。

6. 檢視成品——好網站就是在這裡誕生的

在本機啟動伺服器(npx serve . 或專案的開發伺服器),然後:

  1. node scripts/shoot.mjs http://localhost:3000 ./shots——手機 / 筆電 / 桌機版本的滾動截圖 + 控制台錯誤、溢位、LCP、資源大小。閱讀 PNG 圖片。(如果可用,也可以使用瀏覽器面板或 Playwright MCP。)也使用 --reduced-motion 參數執行一次。
  2. python3 scripts/slop_check.py .——必須以 0 FAIL 結束。將 WARN 視為待回答的問題。(如果已安裝,npx impeccable detect 是很好的第二意見。)
  3. 根據需求誠實地提出批評:層級、字型、色彩、標誌性時刻、手機版、文案具體程度。以明確意圖分批修正(例如「下方區塊感覺太模板化——讓它們看起來更昂貴,而不是更雜亂」)。
  4. 在宣布完成前,移除一個裝飾性元素。

預期需要 3–6 輪;沒有人能一次到位。將修正記錄在 BUILD_NOTES.md 中。

7. 上線 + 提案

  • 部署:Vercel / Netlify / Cloudflare Pages / GitHub Pages。提交 frames 資料夾(最常見的「英雄區塊在上線後消失」的 bug)。在客戶購買前,在規格示範中加入 <meta name="robots" content="noindex">。
  • 如果是提案,閱讀 references/pitch-and-sell.md:前後比較影片、外展腳本、定價基準、提案檢查清單、交接事項。

給使用者的最終報告

保持簡短具體:

  • 建構了什麼(一行說明方向、標誌性時刻、英雄模式)及其位置(路徑、URL)
  • 如何執行(npx serve . 或開發指令)
  • QA 結果:slop_check 的 FAIL/WARN 數量、shoot.mjs 在各裝置的 LCP / 錯誤、審查與修正的項目
  • 請詢問客戶清單:每個 {{佔位符}} 與假設
  • 仍待生成的素材(附上可直接使用的提示詞),如果有的話

參考地圖

閱讀時機
references/design-system.md始終,在選擇顏色/字型/佈局/文案之前
references/3d-playbook.md選擇英雄模式時;任何 Three.js/R3F;效能與無障礙預算
references/scroll-video-playbook.md從 AI 影片建立滾動驅動的「3D」英雄區塊
references/reverse-engineer.md有參考網站、錄製畫面,或重建潛在客戶的網站時
references/rea/README.md需要比 teardown.mjs 更深入的分析時,使用 REA 工具
references/resources.md元件庫、效果工具、靈感來源、輔助技能
references/pitch-and-sell.md為潛在客戶建立規格示範、定價、外展、交接
腳本功能
scripts/teardown.mjs <網址>測量參考網站(技術棧、字型、色板、媒體、著色器、截圖)
scripts/rea-teardown.sh <網址>使用 REA 引擎深層分析:頁面擷取、套件指紋辨識、匯出的腳本
scripts/frames.sh <影片> <輸出>影片 → WebP 幀序列(桌機 + 手機)+ 清單檔
scripts/shoot.mjs <網址> [輸出]三種寬度的滾動截圖 + 錯誤/LCP/溢位
scripts/slop_check.py <目錄>AI 生成痕跡 + 出貨就緒度檢查(0 FAIL 才能出貨)

Playwright 用於 .mjs 腳本:npm i -D playwright && npx playwright install chromium。

相關技能