Communitygithub.com

個人站從零生成 — 一句話 GSAP 作品集

一句話產出可部署個人作品集:純 HTML/CSS/JS + GSAP、零建置、5 主題、12 字體搭配、16 條去 AI 味規則、8+ 動效。打開 index.html 即用。

個人站從零生成 — 一句話 GSAP 作品集 是什麼?

個人站配方第 1 步(腳手架):Mort1d portfolio-genesis。一句話 → 完整純前端個人站。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

作品集生成器

一鍵生成作品集。產生完整、可部署的網站,具備專業的 GSAP 動畫、響應式設計,以及看起來像手工打造的獨特美學——絕非 AI 生成。使用者只需在瀏覽器中開啟 index.html,就能看到一個具備生產級品質的作品集。

理念

  • 每個作品集都在訴說一個故事。設計本身就是作品集中的第一個項目。
  • 反模板:生成的任何兩個網站看起來都不會一樣。主題由使用者的領域、個性和語氣驅動。
  • 「開啟 index.html,然後發出 WOW 的讚嘆」——零 npm、零建置步驟,即時獲得滿足感。
  • 限制 = 自由:純 vanilla HTML/CSS/JS + GSAP 迫使你創作出感覺像手工打造的創意 CSS。
  • 包含 3 個精心呈現的項目的作品集,勝過 20 個一般卡片。重質不重量。
  • 滾動體驗本身就是作品集。每一個滾動的像素都應該感覺是刻意的。

流程

步驟 1:資訊收集

從使用者提示中提取:

  • 身份:姓名、代號/別名、角色/職稱
  • 簡歷:1-3 句話(若未提供,則從上下文綜合)
  • 項目:標題、描述、標籤、連結、交易金額、角色
  • 社交連結:X、Discord、Telegram、GitHub、LinkedIn、電子郵件、YouTube(僅包含有提供的)
  • 頭像:檔案路徑或使用姓名縮寫生成 CSS 漸層圓形
  • 統計數據:經驗年資、項目數量、社群觸及率、已探索的工具
  • 語氣:專業 | 駭客 | 創意 | 優雅 | 俏皮 | 極簡 | 賽博

如果使用者提供的輸入極少,則生成具有上下文相關佔位符數據的內容,並標記注入點:<!-- CUSTOMIZE: 替換為你的 Twitter 帳號 -->。如果完全未提供 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 → 2 欄網格,尺寸相等
  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">
  • </body> 前的最後一個 <script src="js/main.js" defer>

css/style.css

所有樣式。CSS 自訂屬性放在 :root(至少 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) — 停用所有動畫,隱藏游標光暈
  • 每個裝飾性的 fixed/absolute 元素: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 個技能領域
英雄徽章@handle「@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 個精心策劃的配對中輪換。僅在使用者明確以此品牌形象時才使用。
4沒有 GSAP 備用方案的 opacity:0如果 GSAP CDN 失敗,整個網站都看不見。空白頁面。JS 第一行:檢查 typeof gsap,如果未定義則將所有 .reveal-up 設為可見。
5英雄區塊很棒,但摺疊線以下很普通「WOW」的感覺在滾動時消失。電影般的英雄區塊下方是千篇一律的卡片。每個區段都獲得同等的設計關注。滾動之旅本身就是作品集。
6社交連結使用 href="#"使網站明顯是假的。扼殺可信度。使用實際 URL。如果沒有提供,則完全省略該按鈕。
7到處使用相同的動畫時間所有東西都以相同的速度和相同的緩動函數移動,感覺很機械。變化持續時間(0.4s-1.2s)。每個元素使用不同的緩動函數。使用負偏移交錯。
8裝飾元素沒有 pointer-events: none球體、噪點、游標光暈會阻擋下方內容的滑鼠點擊。每個裝飾性的 fixed/absolute 元素都獲得 pointer-events: none。
9漸層文字搭配漸層背景無法閱讀。兩個競爭的漸層互相抵消。漸層文字僅用於純色/接近純色的深色背景。每個視覺區域一個漸層。
10卡片上缺少 cursor: pointer卡片看起來可互動,但游標保持預設。使用者會困惑。每個具有懸停狀態或點擊處理器的元素都加上 cursor: pointer。
11在使用者介面中使用表情符號圖示普遍的「AI 做的」信號。沒有設計用心。從 assets/social-icons.svg 使用內聯 SVG。導航、按鈕、標頭中不使用表情符號。
12width: 100vw在 Windows 上有捲軸時,會包含捲軸寬度 → 水平溢出。使用 width: 100% 或 body 上的 overflow-x: hidden。
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="[User's name]" — 簡單、描述性。
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 lerp。
  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 meta 標籤
  • 所有 CSS 自訂屬性都在 :root 中
  • 帶有 defer 的 GSAP CDN 連結
  • JS 在 body 底部使用 defer 連結

內容:

  • 已注入所有使用者數據(姓名、連結、項目、簡歷)
  • 沒有通用佔位符(「Lorem ipsum」、「Your Name Here」)
  • 社交連結使用實際 URL,針對已提供的連結沒有 href="#"
  • 頁尾有正確的姓名和動態年份

視覺:

  • 字體配對不是 Inter、Roboto、Arial 或 Space Grotesk(除非使用者指定)
  • 沒有紫色配白色的配色方案
  • 使用者介面中沒有表情符號圖示
  • 顏色對比符合 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"

相關技能