Communitygithub.com

个人站从零生成 — 一句话 GSAP 作品集

一句话生成可部署个人作品集:纯 HTML/CSS/JS + GSAP,零构建工具,5 套主题、12 组字体搭配、16 条去 AI 味规则、8+ 动效模式。打开 index.html 即用——开发者作品集、创意展示、简历站或 bio-link 页。

个人站从零生成 — 一句话 GSAP 作品集 是什么?

个人站配方第 1 步(脚手架):Mort1d/portfolio-site portfolio-genesis。一句话 → 完整纯前端个人站,含主题/字体/GSAP/去 AI 味护栏,零工具链摩擦。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Mort1d/portfolio-site/tree/HEAD/skill/portfolio-genesis

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Portfolio Genesis

一键生成作品集。生成完整的、可部署的网站,具备专业的 GSAP 动画、响应式设计以及独特的美感,看起来像手工制作,而非 AI 生成。用户只需在浏览器中打开 index.html,即可看到高质量的作品集。

理念

  • 每个作品集都在讲述一个故事。设计本身即是作品集中的第一个项目。
  • 反模板化:生成的任何两个作品集看起来都不相同。主题由用户的领域、个性和基调驱动。
  • “打开 index.html,让你惊叹”——零 npm,零构建步骤,即时满足。
  • 约束即自由:原生 HTML/CSS/JS + GSAP 迫使你使用手工感的创意 CSS。
  • 三个精心呈现的项目胜过二十个普通卡片。质量胜于数量。
  • 滚动体验即是作品集本身。每次像素滚动都应感觉有目的性。

流程

第 1 步:信息收集

从用户提示中提取:

  • 身份:姓名、昵称/别名、角色/头衔
  • 简介:1-3 句话(如果未提供,则根据上下文综合)
  • 项目:标题、描述、标签、链接、交易金额、角色
  • 社交:X、Discord、Telegram、GitHub、LinkedIn、邮箱、YouTube(只包含已提供的)
  • 头像:文件路径或使用姓名首字母生成 CSS 渐变圆
  • 统计:经验年限、项目数量、社区影响力、探索过的工具
  • 基调:专业 | 黑客 | 创意 | 优雅 | 俏皮 | 简约 | 赛博

如果用户提供的信息极少,则生成具有上下文相关占位数据的内容,并标记注入点:<!-- CUSTOMIZE: Replace with your Twitter handle -->。如果未提供任何 URL,则完全省略社交按钮——切勿渲染 href="#"。

第 2 步:主题选择

使用下面的决策树从 5 个主题中进行选择。然后阅读 references/themes/{theme-name}.md 中的主题文件。

用户是否在加密/Web3/区块链领域?
  是 → 提到了“干净”/“简约”? → mono-minimal
        否则 → midnight-glass(默认)或 neon-cyberpunk(如果提到了“霓虹”/“赛博”)

用户是否是设计师/艺术家/创意工作者?
  是 → 偏好深色? → midnight-glass
        否则 → warm-organic(默认)或 paper-brutalist(如果提到了“编辑”/“印刷”)

用户是否是开发者/工程师?
  是 → midnight-glass(默认)或 mono-minimal(如果提到了“干净”/“简约”)

用户是否是学生/初学者?
  是 → warm-organic(友好)或 neon-cyberpunk(如果年轻/有活力)

用户是否是商务/专业人士?
  是 → mono-minimal(默认)或 warm-organic(如果“平易近人”)

显式覆盖(最高优先级):
  “深色”/“玻璃” → midnight-glass
  “浅色”/“干净”/“纸张” → paper-brutalist
  “霓虹”/“赛博”/“未来主义” → neon-cyberpunk
  “温暖”/“大地色”/“有机” → warm-organic
  “简约”/“单色”/“排版” → mono-minimal

第 3 步:生成文件

按此顺序读取参考文件:

  1. references/themes/{selected-theme}.md——颜色、字体、卡片样式
  2. references/animations/gsap-patterns.md——动画配方
  3. references/sections/hero-variants.md——选择英雄布局
  4. references/typography/font-pairings.md——确认字体选择

准确生成 3 个文件:index.html、css/style.css、js/main.js

英雄布局决策

是否提供了头像图片?
  是 → 居中头像(默认)
        例外:拥有强大项目展示的设计师 → 分割英雄
  否 → 强调标题/标语? → 全屏排版
        否则 → 简约(姓名 + 角色 + 滚动指示器)

角色描述数量:
  1 → 单个大号副标题
  2-3 → 点分隔的副标题行
  4+ → 使用 GSAP 文本交换实现动画角色轮换

项目部分决策

