Communitygithub.com

TasmiaZerin1128/TasmiaZerin1128.github.io

为软件工程师构建富有艺术感、基于GSAP动画的个人作品集网站和页面区域。当用户要求创建作品集、个人网站、开发者登陆页、关于我、技能展示、项目展示或任何与作品集相关的Web组件时使用此技能——尤其是希望页面富有创意、动画效果或视觉独特性,同时保持开发者/工程师身份时。

TasmiaZerin1128.github.io 是什么?

该技能专为软件工程师打造极具视觉冲击力和叙事性的在线作品集。它摒弃了传统的“个人介绍+卡片网格”的平淡设计,转而通过GSAP动画库,将网页浏览转变为一场精心编排的“故事叙述”。技能提供了多种美学方向(如终端暗夜、野蛮代码、柔光工程等),并内置了丰富的GSAP动画模式,包括交错淡入、文字拆分动画、滚动驱动固定、视差分层和鼠标磁吸效果,确保每个动画都服务于内容,而非炫技。该技能支持CDN和npm两种GSAP集成方式,适用于纯HTML和React项目。此外,它还涵盖了页面结构设计(英雄区、关于区、技能区、项目展示区和联系区)、字体搭配建议、颜色系统定义、性能优化(will-change、懒加载)以及移动端适配和可访问性(prefers-reduced-motion)的最佳实践。最终产出通常是一个包含嵌入CSS和JS的单一HTML文件,便于快速部署和展示。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/TasmiaZerin1128/TasmiaZerin1128.github.io/tree/HEAD/.claude/skills

在你喜欢的 AI 中提问

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

文档

GSAP 作品集技能

构建一个既像创意工作室制作、又保留软件工程师灵魂的作品集网站。目标绝不是一个“带着英雄区和卡片的公司式开发作品集”。目标是创造一种让人忍不住停下来浏览的体验。

核心理念

开发者的作品集通常以两种方式失败:要么太过乏味(白底、卡片网格、“你好,我是一名开发者”),要么过度使用与内容脱节的炫技效果。最佳的平衡点是有目的的戏剧性——每一个动画都应该感觉是在揭示某种东西,而不是为了动而动。

将作品集视作一个叙事,而非一个页面。访客被引导着经历一个故事:你是谁 → 你做了什么 → 你的思考方式 → 如何联系你。

GSAP 集成

始终从 CDN 加载 GSAP。使用 GSAP CDN(而非 cdnjs)上的最新版本:

<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>

对于 React 项目,通过 npm 安装:

npm install gsap
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);

核心 GSAP 模式

1. 交错淡入 — 核心模式。永远不要一次性显示一组元素。

gsap.from('.skill-item', {
  y: 60,
  opacity: 0,
  duration: 0.8,
  stagger: 0.12,
  ease: 'power3.out',
  scrollTrigger: {
    trigger: '.skills-section',
    start: 'top 80%',
  }
});

2. 文字拆分动画 — 将标题拆分为字符/单词并逐个动画。这是能添加的最高影响力的动画。如果可用,使用 SplitText 插件,或者手动用 <span> 拆分:

// 手动字符拆分
const heading = document.querySelector('.hero-title');
heading.innerHTML = heading.textContent.split('').map(
  (char, i) => `<span class="char" style="display:inline-block">${char === ' ' ? '&nbsp;' : char}</span>`
).join('');

gsap.from('.char', {
  y: 120,
  opacity: 0,
  rotateX: -80,
  stagger: 0.03,
  duration: 1,
  ease: 'power4.out',
});

3. 滚动驱动固定 — 固定页面区域,并在用户滚动时对其中内容进行动画。营造“电影感”。

gsap.timeline({
  scrollTrigger: {
    trigger: '.pinned-section',
    start: 'top top',
    end: '+=200%',
    pin: true,
    scrub: 1,
  }
})
.from('.reveal-1', { xPercent: -100, opacity: 0 })
.from('.reveal-2', { yPercent: 50, opacity: 0 }, '-=0.3')
.from('.reveal-3', { scale: 0.8, opacity: 0 }, '-=0.3');

4. 视差分层 — 通过不同的滚动速度赋予深度感。

