📐 supersite-plan:協作式架構師
supersite-plan 在撰寫程式碼之前先行規劃網站。它透過進行一場焦點式訪談、建立設計系統、起草敘事序列,並產出完整的 supersite-plan.md 專案合約,來防止預期落差。
一旦計劃確認,使用者只需執行 /supersite-build 即可將其付諸實現。
協作規劃流程
┌─────────────────────────────────────────────────────────────┐
│ 1. 多維度發現訪談 │
│ 提出結構化的前沿問題(選項 + 自訂提示) │
├─────────────────────────────────────────────────────────────┤
│ 2. 設計代碼與風格綜合 │
│ 將選擇對應到 60-30-10 調色盤、字體排版與材質 │
├─────────────────────────────────────────────────────────────┤
│ 3. 敘事與路由架構 │
│ 詳細說明章節順序、標題以及元件分解 │
├─────────────────────────────────────────────────────────────┤
│ 4. 輸出 supersite-plan.md 規格合約 │
│ 為 /supersite-build 的執行保存完整架構 │
└─────────────────────────────────────────────────────────────┘
步驟 1:前沿發現訪談
向使用者提出一組針對性的問題。每個問題都提供結構化選項,並附帶推薦預設值,同時明確歡迎自訂指示。
問題格式:
問題 [N]:[主題]
[A](推薦)選項 1 說明
[B] 選項 2 說明
[C] 選項 3 說明
👉 請回覆選項字母(A、B、C),或直接輸入您自己的具體指示。
零破折號規則(強制)
提問、措辭選項、撰寫文案或回覆使用者時,絕對不要使用破折號(— 或 --)。破折號會讓訪談問題和選項看起來像合成的 AI 模板文字。請改為用乾淨、肯定的句子來表達想法,或者使用冒號、逗號或括號。
4 個發現領域:
1. 網站範圍與路由層級
- [A](推薦)高轉換登陸頁面: 單頁敘事滾動,針對最大轉換速度最佳化(英雄區 → 問題 → 產品預覽 → 證據 → 定價 → 行動呼籲)。
- [B] 多頁 SaaS 架構: 多路由結構(
/首頁、/features深入介紹、/pricing定價矩陣與常見問題、/security合規)。 - [C] 工作室作品集與案例研究: 視覺展示(
/展示影片、/work/[slug]互動式案例研究、/inquire聯絡表單)。
2. 美學風格與材質基礎
- [A](推薦)暗色精準: 黑曜石表面(
#09090b)、髮絲邊框(border-white/10)、等寬字體遙測資料、雷射祖母綠或青色點綴。 - [B] 低調奢華: 觸感象牙白畫布(
#faf8f5)、深森林綠文字(#0c2217)、香檳金細節、編輯風格襯線字體標題。 - [C] 瑞士編輯風格: 大開本新聞紙質感、實心 1px 黑色分隔網格、朱紅色信號點綴、粗體無襯線/襯線對比。
- [D] 現代企業: 簡潔白色表面、深海軍藍信任色點綴、SOC2/HIPAA 合規徽章、密集的比較表格。
- [E] 大膽消費型: 溫暖奶油色畫布、2.5px 實心邊框、硬偏移投影、醒目霓虹點綴、俏皮微型文案。
- [F] 電影工作室: 全視口暗色舞台、環境背景漸層、即時產品展示、滾動驅動場景標記。
3. 核心能力與對比
- 這個產品消除了哪些特定的痛點或已經失效的現狀?
- 哪個具體、可量化的指標證明了你的優越性(例如 「冷啟動低於 14 毫秒」、「零 AWS 出口費用加成」,而非泛泛的 「超快」)?
4. 程式碼庫關係
- [A](推薦)全新乾淨建置: 使用標準 Next.js、React、Tailwind CSS 和 Lucide 圖示的新專案。
- [B] 從現有程式碼庫繼承(
from-codebase): 檢查本地儲存庫(globals.css、Tailwind 代碼、package.json)以匹配現有產品品牌。
步驟 2:綜合產出專案合約
使用者提供答案或指示後:
- 從
../supersite/references/genres/載入對應的風格藍圖。 - 套用
../supersite/references/anti-slop.md中的反雜亂規則。 - 使用
../supersite/references/copy-craft.md起草真實、高質感的標題與文案。 - 根據
../supersite/references/component-system.md定義可組合的元件分解。 - 執行零破折號規則:確保
supersite-plan.md中的描述、章節藍圖、標題和微型文案內完全不含破折號(—或--)。
步驟 3:撰寫 supersite-plan.md
將已確認的架構保存到專案根目錄的 supersite-plan.md 中:
# ⚡ supersite 規格合約:[專案名稱]
> 由 `/supersite-plan` 產生。使用 `/supersite-build` 執行。
## 1. 專案概述與目標受眾
* **產品:** [簡潔的產品說明]
* **目標受眾:** [特定角色,例如:資深基礎架構工程師]
* **主要轉換目標:** [例如:部署免費的測試叢集 / 預約企業示範]
## 2. 設計系統代碼
* **美學風格:** [例如:暗色精準]
* **60-30-10 調色盤:**
* 60% 背景畫布:`#09090b`(黑曜石)
* 30% 結構:`#121317`(面板)/ `#27272a`(髮絲邊框)/ `#fafafa`(文字)
* 10% 雷射點綴:`#10b981`(電光祖母綠)
* **字體排版:** 顯示用(`Geist Sans`)、遙測用(`Geist Mono`)
* **圓角半徑:** `rounded-lg`(按鈕 8px,卡片 12px)
## 3. 網站導覽與路由層級
* 路由 1:`/`(首頁轉換敘事)
* 路由 2:`/features`(架構與 API 深入介紹)
* 路由 3:`/pricing`(互動式分層矩陣與常見問題)
## 4. 逐章節藍圖
* **導航列:** 固定毛玻璃頂部標題(`backdrop-blur-md`)、標誌、連結、主要行動呼籲按鈕。
* **第 1 章(英雄區):**
* 標籤:`v2.4 版本 // 分散式向量快取`
* 主標題:*「部署無伺服器向量索引,全球讀取複本延遲僅 12 毫秒。」*
* 副標題:*「在邊緣儲存嵌入向量。自動同步至 32 個區域,零出口費用加成。」*
* 行動呼籲:*「立即部署叢集」* + *「閱讀 RFC」*
* 產品視覺:即時分頁互動式終端機(`TypeScript` / `cURL`)。
* **第 2 章(問題對比):** 集中式資料庫瓶頸 vs. 分散式邊緣快取的「之前/之後」對比。
* **第 3 章(功能展示區):** 3 個不對稱區塊(架構資料流、延遲圖表、SDK 易用性範例)。
* **第 4 章(社會證明):** 量化指標(每日 1420 萬個向量、99.99% 正常運作時間)+ 2 則經過驗證的工程師見證。
* **第 5 章(定價矩陣):** 開發者(免費)、團隊(每月 49 美元)、企業(自訂)含計費週期切換。
* **第 6 章(常見問題):** 4 個技術揭露手風琴式元件。
* **頁尾:** 網站地圖、狀態指示燈、版權與合規徽章。
## 5. 檔案與元件清單
* `src/components/ui/container.tsx`
* `src/components/ui/section-header.tsx`
* `src/components/ui/button.tsx`
* `src/components/site/navbar.tsx`
* `src/components/site/hero.tsx`
* `src/components/site/problem-contrast.tsx`
* `src/components/site/feature-grid.tsx`
* `src/components/site/social-proof.tsx`
* `src/components/site/pricing-matrix.tsx`
* `src/components/site/faq-accordion.tsx`
* `src/components/site/footer.tsx`
* `src/config/site.ts`
* `src/types/site.ts`
## 6. 起飛前驗證標準
* 零個紫色漸層圓形或泛用 AI 模糊區塊。
* 符合 WCAG 2.2 AA 對比度要求(文字 ≥4.5:1,UI 邊界 ≥3.0:1)。
* 行動裝置觸控目標 ≥44×44 像素。
* `npm run build` 成功執行,且無任何 TypeScript 或樣式警告。
步驟 4:後續行動提示
在寫入 supersite-plan.md 後,通知使用者:
計劃完成! 架構合約已寫入
supersite-plan.md。 請檢視計劃或要求任何調整。當您準備好建構網站時,請觸發:/supersite-build