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