gsap.to('.bg-layer', {
  yPercent: -30,
  ease: 'none',
  scrollTrigger: {
    trigger: '.parallax-section',
    start: 'top bottom',
    end: 'bottom top',
    scrub: true,
  }
});

5. 鼠标磁吸 / 跟随鼠标效果 — 用于 CTA 或精选项目等交互元素。

const btn = document.querySelector('.magnetic-btn');
btn.addEventListener('mousemove', (e) => {
  const rect = btn.getBoundingClientRect();
  const x = e.clientX - rect.left - rect.width / 2;
  const y = e.clientY - rect.top - rect.height / 2;
  gsap.to(btn, { x: x * 0.3, y: y * 0.3, duration: 0.4, ease: 'power2.out' });
});
btn.addEventListener('mouseleave', () => {
  gsap.to(btn, { x: 0, y: 0, duration: 0.6, ease: 'elastic.out(1, 0.4)' });
});

6. 水平滚动区域 — 非常适合项目展示。纵向滚动,但内容水平移动。

const track = document.querySelector('.horizontal-track');
const items = gsap.utils.toArray('.project-card');

gsap.to(items, {
  xPercent: -100 * (items.length - 1),
  ease: 'none',
  scrollTrigger: {
    trigger: track,
    pin: true,
    scrub: 1,
    end: () => '+=' + track.scrollWidth,
  }
});

更多高级模式(包括形状变形、自定义鼠标轨迹、基于噪声的运动和 WebGL 集成提示)请阅读 references/gsap-patterns.md。

美学方向

对于软件工程师的作品集,以下美学方向效果最佳。每个项目选择一个——切勿混合:

1. 终端暗夜

深色背景,等宽字体搭配锐利无衬线字体,绿色/琥珀色/青色强调色点缀在黑色之上。感觉就像你在一个终端里——但一个漂亮的终端。使用扫描线叠加、闪烁光标、打字机动画。想象一下:黑客美学遇上编辑设计。

2. 野蛮代码

原始、暴露的结构。可见网格线、大号等宽字体、强烈的对比。元素看起来像是故意用 position: absolute 放置的。动画迅速而机械——不要使用缓出,使用 steps() 或 power4.inOut。想象一下:如果编译器有品味。

3. 柔光工程

浅色背景搭配温暖的中性色、充足的留白、优雅衬线字体(用于标题)搭配干净的无衬线字体。流畅、连续的动画。感觉高级而宁静。想象一下:Dieter Rams 设计作品集的样子。

4. 霓虹建筑师

深色基底、鲜艳的霓虹强调色(洋红、电光蓝、石灰)、玻璃态、发光效果。动画流畅,几乎是液态的。基于网格的布局,带有重叠元素。想象一下:银翼杀手 meets 瑞士设计。

5. 模拟数字

纸质纹理、手绘元素与锐利数字字体混合、微妙的颗粒叠加。暖色调色板。动画模拟物理运动——物体像纸一样滑动,像卡片一样堆叠。想象一下:一个也喜欢画画的开发者。

章节架构

一个优秀的作品集遵循以下结构。每个部分应该感觉像是一个独立的“场景”:

英雄区

最初的 3 秒最重要。从文字动画开始——访客应该看到你的名字鲜活起来。背景中包含微妙的氛围动画(浮动粒子、变形形状、渐变动画)。信息保持极其简洁:名字 + 一行身份介绍。

关于 / 理念

不要只罗列事实。表达一种世界观。使用滚动触发的揭示,逐行展示文字。照片可选,如果包含,使用创意处理(双色调、clip-path 揭示、视差偏移)。

技能 / 技术栈

永远不要使用无聊的 Logo 网格。尝试:轨道可视化、滚动条/跑马灯、悬停反应的交互式标签、星座图或“自打字”的终端风格列表。

项目

核心部分。每个项目都需要呼吸空间。使用:水平滚动画廊、全屏堆叠卡片(固定并过渡)、或带滚动触发揭示的可扩展卡片。每个项目应显示:标题、简短描述、所用技术、视觉展示(截图、视频或创意插图)。

联系 / 页脚

有目的地结束。大型排印 CTA,也许是基于时间的问候(“晚上好——我们聊聊”),以及整洁的联系链接。保持精炼。

