Communitygithub.com

supersite-plan

協作式網站架構設計師,專為 AI 編碼代理而生。透過結構化的前沿訪談提供選項與自訂指示,設計網站敘事與美學,並輸出完整的 supersite-plan.md 規格書。

supersite-plan 是什麼?

supersite-plan 是一個專為 AI 編碼代理(如 Claude Code、Cursor、Codex)設計的協作式網站架構工具,其核心目標是在實際撰寫程式碼之前先完成完善的規劃,避免後續的預期落差。該技能透過結構化的「前沿發現訪談」,引導使用者從 4 個面向(網站範圍與路由層級、美學風格與材質基礎、核心能力與對比、程式碼庫關係)進行選擇或提供自訂指示。訪談完成後,supersite-plan 會自動載入對應的風格藍圖,套用反雜亂規則與文案撰寫指南,生成完整的設計代碼色票、字體排版、章節藍圖與元件清單,最終產出一份名為 `supersite-plan.md` 的專案合約。這份合約可作為後續 `/supersite-build` 技能執行的輸入。該技能強制要求遵循「零破折號規則」,確保生成的文案自然流暢,避免 AI 合成的機械感。支援新建專案(Greenfield)或從現有程式碼庫(from-codebase)繼承樣式。

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

在你喜歡的 AI 中提問

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

說明文件

📐 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:綜合產出專案合約

使用者提供答案或指示後:

  1. 從 ../supersite/references/genres/ 載入對應的風格藍圖。
  2. 套用 ../supersite/references/anti-slop.md 中的反雜亂規則。
  3. 使用 ../supersite/references/copy-craft.md 起草真實、高質感的標題與文案。
  4. 根據 ../supersite/references/component-system.md 定義可組合的元件分解。
  5. 執行零破折號規則:確保 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

Individual skills in this repo

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

相關技能