项目数量:
  0 → 跳过项目。改为添加技能/技术标签云部分
  1-2 → 大型特色卡片(全宽或 2 列并带有额外内边距)
  3-4 → 两列网格,尺寸相等
  5-8 → Bento 网格(1 个大卡片 + 若干小卡片)
  9+ → 显示前 6 个项目并带有“查看全部”链接,或水平滚动

第 4 步:质量检查

在输出文件之前,运行交付前检查清单。

输出结构

index.html

完整的语义化 HTML5。包含 Google Fonts 和 GSAP 3.12.5 的 CDN 链接。所有内容内联。部分:导航、英雄、关于、项目(如适用)、可选的字幕/技能、联系、页脚。包括:

  • <!DOCTYPE html>、<html lang="en">、charset、viewport
  • <title> 包含用户姓名 + 角色
  • <meta name="description"> 包含简介
  • OG 标签:og:title、og:description、og:type(website)
  • Google Fonts <link rel="preconnect"> + 样式表
  • GSAP + ScrollTrigger CDN,带有 defer
  • <link rel="stylesheet" href="css/style.css">
  • <script src="js/main.js" defer> 位于 body 末尾

css/style.css

所有样式。在 :root 定义 CSS 自定义属性(至少 20 个变量,涵盖颜色、字体、间距、圆角、缓动)。完全响应式(768px + 480px 断点)。必须包括:

  • 重置:*, *::before, *::after { margin:0; padding:0; box-sizing:border-box }
  • html { scroll-behavior: smooth } + 自定义滚动条
  • body { overflow-x: hidden; -webkit-font-smoothing: antialiased }
  • ::selection 使用主题强调色
  • 噪点叠加(内联 SVG feTurbulence,透明度 0.02-0.04)
  • .reveal-up { opacity: 0; transform: translateY(30px) } 初始状态
  • @media (prefers-reduced-motion: reduce)——禁用所有动画,隐藏光标发光
  • 每个装饰性固定/绝对定位元素:pointer-events: none

js/main.js

包装在 DOMContentLoaded 中的 GSAP 动画。以 GSAP 可用性检查开始:

if (typeof gsap === 'undefined') {
    document.querySelectorAll('.reveal-up').forEach(el => {
        el.style.opacity = '1';
        el.style.transform = 'none';
    });
    return;
}

注册 ScrollTrigger。包含:英雄入场时间线、滚动揭示、统计计数器、卡片倾斜、光标发光、磁性按钮、视差效果、导航收缩。阅读 references/animations/gsap-patterns.md 了解精确实现。

个性化点

位置数据源备用方案
<title>姓名 + 角色“Portfolio”
<meta description>角色 + 技能根据角色生成
OG 标签与标题/描述相同相同
导航标志括号中的句柄 [MX]姓名首字母
英雄 h1角色或身份陈述领域 + “Builder”
英雄副标题用 · 分隔的角色3 个技能领域
英雄徽章@句柄“@username”
头像 src + alt用户路径带有姓名首字母的 CSS 渐变圆
社交按钮仅实际 URL如果无 URL 则省略按钮
“关于”标题个人陈述“Building at the intersection of X, Y & Z”
“关于”简介用户提供或综合3 句简介
标签技能领域根据角色/项目生成
统计卡片实际数字 + 标签根据上下文估算
项目卡片标题、描述、标签、链接根据项目信息生成
联系卡片平台、句柄、URL仅已提供的平台
页脚姓名 + new Date().getFullYear()通过 JS 动态年份

反模式

