Communitygithub.com

TasmiaZerin1128/TasmiaZerin1128.github.io

為軟體工程師打造具有 GSAP 動畫效果的創意作品集網站與區塊。每當使用者要求建立作品集、個人網站、開發者登陸頁面、關於我、技能區塊、專案展示、英雄區塊或任何作品集相關的網頁元件時,請使用此技能——尤其是當他們希望作品集具有創意、動畫或視覺獨特性,同時保有開發者/工程師的身分時。當使用者提及 GSAP、ScrollTrigger、時間軸動畫、捲動驅動動畫,或想為網頁加入電影級動態效果時,也請觸發此技能。即使他們只說「讓我的作品集更酷」或「為我的網站加入動畫」,也請使用此技能。

TasmiaZerin1128.github.io 是什麼?

此技能是專為 AI 編碼代理(如 Cursor、Claude Code、Codex 等)設計的整合式指南,用於建立頂尖的軟體工程師作品集網站。它涵蓋了從概念到部署的完整流程,核心是基於 GSAP(GreenSock Animation Platform)的進階動畫整合。技能文件強調「有目的的戲劇性」哲學,將作品集視為引導訪客的敘事體驗,而非靜態頁面。 技能內容包含六種經挑選的 GSAP 動畫模式(如交錯顯示、文字分割、滾動驅動固定、視差圖層、磁吸游標效果與水平滾動區塊),每種模式都附有完整的程式碼範例。此外,它還提供了五種明確的美學方向(終端機黑、粗獷主義、軟性工程、霓虹建築、類比數位),以及詳細的區塊架構指南,涵蓋英雄區、關於我、技能區、專案展示與聯絡區。 除了動畫與美學,此技能也納入了實務考量,如字體排版規則(推薦的 Google Fonts 字型配對)、色彩系統(CSS 自訂屬性)、效能最佳化(will-change、transform 優先)、響應式設計(clamp() 字型尺寸、行動裝置適配)以及無障礙設計(尊重 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 放置的。動畫乾脆且機械——不使用 ease-out,改用 steps() 或 power4.inOut。想像:如果編譯器有品味。

3. 軟性工程

淺色背景搭配溫暖中性色、寬敞的留白、優雅的襯線字型搭配乾淨的無襯線字體。流暢的動畫。感覺高級且平靜。想像:如果 Dieter Rams 設計了一個作品集。

4. 霓虹建築

深色基底,鮮豔的霓虹強調色(洋紅、電光藍、萊姆綠),玻璃擬態效果,發光效果。動畫流暢,近乎液態。基於網格的佈局,帶有重疊元素。想像:銀翼殺手遇上瑞士設計。

5. 類比數位

紙張紋理,手繪元素結合銳利的數位字型,微妙的顆粒疊層。溫暖的色調。動畫模仿物理運動——物體像紙張一樣滑動,像卡片一樣堆疊。想像:一位也熱愛素描的開發者。

區塊架構

一個強大的作品集應遵循此結構。每個區塊應感覺像自己的「場景」:

英雄區

前 3 秒最重要。從文字動畫開始——訪客應看到你的名字活過來。在背景中加入微妙的環境動畫(浮動粒子、變形形狀、漸層動畫)。信息要極為簡潔:姓名 + 一行自我介紹。

關於我 / 哲學

不要只是列出事實。表達一種世界觀。使用滾動觸發的揭示效果,逐行顯示文字。照片可有可無,但如果包含,請使用創意處理(雙色調、clip-path 揭示、視差偏移)。

技能 / 技術棧

決不要使用無聊的標誌網格。可以嘗試:軌道可視化、滾動跑馬燈、響應懸停的互動標籤、星座圖、或「自我打字」的終端風格清單。

專案

核心重點。每個專案都需要展現空間。可以使用:水平滾動畫廊、全螢幕堆疊卡片(固定並切換)、或使用滾動觸發揭示的可展開卡片。每個專案應展示:標題、簡短描述、使用技術、以及視覺元素(螢幕截圖、影片或創意插圖)。

聯絡 / 頁尾

有目的地結束。一個大字型的 CTA,也許是基於時間的問候語(「晚安 — 我們聊聊」),以及乾淨的聯絡連結。保持簡潔有力。

如需每種區塊類型的詳細 HTML/CSS/JS 範本,請參閱 references/portfolio-sections.md。

字體排版規則

從 Google Fonts 匯入字型。除非使用者指定框架,否則一律不要使用系統字型或 Inter/Roboto。

適用於開發者作品集的良好字型配對:

  • 顯示字型 + 內文字型:「Clash Display」+「Satoshi」(透過 fontshare.com CDN)
  • 顯示字型 + 內文字型:「Syne」+「Work Sans」(Google Fonts)
  • 顯示字型 + 內文字型:「Space Grotesk」+「DM Sans」(Google Fonts)——僅在營造科技感時使用
  • 等寬字型 + 無襯線字型:「JetBrains Mono」+「General Sans」(fontshare)——適用於終端機美學
  • 襯線字型 + 無襯線字型:「Playfair Display」+「Source Sans 3」——適用於柔和/高級方向
  • 顯示字型 + 內文字型:「Anybody」+「Instrument Sans」(Google Fonts)
  • 顯示字型 + 內文字型:「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() 而非個別觸發器
  • 對摺疊以下(below the fold)的圖片加上 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 text)
  • 互動元素需可透過鍵盤導航
  • 足夠的色彩對比(內文至少 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 檔案。

相關技能