SKILL.md — 個人作品集與履歷網站
目標
為創意專業人士建立一個單頁、深色主題的個人作品集 / 線上履歷,符合參考設計:一個電影級首頁、一個「關於我」左右分割區塊、一個三欄式的「履歷」區塊,以及一個「作品集」畫廊。風格沉穩、高端、高對比,僅使用單一的青色強調色。
網站100% 以數據驅動:每一段文字、每一項技能等級、每一個圖片路徑都存放在 js/config.js 中。編輯內容時絕不需要觸碰 HTML 或 CSS。
技術棧(硬性規定)
- 僅使用純 HTML5 + CSS3 + JavaScript。 不能使用 npm、打包工具、框架或建置步驟。
- 僅透過 CDN 使用任何外部函式庫。允許的項目:
- Google Fonts → Montserrat(字重 300, 400, 500, 600, 700, 800, 900)
- Font Awesome 6(免費 CDN)用於所有圖示(導航、社群、軟體徽章、興趣)
- GSAP 3 + ScrollTrigger(CDN)用於滾動動畫
- 所有內容都存放在
js/config.js中的單一CONFIG物件內。 - 網站必須能透過雙擊
index.html直接開啟(無需伺服器),並且在 cPanel 上作為附加域名託管時也能正常運作。
內容來源(請先閱讀這些)
在產生任何內容之前,Claude Code 必須:
-
閱讀專案根目錄下的
README.md。 其中包含擁有者的真實個人資訊:全名、職稱、標語、自傳、電子郵件、電話、地址/城市、社群連結、軟體技能與等級、語言與等級、個人特質、工作經歷(年份區間 + 公司 + 職位)、學歷、「我能做什麼」服務項目、設計技能與興趣。完全根據此 README 填入js/config.js。 如果 README 中缺少某個欄位,請在config.js中留下清楚標記的""預留位置(切勿憑空捏造資料)。 -
掃描專案中的圖片(根目錄及/或
assets/img/):- 個人肖像照 → 用於關於我區塊,並作為首頁姓名區塊的背景參考。
- 首頁/桌面背景圖 → 用作首頁背景。
- 其餘所有專案圖片 → 用作作品集網格。
將存在的檔案名稱對應至
config.js中。不要在 HTML 中硬編碼路徑。
檔案結構
portfolio/
├── README.md # 擁有者資訊(內容來源)— 由使用者提供
├── SKILL.md # 本檔案
├── index.html
├── css/
│ └── style.css
├── js/
│ ├── config.js # 所有可編輯的內容存放於此
│ └── main.js # 導航、平滑滾動、GSAP 動畫、進度條填充
└── assets/
└── img/
├── profile.jpg # 肖像照(關於我)
├── hero-bg.jpg # 首頁背景
└── portfolio/ # 專案圖片(作品集)
設計系統
顏色(CSS 變數,定義於 :root)
--bg-hero: #0A0A0C; /* 近黑色,首頁照片後的基底 */
--bg-about: #0B0B0E; /* 關於我區塊,近乎純黑 */
--bg-resume: #11141F; /* 履歷區塊,深海軍藍-炭灰色 */
--bg-resume-grad: linear-gradient(160deg, #141826 0%, #0E111B 100%);
--accent: #2EA9E0; /* 單一的青藍色強調色 */
--accent-soft: rgba(46,169,224,0.18);
--text-primary: #FFFFFF; /* 標題、姓名 */
--text-secondary: #C2C6CE; /* 內文 */
--text-muted: #8A8F99; /* 子標籤、說明文字 */
--line: rgba(255,255,255,0.12); /* 進度軌道、分隔線 */
--overlay: linear-gradient(90deg, rgba(0,0,0,0.85) 0%, rgba(0,0,0,0.35) 60%, rgba(0,0,0,0.7) 100%);
強調色僅用於:啟用中的導航連結、標題底線、時間軸圓點、進度條填充與標記圓點,以及連結懸停效果。請節制使用。
字體排印
- 字體家族:全站使用 Montserrat。
- 姓名(首頁):兩行 — 名字
font-weight:300+ 大寫,姓氏font-weight:900大寫,尺寸約clamp(48px, 7vw, 84px),行高緊湊。 - 姓名下方的職稱:
font-weight:400,大寫,letter-spacing:0.45em,使用--text-muted,約 14px。 - 區塊標題(如
ABOUT、SOFTWARE SKILLS等):font-weight:800,大寫,約 18–26px,白色,並帶有一條短的青色底線(寬約 48px,高 3px,強調色,緊貼文字下方)。 - 內文:
font-weight:400,15px,使用--text-secondary,行高 1.7。
間距與版面
- 每個主要區塊(首頁、關於我、履歷)在桌面上皆為全視窗高度(
min-height:100vh),垂直堆疊,可選用滾動吸附。 - 內容最大寬度約 1240px,水平居中,兩側有充裕的內邊距(clamp 24px–80px)。
- 每個區塊的右下角放置一個小的全螢幕/展開圖示(裝飾用;
fa-expand),符合參考設計。
區塊
1. 頂部導航(固定/隨區塊變換)
- 左側:連結
Home · About · Resume · Portfolio(font-weight:500,白色)。啟用中的連結使用--accent。平滑滾動至對應區塊。 - 右側:電話圖示(
fa-phone)+ 來自設定的電話號碼,白色,約 13px。 - 在首頁上方為透明背景;在其他區塊上方為微弱的深色橫條。
- 在 768px 以下收合為漢堡選單。
2. 首頁 / 英雄區
- 全螢幕背景圖片(
config.hero.background),上方疊加--overlay漸層以確保文字可讀性(內容靠左對齊)。 - 靠左對齊的內容區塊,垂直置中:
- 姓名(採用上述的雙字重處理方式)。
- 職稱(字母間距大寫)。
- 兩個外框膠囊按鈕:
Resume與Portfolio(1px 白色邊框,透明填滿,全圓角,懸停時 → 填滿--accent,邊框--accent)。各按鈕滾動至對應區塊。
- 左下角:社群圖示列(Behance、Facebook、LinkedIn、Instagram、Pinterest、Twitter/X、WhatsApp)來自
config.social— 僅渲染有 URL 的圖示。白色圖示,懸停 →--accent。 - 右下角:展開圖示。
3. 關於我
- 兩欄分割:左側文字,右側大尺寸灰階肖像照(
config.about.photo,套用filter:grayscale(100%),透過遮罩/漸層使其左緣融入黑色背景)。 - 左欄:
ABOUT標題 + 青色底線。- 電子郵件行(
config.contact.email),使用--text-muted。 - 自傳段落(
config.about.bio),使用--text-secondary。 - 底部:地點 — 城市行 + 街道行,居中對齊,兩側由短破折號/線條框住(例如「— Florida, Orlando —」樣式),使用
config.contact.location。
4. 履歷(3 欄)
桌面上三個等寬欄位;在行動裝置上堆疊為一欄。
欄位 A — 技能與語言
SOFTWARE SKILLS:config.skills.software中的每一項,渲染一行包含:方形圓角圖示徽章(1px 邊框,顯示工具縮寫或 Font Awesome 品牌圖示)+ 標籤 + 一條水平進度軌道,其中包含填充部分與一個青色標記圓點,位置在level%(0–100)。軌道 =--line,填充與圓點 =--accent。LANGUAGES:標籤 + 同樣的進度軌道處理方式(config.skills.languages)。PERSONAL SKILLS:一行以逗號/破折號連接的關鍵字(config.skills.personal),使用--text-secondary。
欄位 B — 經歷與學歷
EXPERIENCE:一條垂直時間軸。每個項目 = 一個圓形的年份徽章(config.experience[].years,例如「2017 till present」,強調色填滿,白色小字),由一條垂直線連接,旁邊顯示公司名稱(粗體,大寫) + 下方的職位(--text-muted)。遍歷config.experience。EDUCATION:學位(粗體)+ 下方的學校(config.education)。
欄位 C — 服務、設計技能、興趣
WHAT CAN I DO ?:以破折號連接的服務項目行(config.services)。DESIGN SKILLS:以破折號連接的優勢項目行(config.designSkills)。HOBBIES & INTERESTS:一個兩欄網格,包含圓形外框圖示(1px 邊框圓形,內部為 Font Awesome 圖示)+ 每個圖示下方的說明文字(config.hobbies,例如閱讀、攝影、繪畫、旅行)。
5. 作品集
- 一個響應式網格畫廊(CSS 網格,桌面約 3 欄 / 平板 2 欄 / 行動裝置 1 欄,
gap:16px),由config.portfolio[]建立(每個項目包含:圖片路徑、可選標題、可選連結)。 - 每個磁貼:圖片以 cover-fit 顯示,懸停時顯示深色疊加層,揭露白色標題與一條青色強調線。懸停時有微幅放大效果。
- 如果
config.portfolio為空,則優雅地隱藏該區塊。
config.js 結構(Claude Code:根據 README 與圖片填寫此物件)
const CONFIG = {
identity: {
firstName: "",
lastName: "",
title: "", // 例如 "Full Stack Developer"
},
contact: {
phone: "",
email: "",
location: { city: "", street: "" },
},
social: { // 留空 / 設為 "" 可隱藏圖示
behance: "", facebook: "", linkedin: "", instagram: "",
pinterest: "", twitter: "", whatsapp: "",
},
hero: { background: "assets/img/hero-bg.jpg" },
about: {
photo: "assets/img/profile.jpg",
bio: "",
},
skills: {
software: [ // level: 0–100
{ name: "", icon: "Ps", level: 90 },
],
languages: [
{ name: "", level: 90 },
],
personal: "", // "Creativity - Team Work - Organisation"
},
experience: [
{ years: "", company: "", role: "" },
],
education: [
{ degree: "", school: "" },
],
services: [], // "Logo - Stationery - Branding"
designSkills: [], // "Creativity - Planning & Strategy"
hobbies: [
{ name: "", icon: "fa-book" }, // Font Awesome 圖示名稱
],
portfolio: [
{ image: "assets/img/portfolio/p1.jpg", title: "", link: "" },
],
};
動畫(GSAP + ScrollTrigger)
- 首頁:姓名與按鈕在載入時淡入/滑入(交錯)。
- 區塊標題與底線:在滾動進入視野時顯示。
- 履歷進度條:在欄位進入視口時,將填充與圓點從 0 動畫至
level%。 - 時間軸項目:在滾動時交錯淡入。
- 作品集磁貼:微幅交錯淡入上移。
- 保持品味 — 短持續時間(0.4–0.8 秒),使用
power2.out緩動。尊重prefers-reduced-motion(停用動畫,顯示最終狀態)。
響應式設計
- ≥ 992px:完整版面(3 欄履歷,左右分割的關於我)。
- 768–991px:履歷 → 2 欄,關於我照片縮小。
- < 768px:所有內容堆疊為 1 欄,導航變成漢堡選單,首頁文字縮小,固定背景改為滾動(
background-attachment:scroll)以避免行動裝置上的瀏覽器錯誤。
完成定義
-
index.html可透過雙擊正確開啟(無需伺服器)。 - 所有四個導航連結均可平滑滾動至對應區塊;啟用中的連結會在滾動時高亮。
- 每個文字/圖片/技能值都來自
config.js(HTML 中零硬編碼內容)。 -
config.js已根據專案的README.md填入,缺少的項目以""預留位置標示(無憑空捏造的資料)。 - 肖像照、首頁背景與作品集圖片已從專案的圖片檔案中連結。
- 深色主題與單一青色強調色符合參考設計;Montserrat 字體已載入。
- 完全響應式,向下相容至約 360px 寬。
- GSAP 動畫已存在,且尊重
prefers-reduced-motion。