#反模式为什么会失败应该怎么做
1使用 Inter/Roboto 作为标题字体立即暴露为“AI 生成”。这些是正文字体,不是展示字体。使用独特的展示字体:Syne、Outfit、Instrument Serif、Bricolage Grotesque、Unbounded
2白色背景上的紫色渐变自 2023 年以来排名第一的“AI 生成垃圾”视觉陈词滥调。每个人都能认出。深色背景搭配鲜艳强调色,或温暖调色板。
3默认使用 Space Grotesk2023 年时还独特,现在成为 AI 生成网站中最过度使用的字体。在 12 个精选配对中轮换。仅当用户明确品牌使用时才使用。
4opacity:0 没有 GSAP 备用方案如果 GSAP CDN 失败,整个站点不可见。空白页面。JS 第一行:检查 typeof gsap,如果未定义,将所有 .reveal-up 设置为可见。
5出色的英雄区域,折线以下部分平庸“惊叹”在滚动时消失。电影级英雄区域下方是千篇一律的卡片。每个部分都给予同等的设计关注。滚动之旅即是作品集本身。
6社交链接使用 href="#"使网站明显是假的。破坏可信度。使用实际 URL。如果未提供,则完全省略按钮。
7所有地方使用相同的动画时间设置所有内容以相同速度和相同缓动进行,感觉像机器人。变化持续时间(0.4s-1.2s)。每个元素使用不同的缓动。使用负偏移交错。
8装饰元素没有 pointer-events: none装饰球、噪点、光标发光会阻挡下方内容的鼠标点击。每个装饰性固定/绝对定位元素都获得 pointer-events: none。
9渐变文本位于渐变背景上无法阅读。两个竞争渐变相互抵消。渐变文本仅位于纯色/接近纯色的深色背景上。每个视觉区域一个渐变。
10卡片上缺少 cursor: pointer卡片看起来可交互,但光标保持默认,用户困惑。在每个具有悬停状态或点击处理程序的元素上设置 cursor: pointer。
11在 UI 中使用 Emoji 图标普遍的“AI 制造”信号。没有设计努力。来自 assets/social-icons.svg 的内联 SVG。导航、按钮、标题中无 emoji。
12width: 100vw在 Windows 上,包含滚动条宽度 → 水平溢出。使用 width: 100% 或 overflow-x: hidden(在 body 上)。
13为 5 个图标加载图标库额外的 HTTP 请求、FOUC、CDN 依赖,只为约 2KB 的 SVG 路径。直接在 HTML 中内联 SVG。5-8 个社交图标约 2KB 内联。
14通用 CTA 文本“Let's Connect” / “Get In Touch”——每个 AI 作品集都使用这些。匹配个性:"Let's Build Something"(建设者)、“Say gm”(加密)、“Drop a Line”(休闲)。
15头像缺少 alt无障碍失败。屏幕阅读器不宣布任何内容。alt="[用户姓名]" ——简单、描述性。
164 种以上颜色的彩虹渐变文本看起来像玩具。多色渐变很少有效。最多 2-3 种来自同一色系的颜色(粉色→紫色,不是粉色→绿色→蓝色)。

必需动画

阅读 references/animations/gsap-patterns.md 了解实现。每个站点必须包含:

  1. 英雄入场时间线 —— 交错 .from():头像(back.out)、徽章、标题行、副标题、社交图标(back.out 交错)、滚动指示器。使用负偏移重叠。
  2. 滚动揭示 —— .reveal-up 元素从 {y:30, opacity:0} 动画,起始点为 start: "top 85%"。在视口组内交错。
  3. 统计计数器 —— 通过 onUpdate 从 0 动画到目标值。滚动时触发。
  4. 卡片倾斜 —— mousemove → 根据光标偏移旋转 rotateX/rotateY。transformPerspective: 1000。鼠标离开时重置。
  5. 光标发光 —— 600px 径向渐变跟随鼠标,使用 requestAnimationFrame + 0.08 线性插值。
  6. 磁性按钮 —— 社交按钮向光标移动(0.3x 因子),使用 elastic.out(1, 0.5) 弹回。
  7. 视差背景 —— 装饰性元素在滚动时移动,使用 scrub: 1。
  8. 导航收缩 —— 在 80px 滚动深度时切换 .scrolled 类。

可选(根据主题/内容添加):

  • 带滚动速度提升的跑马灯
  • 逐字母分割文本揭示(赛博朋克/戏剧性)
  • 5 个以上项目的水平滚动
  • 悬停时渐变文字闪烁
  • 部分标签从左滑入

质量检查清单

结构:

  • 生成了所有 3 个文件(index.html、css/style.css、js/main.js)
  • 存在 DOCTYPE、charset、viewport、lang 属性
  • 包含用户实际信息的 OG 元标签
  • :root 中的所有 CSS 自定义属性
  • 带有 defer 的 GSAP CDN 链接
  • JS 在 body 末尾使用 defer 链接

内容:

  • 注入了所有用户数据(姓名、链接、项目、简介)
  • 没有通用占位符(“Lorem ipsum”、“Your Name Here”)
  • 社交链接使用实际 URL,对于已提供的链接没有 href="#"
  • 页脚具有正确的姓名和动态年份

视觉:

  • 字体配对不是 Inter、Roboto、Arial 或 Space Grotesk(除非用户指定)
  • 没有紫色配白色的配色方案
  • UI 中没有 Emoji 图标
  • 颜色对比度符合 WCAG AA 标准(正文文本 4.5:1)
  • 在 375px、768px、1440px 分辨率下响应式良好——没有水平滚动
  • prefers-reduced-motion 禁用动画并隐藏光标发光

技术:

  • 存在 GSAP 备用方案(typeof 检查 + 透明度重置)
  • 所有装饰性元素都有 pointer-events: none
  • CSS 中没有 width: 100vw
  • 所有交互元素都有 cursor: pointer
  • 图片有 alt 属性
  • 外部链接有 target="_blank" rel="noopener"

相关技能