每种章节类型的详细 HTML/CSS/JS 模板请阅读 references/portfolio-sections.md。

字体规则

从 Google Fonts 导入字体。永远不要使用系统字体或 Inter/Roboto。

适用于开发者作品集的好配搭:

  • Display + Body: "Clash Display" + "Satoshi"(通过 fontshare.com CDN)
  • Display + Body: "Syne" + "Work Sans"(Google Fonts)
  • Display + Body: "Space Grotesk" + "DM Sans"(Google Fonts)——仅当走科技风格时
  • Mono + Sans: "JetBrains Mono" + "General Sans"(fontshare)——用于终端美学
  • Serif + Sans: "Playfair Display" + "Source Sans 3"——用于柔和/高级方向
  • Display + Body: "Anybody" + "Instrument Sans"(Google Fonts)
  • Display + Body: "Bricolage Grotesque" + "Geist"(通过 CDN)

加载方式:

<link href="https://api.fontshare.com/v2/css?f[]=clash-display@400,500,600,700&f[]=satoshi@400,500,700&display=swap" rel="stylesheet">

或

<link href="https://fonts.googleapis.com/css2?family=Syne:wght@400;500;600;700;800&family=Work+Sans:wght@300;400;500;600&display=swap" rel="stylesheet">

颜色规则

使用 CSS 自定义属性定义调色板。每个调色板需要:

  • --bg: 主背景
  • --fg: 主文字
  • --accent: 主要强调色
  • --accent-2: 次要强调色(可选)
  • --muted: 柔和文字 / 边框
  • --surface: 卡片 / 区域背景

示例(终端暗夜):

:root {
  --bg: #0a0a0a;
  --fg: #e8e8e8;
  --accent: #00ff88;
  --accent-2: #0088ff;
  --muted: #333;
  --surface: #111;
}

示例(柔光工程):

:root {
  --bg: #f8f5f0;
  --fg: #1a1a1a;
  --accent: #c45d3e;
  --accent-2: #2d5a7b;
  --muted: #b8b0a4;
  --surface: #ffffff;
}

性能规则

GSAP 默认性能良好,但请遵循以下规则:

  • 在动画元素上使用 will-change: transform
  • 优先使用 transform 和 opacity,而不是布局属性(width, height, top, left)
  • 对许多相似元素使用 ScrollTrigger.batch(),而不是单独触发器
  • 对首屏以下图片添加 loading="lazy"
  • 保持页面总重量在 2MB 以下(不含视频)
  • 使用 gsap.matchMedia() 在移动设备上禁用重型动画:
gsap.matchMedia().add('(max-width: 768px)', () => {
  // 此处放置更简单的移动端动画
});

响应式设计

每个部分必须在移动设备上正常工作。关键规则:

  • 字体大小:使用 clamp() 实现流体缩放——例如 clamp(2rem, 5vw, 5rem)
  • 水平滚动区域应在移动设备上转换为垂直堆叠
  • 固定部分:通过 gsap.matchMedia() 减少固定持续时间或移除固定
  • 触摸目标:按钮/链接至少 44px
  • 在 375px、768px、1440px 断点处测试

可访问性

动画作品集仍需可访问:

  • 尊重 prefers-reduced-motion:
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (prefersReduced) {
  gsap.globalTimeline.timeScale(0); // 或完全跳过动画
}
  • 语义化 HTML:使用 <main>、<section>、<nav>、<header>、<footer>
  • 所有图片添加 Alt 文本
  • 交互元素可通过键盘导航
  • 足够的颜色对比度(正文文本至少 4.5:1)

构建步骤

  1. 从美学方向开始——与用户确认或根据其气质选择
  2. 构建具有语义化章节的 HTML 结构
  3. 使用 CSS 进行样式化(自定义属性、流体排版、grid/flexbox)
  4. 逐章节引入 GSAP 动画
  5. 添加 ScrollTrigger 实现滚动驱动的揭示
  6. 添加交互性(悬停状态、光标效果、微交互)
  7. 实现响应式
  8. 添加 prefers-reduced-motion 处理
  9. 优化(懒加载、will-change、移动端 matchMedia)

除非用户指定框架,否则始终输出一个内嵌 CSS 和 JS 的单一 HTML 文件。

相关技能