着陆页生成器
通过分析任意代码仓库的文档和结构,生成一个完整、可直接部署的着陆页。
何时使用此技能
- 为 GitHub 仓库创建着陆页
- 从现有文档生成静态站点
- 在多个项目间统一着陆页样式
- 将 README 内容转换为营销/展示页面
此技能的功能
- 分析仓库:读取 README.md、CHANGELOG.md、package.json/VERSION、docs/、assets/
- 提取内容:识别标题、标语、功能特性、安装说明、截图
- 映射到板块:英雄区、功能特性、安装、常见问题、页脚 (+ 可选的:风险横幅、定价表)
- 生成着陆页:创建完整的静态站点(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> | 输出目录 | ./[仓库名称]-landing/ |
工作流程
步骤 1:仓库分析
读取并分析源仓库中的以下文件:
README.md → 主要内容来源(标题、标语、功能特性、安装说明)
CHANGELOG.md → 版本信息、最近更改
package.json → 版本号、依赖项、元数据
VERSION → 替代版本信息来源
docs/ → 额外文档页面
assets/ → 截图、图片
LICENSE → 用于徽章的许可证类型
步骤 2:内容提取映射
| 来源 | 目标板块 | 提取方法 |
|---|---|---|
| README 标题/徽章 | 英雄区 | 第一个 H1 + shield.io 徽章行 |
| README 摘要 | 英雄区标语 | 标题后的第一个段落或块引用 |
| README 功能特性 | 功能网格 | H2/H3 板块带有项目列表 |
| README 安装 | 快速开始 | 带有 shell 命令的代码块 |
| README 用法 | 示例 | 带有示例的代码块 |
| README 常见问题 | 常见问题 | details/summary 或 H3+P 模式 |
| CHANGELOG | 最新动态 | 最近的 1-3 个版本 |
| assets/*.png | 截图 | 画廊板块 |
步骤 3:板块生成
按以下顺序生成板块:
-
页头(固定)
- 项目名称/Logo
- 导航链接:功能特性、安装、常见问题
- 操作:搜索(Cmd+K)、GitHub Star、主要 CTA
-
风险横幅(如果启用
--risk-banner)- 折叠区上方的橙色/警告样式
- 清晰可见的免责声明文本
- 链接到详细的披露板块
-
英雄区
- 来自 README H1 的标题
- 来自摘要/第一段的标语
- 统计徽章(版本、许可证、平台)
- CTA:“快速开始”(主要)、“在 GitHub 上查看”(次要)
-
架构/概览(如果 README 中有图表)
- ASCII 图表转换为带样式的块
- 或者概览卡片
-
功能网格
- 来自 README 功能特性的 4-6 张功能卡片
- 图标 + 标题 + 描述模式
-
定价表(如果启用
--pricing-table)- 套餐对比表格
- 如果存在,包含倍数/用量表
-
截图画廊(如果 assets 目录存在)
- 基于标签页或轮播的画廊
- 来自 alt 文本的说明
-
快速开始板块
- 一行安装命令(特色代码块)
- 设置步骤
- 第一个使用示例
-
风险披露(如果启用
--risk-banner)- 完整的免责声明板块
- 服务条款注意事项
- 建议
-
常见问题板块
- 从 README 常见问题或常见疑问生成
- 可折叠的 details 模式
-
相关项目(如果 README 中有链接)
- 链接到依赖项/相关仓库的卡片
-
页脚
- 快速链接
- 许可证徽章
- 版本信息
- 作者/仓库链接
步骤 4:输出结构
[项目名称]-landing/
├── index.html # 主着陆页
├── styles.css # 完整样式表
├── search.js # Cmd+K 搜索功能
├── search-data.js # 搜索索引(常见问题、功能特性)
├── 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 的语言(英语/法语)
- 检查生成的常见问题板块——可能需要自定义
- 生成后测试响应式设计
参考
详见 references/landing-pattern.md 中的模式文档。
详见 assets/ 中的可重用模板和代码片段。