著陸頁面生成器
透過分析任何儲存庫的文件與結構,生成一個完整、可直接部署的著陸頁面。
何時使用此技能
- 為 GitHub 儲存庫建立著陸頁面
- 從現有文件生成靜態網站
- 標準化多個專案的著陸頁面
- 將 README 內容轉換為行銷/展示頁面
此技能的功能
- 分析儲存庫:讀取 README.md、CHANGELOG.md、package.json/VERSION、docs/、assets/
- 提取內容:識別標題、標語、功能、安裝方式、螢幕截圖
- 對應至區塊:Hero、Features、Install、FAQ、Footer(+ 可選:風險橫幅、價格表)
- 生成著陸頁:建立完整的靜態網站(HTML + CSS + JS)
- 可部署的輸出:包含用於 GitHub Pages 的 GitHub Actions 工作流程
如何使用
基本用法
/landing-page-generator from ~/path/to/repo
搭配選項
/landing-page-generator from ~/path/to/repo --risk-banner --pricing-table
可用選項
| 選項 | 說明 | 預設值 |
|---|---|---|
--risk-banner | 在摺疊上方加入顯眼的警告/免責聲明橫幅 | false |
--pricing-table | 包含價格比較區塊 | false |
--screenshots <path> | 螢幕截圖資料夾路徑 | ./assets/ |
--theme [dark|light] | 顏色主題變體 | dark |
--search | 啟用 Cmd+K 搜尋 | true |
--output <path> | 輸出目錄 | ./[repo-name]-landing/ |
工作流程
步驟 1:儲存庫分析
從來源儲存庫讀取並分析這些檔案:
README.md → 主要內容來源(標題、標語、功能、安裝)
CHANGELOG.md → 版本資訊、近期變更
package.json → 版本號碼、依賴項目、中繼資料
VERSION → 替代版本來源
docs/ → 其他文件頁面
assets/ → 螢幕截圖、圖片
LICENSE → 用於徽章的授權類型
步驟 2:內容提取對應表
| 來源 | 目標區塊 | 提取方法 |
|---|---|---|
| README 標題/徽章 | Hero | 第一個 H1 + shield.io 徽章行 |
| README TL;DR | Hero 標語 | 標題後的第一個段落或引用區塊 |
| README 功能 | Features 網格 | 帶有項目符號清單的 H2/H3 區塊 |
| README 安裝 | Quick Start | 包含 shell 指令的程式碼區塊 |
| README 用法 | Examples | 包含範例的程式碼區塊 |
| README FAQ | FAQ | Details/summary 或 H3+P 模式 |
| CHANGELOG | What's New | 最新的 1-3 個版本 |
| assets/*.png | Screenshots | 圖庫區塊 |
步驟 3:區塊生成
按順序生成這些區塊:
-
Header(黏性)
- 標誌/專案名稱
- 導覽連結:Features、Install、FAQ
- 動作:搜尋 (Cmd+K)、GitHub Star、主要 CTA
-
風險橫幅(若使用
--risk-banner)- 摺疊上方的橘色/警告樣式
- 清晰、可見的免責聲明文字
- 連結至詳細的揭露區塊
-
Hero 區塊
- 來自 README H1 的標題
- 來自 TL;DR/第一個段落的標語
- 統計徽章(版本、授權、平台)
- CTA:「Quick Start」(主要)、「View on GitHub」(次要)
-
架構/概述(若 README 中有圖表)
- 轉換為樣式化區塊的 ASCII 圖表
- 或概述卡片
-
功能網格
- 來自 README 功能的 4-6 張功能卡片
- 圖示 + 標題 + 說明模式
-
價格表(若使用
--pricing-table)- 方案比較表
- 若存在,則包含倍數/使用量表
-
螢幕截圖圖庫(若 assets 存在)
- 基於頁籤或輪播的圖庫
- 來自替代文字的說明
-
Quick Start 區塊
- 一行安裝指令(特色程式碼區塊)
- 設定步驟
- 第一個使用範例
-
風險揭露(若使用
--risk-banner)- 完整的免責聲明區塊
- 服務條款考量
- 建議
-
FAQ 區塊
- 從 README FAQ 或常見問題生成
- 可折疊的 details 模式
-
相關專案(若 README 中有連結)
- 連結至依賴項目/相關儲存庫的卡片
-
Footer
- 快速連結
- 授權徽章
- 版本資訊
- 作者/儲存庫連結
步驟 4:輸出結構
[project-name]-landing/
├── index.html # 主要著陸頁面
├── styles.css # 完整樣式表
├── search.js # Cmd+K 搜尋功能
├── search-data.js # 搜尋索引(FAQ、功能)
├── favicon.svg # 生成或複製的
├── robots.txt # SEO
├── CLAUDE.md # 專案指令
├── README.md # 著陸儲存庫文件
├── assets/ # 複製的螢幕截圖
│ └── [從來源複製]
└── .github/
└── workflows/
└── static.yml # GitHub Pages 部署
步驟 5:驗證檢查點
在最終確定之前,請驗證:
- 所有區塊在瀏覽器中正確渲染
- 連結指向有效目標(GitHub 儲存庫、文件、安裝指令)
- 響應式佈局在手機 (375px)、平板 (768px) 和桌上型電腦 (1280px) 寬度下正常運作
- 無障礙性:存在跳過連結、互動元素上有 ARIA 標籤、色彩對比度符合 WCAG AA 標準
技術棧
- 無建置步驟:純 HTML + CSS + JS
- 搜尋:從 CDN 延遲載入 MiniSearch 並附有備援方案
- 部署:透過 Actions 的 GitHub Pages
- 樣式:CSS 自訂屬性、響應式、預設暗色主題
- 無障礙性:跳過連結、ARIA 標籤、鍵盤導航
CSS 模式(來自已建立的著陸頁)
元件類別
/* 按鈕 */
.btn, .btn-primary, .btn-secondary, .btn-github-star, .btn-outline
/* 卡片 */
.feature-card, .comparison-card, .path-card
/* 佈局 */
.container, .features-grid, .hero, .section
/* 工具 */
.visually-hidden, .skip-link
CSS 變數
:root {
--color-bg: #0d1117;
--color-surface: #161b22;
--color-border: #30363d;
--color-text: #c9d1d9;
--color-text-muted: #8b949e;
--color-primary: #58a6ff;
--color-success: #3fb950;
--color-warning: #d29922;
--color-danger: #f85149;
--space-xs: 0.25rem;
--space-sm: 0.5rem;
--space-md: 1rem;
--space-lg: 1.5rem;
--space-xl: 2rem;
--radius: 6px;
}
範例
使用者:/landing-page-generator from ~/projects/my-project --risk-banner --pricing-table
輸出:
建立 ~/projects/my-project-landing/,包含:
- 展示多供應商路由器的完整著陸頁面
- 顯眼的服務條款風險橫幅(橘色,在摺疊上方)
- 供應商卡片(Anthropic、Copilot、Ollama)
- 來自 README 的價格表
- 螢幕截圖圖庫
- 已準備好進行 GitHub Pages 部署
提示
- 對於有法律/服務條款考量的專案,務必包含
--risk-banner - 螢幕截圖能顯著提升著陸頁品質 - 請確保 assets/ 已填滿
- 此技能會保留 README 的語言(英文/法文)
- 請審查生成的 FAQ - 可能需要自訂
- 生成後請測試響應式設計
參考資料
請參閱 references/landing-pattern.md 以取得詳細的模式文件。
請參閱 assets/ 以取得可重複使用的模板和程式碼片段。