落地页生成器
通过分析仓库的文档和结构,从任意代码仓库生成完整、可部署的落地页。
何时使用此技能
- 为 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]` | 颜色主题变体 |
--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步:部分生成
按顺序生成以下部分:
-
页眉(固定)
- Logo/项目名称
- 导航链接:功能、安装、FAQ
- 操作:搜索(Cmd+K)、GitHub Star、主要 CTA
-
风险横幅(如果使用
--risk-banner)- 橙色/警告风格,位于首屏上方
- 清晰可见的免责声明文本
- 链接到详细的披露部分
-
Hero 部分
- 来自 README H1 的标题
- 来自 TL;DR/第一段的标语
- 统计徽章(版本、许可证、平台)
- CTA:“快速开始”(主要)、“在 GitHub 上查看”(次要)
-
架构/概述(如果 README 中有图示)
- ASCII 图示转换为样式化块
- 或概述卡片
-
功能网格
- 来自 README 功能的4-6个功能卡片
- 图标 + 标题 + 描述模式
-
定价表(如果使用
--pricing-table)- 计划对比表格
- 如果存在,包含倍数/用量表
-
截图画廊(如果存在资源)
- 基于标签或轮播画廊
- 来自替代文本的说明
-
快速开始部分
- 一行安装命令(特色代码块)
- 设置步骤
- 第一个用法示例
-
风险披露(如果使用
--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,并有回退方案
- 部署:通过 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/。