著陸頁產生器
透過分析儲存庫的文件與結構,從任何儲存庫產生一個完整、可部署的著陸頁。
何時使用此技能
- 為 GitHub 儲存庫建立著陸頁
- 從現有文件生成靜態網站
- 跨多個專案標準化著陸頁
- 將 README 內容轉換為行銷/展示頁面
此技能的功能
- 分析儲存庫:讀取 README.md、CHANGELOG.md、package.json/VERSION、docs/、assets/
- 提取內容:識別標題、標語、功能、安裝說明、螢幕截圖
- 映射到區塊:Hero、功能、安裝、FAQ、頁尾(可選:風險橫幅、定價)
- 產生存地頁:建立完整靜態網站(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 功能 | 功能網格 | H2/H3 區塊搭配項目符號列表 |
| README 安裝 | 快速開始 | 包含 shell 命令的程式碼區塊 |
| README 使用方式 | 範例 | 包含範例的程式碼區塊 |
| README FAQ | FAQ | Details/summary 或 H3+P 模式 |
| CHANGELOG | 最新消息 | 最近 1-3 個版本 |
| assets/*.png | 螢幕截圖 | 圖庫區塊 |
步驟 3:區塊生成
按順序生成以下區塊:
-
頁首(固定)
- 標誌/專案名稱
- 導覽連結:功能、安裝、FAQ
- 動作:搜尋(Cmd+K)、GitHub Star、主要 CTA
-
風險橫幅(如果啟用
--risk-banner)- 摺疊處上方橙色/警告風格
- 清楚顯眼的免責聲明文字
- 連結至詳細揭露區塊
-
Hero 區塊
- 來自 README H1 的標題
- 來自 TL;DR/第一個段落的標語
- 狀態徽章(版本、授權、平台)
- CTA:「快速開始」(主要)、「在 GitHub 上檢視」(次要)
-
架構/概覽(如果 README 中有圖表)
- ASCII 圖表轉換為樣式化區塊
- 或概覽卡片
-
功能網格
- 來自 README 功能的 4-6 個功能卡片
- 圖示 + 標題 + 描述模式
-
定價表(如果啟用
--pricing-table)- 方案比較表
- 若有使用量倍數表
-
螢幕截圖圖庫(如果 assets 目錄存在)
- 分頁或輪播圖庫
- 來自替代文字的說明
-
快速開始區塊
- 一行安裝指令(重點程式碼區塊)
- 設定步驟
- 首次使用範例
-
風險揭露(如果啟用
--risk-banner)- 完整免責聲明區塊
- ToS 考量
- 建議
-
FAQ 區塊
- 從 README FAQ 或常見問題生成
- 可折疊 details 模式
-
相關專案(如果 README 中有連結)
- 指向依賴項/相關儲存庫的卡片
-
頁尾
- 快速連結
- 授權徽章
- 版本資訊
- 作者/儲存庫連結
步驟 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 並有備用方案
- 部署:透過 GitHub 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/,包含:
- 展示多供應商路由器的完整著陸頁
- 顯眼的 ToS 風險橫幅(橙色,在摺疊處上方)
- 供應商卡片(Anthropic、Copilot、Ollama)
- 來自 README 的定價表
- 螢幕截圖圖庫
- 可直接部署至 GitHub Pages
提示
- 對於有法律/ToS 考量的專案,請務必包含
--risk-banner - 螢幕截圖能顯著提升著陸頁品質 - 請確保 assets/ 目錄中有內容
- 此技能保留 README 的語言(英文/法文)
- 檢查生成的 FAQ - 可能需要自訂
- 生成後測試響應式設計
參考資料
詳見 references/landing-pattern.md 以取得詳細模式文件。
詳見 assets/ 以取得可重複使用的模板和程式碼片段。