🔨 supersite-build:精密建構器
supersite-build 執行由 /supersite-plan 建立的架構計劃。它讀取 supersite-plan.md、建構原子元件、串聯設計 token 與文案,並驗證實作是否符合建置引擎。
執行管線
┌─────────────────────────────────────────────────────────────┐
│ 1. 讀取並驗證規格合約 │
│ 從 supersite-plan.md 解析 token、路由與清單 │
├─────────────────────────────────────────────────────────────┤
│ 2. 基礎架構、類型與設定 │
│ 建立 src/types/site.ts、src/config/site.ts 與基礎 CSS │
├─────────────────────────────────────────────────────────────┤
│ 3. 建構 UI 基礎元件 │
│ Container、SectionHeader、Button、Badge 與 Card │
├─────────────────────────────────────────────────────────────┤
│ 4. 建構區段區塊 │
│ Navbar、Hero、Contrast、Features、Proof、Pricing 與 Footer │
├─────────────────────────────────────────────────────────────┤
│ 5. 組合路由並驗證建置 │
│ 組織頁面、檢查無障礙性並執行 npm run build │
└─────────────────────────────────────────────────────────────┘
步驟 1:讀取並驗證 supersite-plan.md
- 在工作目錄根目錄尋找
supersite-plan.md。- 如果找不到,請暫停並通知使用者:
「在專案根目錄找不到
supersite-plan.md。請執行/supersite-plan共同設計您的計劃,或執行/supersite <prompt>直接生成。」
- 如果找不到,請暫停並通知使用者:
- 從計劃中解析架構參數:
- 美學類型與色彩調色盤(Hex/OKLCH,60-30-10 分佈)。
- 字體排版與圓角選擇。
- 路由與元件清單。
- 區段文案、標題與互動元素。
步驟 2:基礎架構、類型與設定
- 驗證相依套件:
- 確保標準工具已安裝(
lucide-react、clsx、tailwind-merge)。若缺少則安裝:npm install lucide-react clsx tailwind-merge
- 確保標準工具已安裝(
- 生成 TypeScript 合約(
src/types/site.ts):- 定義
NavItem、FeatureItem、PricingPlan、Testimonial與FAQItem的類型。
- 定義
- 生成集中式設定(
src/config/site.ts):- 將導覽連結、品牌元資料與結構化區段內容儲存在一個位置。
- 更新基礎 CSS(
src/app/globals.css):- 注入顏色變數、選取樣式與減少動態無障礙區塊:
@layer base { ::selection { background-color: var(--accent); color: var(--accent-foreground); } } @media (prefers-reduced-motion: reduce) { *, ::before, ::after { animation-duration: 0.01ms !important; animation-iteration-count: 1 !important; transition-duration: 0.01ms !important; scroll-behavior: auto !important; } }
- 注入顏色變數、選取樣式與減少動態無障礙區塊:
步驟 3:建構 UI 基礎元件(src/components/ui/)
生成模組化基礎元件:
container.tsx:最大寬度容器(max-w-6xl或max-w-7xl)以及響應式內距。section-header.tsx:標準化的徽章、標題與描述區塊。button.tsx:基於變體的按鈕(primary、secondary、outline、ghost)並帶有明確的:focus-visible樣式。badge.tsx:藥丸形與狀態標籤,帶有纖細的邊框。card.tsx:應用計劃的表面顏色、邊框與圓角 token 的表面包裝器。
步驟 4:建構區段區塊(src/components/site/)
建構計劃中指定的每個區段:
navbar.tsx:響應式頁首,包含桌面導覽連結、行動呼籲按鈕與行動版漢堡選單抽屜。hero.tsx:鉤子藥丸、H1 標題、引導段落、行動呼籲按鈕群組與互動式產品預覽(例如終端機或 UI 框架)。problem-contrast.tsx:不對稱視覺對比,展示現狀的困擾與現代化解決方案。feature-grid.tsx:不對稱的 bento 網格或模組化功能單元。無重複的三卡副本。product-showcase.tsx:互動式元件(標籤式程式碼瀏覽器、即時互動預覽或設定遊樂場)。social-proof.tsx:可驗證的指標重點與客戶推薦引言,附帶具體工程角色。pricing-matrix.tsx:月付/年付帳單切換(使用"use client")、方案卡片、功能核取清單與結帳行動呼籲按鈕。faq-accordion.tsx:可展開的技術問答,使用平滑 CSS 網格高度過渡。footer.tsx:多欄導覽連結、法律錨點、系統狀態點與版權聲明。
步驟 5:組合路由並驗證建置
- 組合
src/app/page.tsx:- 匯入區段元件並以乾淨、宣告式的 JSX 編排敘事佈局。
- 組合其他路由:
- 如果計劃指定了多頁路由(
/features、/pricing、/security),建構對應的page.tsx檔案。
- 如果計劃指定了多頁路由(
- 執行預先的反 Slop 稽核:
- 檢查禁止的樣式:沒有紫色漸層模糊、沒有無背景的卡片、沒有通用的佔位符文案。
- 檢查觸控目標:驗證互動熱區是否 ≥44×44px。
- 檢查 em dash:驗證所有 UI 文案、標題、微文案與按鈕標籤中沒有 em dash(
—或--)。
- 編譯與建置閘門:
- 執行工作區建置指令:
npm run build - 如果有任何 TypeScript 錯誤或缺失的匯入,立即修復並重新執行,直到建置以代碼 0 通過。
- 執行工作區建置指令:
- 向使用者回報:
- 在所有對話回應與進度報告中,強制執行零 Em Dash 規則(永遠不要使用
—或--)。改用句號、冒號、逗號或括號。 - 提供建構檔案的簡潔摘要,並附上可點擊的連結:
[supersite-plan.md](file:///path/to/supersite-plan.md)[page.tsx](file:///path/to/src/app/page.tsx)src/components/site/中的個別元件連結
- 確認編譯成功。
- 在所有對話回應與進度報告中,強制執行零 Em Dash 規則(永遠不要使用