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)用于滚动动画
- 所有内容都作为单个
CONFIG对象存放在js/config.js中。 - 网站必须通过双击
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。 - 区域标题(
关于我、软件技能等):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. 顶部导航(固定 / 按部分)
- 左侧:链接
首页 · 关于我 · 简历 · 作品集(font-weight:500,白色)。当前激活的链接 =--accent。平滑滚动至对应部分。 - 右侧:电话图标(
fa-phone)+ 配置中的电话号码,白色,~13px。 - 在英雄区上方背景透明;在其他部分上方显示为微妙的深色条。
- 在 768px 宽度以下折叠为汉堡菜单。
2. 首页 / 英雄区
- 全屏背景图片(
config.hero.background),上方叠加--overlay渐变以确保内容可读性(内容靠左显示)。 - 左对齐的内容块,垂直居中:
- 姓名(上述两种字重处理)。
- 职位(字母间距大写的文字)。
- 两个轮廓药丸按钮:
简历和作品集(1px 白色边框,透明填充,全圆角,悬停时 → 填充--accent,边框--accent)。每个按钮滚动到对应的部分。
- 左下角:社交图标行(Behance、Facebook、LinkedIn、Instagram、Pinterest、Twitter/X、WhatsApp),来自
config.social— 仅渲染包含 URL 的项目。白色图标,悬停 →--accent。 - 右下角:展开图标。
3. 关于我
- 两栏分栏:左侧文本,右侧大型灰度肖像(
config.about.photo,应用filter:grayscale(100%),通过蒙版/渐变在其左侧边缘融入黑色背景)。 - 左栏:
关于我标题 + 青色下划线。- 电子邮件行(
config.contact.email),--text-muted。 - 个人简介段落(
config.about.bio),--text-secondary。 - 底部:位置 — 城市行 + 街道行,居中,两侧由短破折号/线条框住(
— 佛罗里达,奥兰多 —样式),使用config.contact.location。
4. 简历(三栏)
桌面端显示三个等宽的列;移动端堆叠为单列。
列 A — 技能与语言
软件技能:对于config.skills.software中的每个项目,渲染一行:方角圆角图标徽章(1px 边框,工具的缩写字母或 Font Awesome 品牌图标)+ 标签 + 一个水平进度条,其中包含填充部分和一个位于level%(0–100)位置的青色标记圆点。轨道 =--line,填充 + 圆点 =--accent。语言:标签 + 相同的进度条处理(config.skills.languages)。个人技能:一行由逗号/破折号连接的关键词(config.skills.personal),--text-secondary。
列 B — 经历与教育
经历:一个垂直时间线。每个条目 = 一个圆形年份徽章(config.experience[].years,例如2017 till present,强调色填充,小的白色文字),由一条垂直线连接,旁边是公司名称(加粗,大写) + 下方的职位(--text-muted)。遍历config.experience。教育背景:学位(加粗)+ 下方的学校(config.education)。
列 C — 服务、设计技能、爱好
我能做什么?:由破折号连接的多行服务项目(config.services)。设计技能:由破折号连接的多行优势(config.designSkills)。爱好与兴趣:一个两列的圆形轮廓图标网格(1px 边框的圆圈,内含 Font Awesome 图标)+ 每个图标下方的说明文字(config.hobbies,例如阅读、摄影、绘画、旅行)。
5. 作品集
- 一个响应式网格画廊(CSS 网格,桌面端 ~3 列 / 平板 2 列 / 移动 1 列,
gap:16px),由config.portfolio[]构建(每个项目包含:图片路径、可选标题、可选链接)。 - 每个图块:图片居中裁剪并覆盖,悬停时显示深色覆盖层,揭示白色标题和一条青色强调线。悬停时轻微的放大效果。
- 如果
config.portfolio为空,则优雅地隐藏该部分。
config.js 结构(Claude Code:从 README 和图片中填充此项)
const CONFIG = {
identity: {
firstName: "",
lastName: "",
title: "", // 例如 "全栈开发者"
},
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: [ // 等级:0–100
{ name: "", icon: "Ps", level: 90 },
],
languages: [
{ name: "", level: 90 },
],
personal: "", // "创造力 - 团队合作 - 组织能力"
},
experience: [
{ years: "", company: "", role: "" },
],
education: [
{ degree: "", school: "" },
],
services: [], // "Logo - 文具 - 品牌设计"
designSkills: [], // "创造力 - 规划与策略"
hobbies: [
{ name: "", icon: "fa-book" }, // Font Awesome 图标名称
],
portfolio: [
{ image: "assets/img/portfolio/p1.jpg", title: "", link: "" },
],
};
动画(GSAP + ScrollTrigger)
- 英雄区:加载时姓名 + 按钮淡入/向上滑动(错开出现)。
- 区域标题 + 下划线:滚动进入视口时显现。
- 简历进度条:当列进入视口时,填充和圆点从 0 动画到
level%。 - 时间线条目:滚动时错开淡入。
- 作品集图块:微妙的错开向上淡入。
- 保持品味 — 持续时间短(0.4–0.8s),
power2.out缓动。尊重prefers-reduced-motion(禁用动画,显示最终状态)。
响应式
- ≥ 992px:完整布局(三栏简历,分栏关于我)。
- 768–991px:简历 → 两栏,关于我照片缩小。
- < 768px:所有内容堆叠为单栏,导航变为汉堡菜单,英雄区文本缩放,固定背景变为滚动(
background-attachment:scroll)以避免移动端错误。
完成标准
-
index.html通过双击即可正确打开(无需服务器)。 - 所有四个导航链接平滑滚动至对应部分;滚动时当前激活的链接高亮。
- 每个文本/图片/技能值都来自
config.js(HTML 中无硬编码内容)。 -
config.js已从项目的README.md填充,缺失部分使用""占位符(无虚构数据)。 - 肖像、英雄区和作品集图片已从项目图片文件中关联。
- 深色主题 + 单一青色强调色与参考匹配;已加载 Montserrat 字体。
- 完全响应式,兼容至约 360px 宽的屏幕。
- 存在 GSAP 动画,并尊重
prefers-reduced-motion。