Communitygithub.com

supersite-build

針對 AI 編碼代理的精密網站建構器。讀取 supersite-plan.md 規格合約,生成乾淨的可組合 React/Next.js 元件,串聯設計 token,並透過 npm run build 驗證編譯。

supersite-build 是什麼?

supersite-build 是一個專為 AI 編碼代理設計的精密網站建構器,它依據 supersite-plan.md 中的架構計劃,逐步執行從驗證規格、建立基礎架構、生成 UI 元件到組合頁面與驗證建置的完整流程。此工具支援 React 與 Next.js 生態系統,透過明確的建構管道確保程式碼品質與設計一致性。它會自動檢查相依套件、生成 TypeScript 類型定義與集中式設定檔,並注入 CSS 變數與無障礙設計。在最後階段,它會執行預先的「反 slop 稽核」,檢查禁止的樣式、觸控目標與 em dash 使用,然後執行 npm run build 以確保編譯無誤。這讓開發者能專注於策略決策,而由 AI 代理處理瑣碎的實作細節,並產生乾淨、可維護的程式碼。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/developer-mohanaditya/supersite/tree/HEAD/skills/supersite-build

在你喜歡的 AI 中提問

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

說明文件

🔨 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

  1. 在工作目錄根目錄尋找 supersite-plan.md。
    • 如果找不到,請暫停並通知使用者:

      「在專案根目錄找不到 supersite-plan.md。請執行 /supersite-plan 共同設計您的計劃,或執行 /supersite <prompt> 直接生成。」

  2. 從計劃中解析架構參數:
    • 美學類型與色彩調色盤(Hex/OKLCH,60-30-10 分佈)。
    • 字體排版與圓角選擇。
    • 路由與元件清單。
    • 區段文案、標題與互動元素。

步驟 2:基礎架構、類型與設定

  1. 驗證相依套件:
    • 確保標準工具已安裝(lucide-react、clsx、tailwind-merge)。若缺少則安裝:
      npm install lucide-react clsx tailwind-merge
      
  2. 生成 TypeScript 合約(src/types/site.ts):
    • 定義 NavItem、FeatureItem、PricingPlan、Testimonial 與 FAQItem 的類型。
  3. 生成集中式設定(src/config/site.ts):
    • 將導覽連結、品牌元資料與結構化區段內容儲存在一個位置。
  4. 更新基礎 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:組合路由並驗證建置

  1. 組合 src/app/page.tsx:
    • 匯入區段元件並以乾淨、宣告式的 JSX 編排敘事佈局。
  2. 組合其他路由:
    • 如果計劃指定了多頁路由(/features、/pricing、/security),建構對應的 page.tsx 檔案。
  3. 執行預先的反 Slop 稽核:
    • 檢查禁止的樣式:沒有紫色漸層模糊、沒有無背景的卡片、沒有通用的佔位符文案。
    • 檢查觸控目標:驗證互動熱區是否 ≥44×44px。
    • 檢查 em dash:驗證所有 UI 文案、標題、微文案與按鈕標籤中沒有 em dash(— 或 --)。
  4. 編譯與建置閘門:
    • 執行工作區建置指令:
      npm run build
      
    • 如果有任何 TypeScript 錯誤或缺失的匯入,立即修復並重新執行,直到建置以代碼 0 通過。
  5. 向使用者回報:
    • 在所有對話回應與進度報告中,強制執行零 Em Dash 規則(永遠不要使用 — 或 --)。改用句號、冒號、逗號或括號。
    • 提供建構檔案的簡潔摘要,並附上可點擊的連結:
      • [supersite-plan.md](file:///path/to/supersite-plan.md)
      • [page.tsx](file:///path/to/src/app/page.tsx)
      • src/components/site/ 中的個別元件連結
    • 確認編譯成功。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能