设计主题技能
1. 技能标识
- 名称: design-theme
- 目的: 定义个人开发者作品集的整体 UI/UX 及视觉设计标准。
- 目标受众: AI / 软件 / 产品开发者 作品集
- 首要目标: 传递的印象是,开发者不仅会罗列技术,更能发现实际问题并利用 AI 和软件来构建产品。
2. 核心设计理念
本作品集优先传达以下印象:
- 专业
- 现代
- 简约
- 技术性
- 以产品为导向
- 可读性强
- 可信赖
核心原则
"内容与项目应凌驾于装饰之上。"
用户在浏览首页时,应能迅速理解以下信息:
- 这是谁?
- 他/她做什么?
- 他/她解决什么问题?
- 他/她做过哪些项目?
- 使用什么技术?
- 是否具备实际开发能力?
3. 视觉方向
基本方向
- 优先采用浅色模式
- 基于干净的白色/浅灰色
- 有限使用蓝色强调色
- 细边框
- 充足的留白
- 强调排版
- 整齐的网格
- 最小化过度装饰
应避免的方向
通常不采用以下设计:
- 过度渐变
- 强烈辉光
- 玻璃态效果 (Glassmorphism)
- 过度 3D 效果
- 无意义的动画
- 过度阴影
- 彩虹色
- 过多的徽章 (Badge)
- 滥用装饰性插图
- AI 作品集常见的通用模板
- 为不同技术使用不同颜色的无差别技术徽章 (Tech Badge)
- 设计先于内容的布局
4. 色彩系统
基础色
Background #FAFAFA
Surface #FFFFFF
Foreground #18181B
Text Secondary #52525B
Text Weak #71717A
Placeholder #A1A1AA
Border #E4E4E7
Background Weak #F4F4F5
强调色
Accent #2563EB
Accent Hover #1D4ED8
Accent Soft #EFF6FF
在整体画面中有限使用强调色。
强调色使用位置
- 主要行动号召 (Primary CTA)
- 主要链接
- 活动导航 (Active Navigation)
- 焦点状态 (Focus)
- 重要信息
- 项目状态中需要强调的状态
避免将强调色用作整个画面的背景或装饰。
状态色
Success #16A34A
Warning #D97706
Error #DC2626
状态色仅用于表示实际状态。
5. 排版
字体优先级
优先考虑韩文可读性。
推荐顺序:
Pretendard
system-ui
sans-serif
代码、技术名称、数字、元信息可使用以下字体:
Geist Mono
monospace
字体层级
Hero
桌面端:
56px ~ 72px
font-weight: 700 ~ 800
line-height: 1.05 ~ 1.15
移动端:
40px ~ 48px
font-weight: 700 ~ 800
line-height: 1.1 ~ 1.2
H2
桌面端:
36px ~ 44px
移动端:
30px ~ 34px
H3
20px ~ 24px
正文
16px ~ 18px
line-height: 1.6 ~ 1.75
小号 / 元信息
13px ~ 14px
6. 布局系统
容器
默认最大宽度:
1200px
水平内边距
桌面端:
32px ~ 48px
平板端:
24px
移动端:
20px
区块间距
桌面端:
120px ~ 160px
移动端:
80px ~ 100px
不必强制整个页面使用相同的间距。
根据内容重要性调整间距。
7. 网格系统
项目区域默认使用以下结构。
桌面端
2 列
平板端
2 列
移动端
1 列
除非有特殊原因,否则不使用 3 列或以上的网格。
确保项目卡片内容充分可读,比网格数量更重要。
8. 页眉 (Header)
页眉以最小化的 UI 辅助作品集导航。
推荐结构:
Logo / Name
Projects
About / Approach
Contact
可选:添加 Resume 或 GitHub 链接。
页眉原则
- 避免过大页眉
- 不过度扩展导航
- 移动端必要时折叠为菜单
- 活动状态有限使用强调色
9. Hero 区域
Hero 是首页最重要的区域。
目标是立即传达开发者的身份,而非炫目。
推荐结构:
Eyebrow
↓
Main Heading
↓
Short Description
↓
Primary CTA / Secondary CTA
示例方向:
发现问题,
就亲手解决。
一位利用 AI 和软件解决实际问题
并将其转化为产品的开发者,尹正贤
注意,最终实际文案由单独的内容文件管理。
不要在 Hero 组件中硬编码内容。
10. 项目设计
项目是作品集的核心内容。
项目卡片不应仅仅是展示技术名称。
尽可能传达以下信息:
Project Name
Status
Short Summary
Problem
Solution
Technology
Period
不必强制将所有信息塞入一张卡片。
信息过多时,可引导至详情页。
11. 项目卡片
基本样式:
Background: #FFFFFF
Border: 1px solid #E4E4E7
Border Radius: 12px ~ 16px
Padding: 24px ~ 32px
Shadow: none 或非常轻微
悬停效果最小化。
推荐:
border-color 变化
background 变化
transform: 非常小的程度
避免使用过度的放大效果或辉光。
12. 项目状态
清晰表达项目状态。
示例:
Live
In Progress
Archived
表达状态时,不要仅用颜色传达含义。
同时使用文本或图标。
13. 技术标签
技术标签是辅助快速了解信息的元素。
不要为不同技术应用彩虹色。
默认使用中性样式。
示例:
Next.js
TypeScript
Python
FastAPI
Supabase
SQLite
AI Agent
技术标签不应比项目描述更引人注目。
14. 项目详情页
点击项目卡片后,可使用以下结构:
Project Header
↓
Overview
↓
Problem
↓
Approach
↓
Implementation
↓
Challenges
↓
Result
↓
What I Learned
↓
Technology
↓
Links
并非所有项目都需要包含所有部分。
仅显示实际项目中存在的真实信息。
15. 精选项目 (Featured Projects)
主页上不应以相同的比重展示所有项目。
根据 featured 状态选择主要项目。
示例:
featured: true
UI 基于 featured 值来显示项目。
因此,将某个项目从 Featured 中移除时,无需修改组件代码。
16. 更多项目 (More Projects)
在精选项目下方,可提供一个区域让访客浏览其他项目。
目的:
不是为了显得项目很多, 而是展示开发者解决过各种不同的问题。
保持精选项目与普通项目的视觉层级。
17. 方法部分 (Approach Section)
优先考虑展示开发方法,而非普通的“关于我 (About Me)”。
示例:
01 Problem
02 Discovery
03 Learning
04 Building
05 Result
核心信息如下:
发现问题 → 研究问题 → 学习所需技术 → 亲手构建 → 检验结果。
优先展示实际的开发过程和思维方式,而非简单的自我介绍。
18. 技能 (Skills)
技能部分并非罗列技术列表,而是展示实际使用场景。
推荐分类:
Frontend
Backend
AI / Automation
Database
Tools
示例:
Frontend
Next.js
React
TypeScript
Tailwind CSS
Backend
Python
FastAPI
Flask
AI / Automation
AI Agent
RAG
LLM API
Automation
Database
SQLite
PostgreSQL
Supabase
Tools
Git
GitHub
VS Code
注意,仅添加实际有使用经验的技术。
19. 技能表示 (Skill Representation)
不要用任意数字或星级表示技能熟练度。
禁止使用:
Python ★★★★★
React 90%
AI 95%
相反,应将技能与实际项目和用途联系起来。
示例:
Python
→ 用于 AI Agent / Automation / Backend 项目
20. 联系方式 (Contact)
联系方式区域应简洁明了。
推荐:
Short Message
Email
GitHub
LinkedIn 或其他实际链接
不要创建不存在的联系方式或链接。
21. 页脚 (Footer)
页脚保持最小化。
示例:
© 2026 尹正贤
Built with Next.js
不要添加多余信息。
22. 响应式设计
必须考虑以下环境:
Desktop
Tablet
Mobile
不要仅仅通过缩小屏幕来实现响应式。
特别是移动端,需应用:
- 导航结构变化
- Hero 排版调整
- 网格变为 1 列
- 按钮大小调整
- 内边距缩小
- 长文本换行检查
- 项目卡片信息优先级调整
23. 可访问性
必须考虑基本可访问性。
- 合适的标题层级
- 充足的颜色对比度
- 键盘焦点
- 清晰的按钮/链接
- 图片 Alt 文本
- 推荐 44px 及以上的触摸区域
- 不要仅靠颜色区分状态
- 确保无动画也能传达信息
24. 动画
动画仅在辅助功能时使用。
推荐:
150ms ~ 300ms
ease-out
可用区域:
- 按钮悬停
- 链接悬停
- 卡片悬停
- 导航
- 简短的区块展示
避免使用:
- 视差滚动 (Parallax)
- 过度的滚动动画
- 持续的运动
- 无意义的装饰性动画
- 进入页面时的过度演绎
25. 深色模式
当前第一版优先使用浅色模式。
深色模式仅在出现明确需求时添加。
不要因深色模式而使得当前设计系统或组件结构变得复杂。
26. 技术设计规则
使用 Tailwind CSS 作为基本样式系统。
CSS 变量用于管理全局设计令牌。
推荐:
Tailwind
+
CSS Variables
避免使用不必要的内联样式。
27. 组件规则
默认使用 React Server Component。
仅在以下情况使用 Client Component:
- 用户输入
- 状态管理
- 浏览器 API
- 基于事件的交互
- 需要客户端执行的动画库等
避免不必要地将整个页面设为 Client Component。
28. 内容/UI 分离
分离内容与 UI。
推荐结构:
content/
├─ profile.ts
├─ projects.ts
├─ skills.ts
└─ types.ts
不要在 UI 组件中直接编写项目信息。
添加或修改项目时,应尽可能只需修改:
content/projects.ts
即可反映到屏幕上。
29. 项目数据原则
项目数据应以结构化形式管理。
示例:
{
slug,
title,
summary,
problem,
solution,
tech,
status,
featured,
period,
image,
links,
highlights
}
仅使用必要的字段。
不要随意填充不存在的信息。
30. 图片规则
如果项目图片实际不存在,不要生成或引入任意图片。
如果需要占位符,请明确标记为占位符。
确保结构设计允许在获得实际项目截图后,替换为项目图片。
31. 数据完整性
这是作品集最重要的原则之一。
绝对不要随意创建以下内容:
- 不存在的项目
- 不存在的技术经验
- 不存在的成果
- 不存在的数字
- 不存在的客户
- 不存在的公司经历
- 不存在的链接
- 不存在的证书/资格
- 不存在的项目结果
信息不足时:
留空
或
向用户确认
为首要选择。
32. 现有项目保护
不要随意更改现有项目的含义。
基于用户提供的项目描述或需求进行工作。
如果需要删除或缩减现有功能,请先说明原因并请求确认。
33. 作品集信息架构
默认首页结构优先考虑以下顺序:
Header
↓
Hero
↓
Featured Projects
↓
More Projects
↓
Approach
↓
Skills
↓
Contact
↓
Footer
注意,可根据实际内容和可用性进行调整。
34. 设计决策优先级
当设计冲突发生时,遵循以下优先级:
1. 内容可读性
2. 信息层级
3. 可访问性
4. 响应式可用性
5. 一致性
6. 视觉美观度
7. 装饰效果
优先采用易于阅读和理解的设计,而非仅仅追求美观。
35. 实施工作流
创建新页面或 UI 时,遵循以下步骤。
第 1 步:分析
首先确认当前项目结构和现有 UI。
第 2 步:规划
提出所需的信息结构和屏幕组成。
第 3 步:设计
基于本 SKILL.md 的设计原则提出视觉方向。
第 4 步:组件
提出所需的组件结构。
第 5 步:确认
重大结构更改或新功能在实现前需获得用户确认。
第 6 步:实施
仅实施已确定的范围。
第 7 步:验证
检查以下内容:
TypeScript
Build
Responsive
Accessibility
Visual consistency
Existing functionality
36. 变更管理
小幅修改应尽可能保持现有结构。
进行重大更改前,遵循以下步骤:
- 检查当前结构
- 解释更改理由
- 确认影响范围
- 提出替代方案
- 获得用户批准
- 实施
37. 依赖项
仅在明确需要时才添加新库。
如果现有 Next.js / React / TypeScript / Tailwind 功能可以解决,则不要添加新库。
如需添加库,请先考虑:
为什么需要
它解决什么问题
是否有替代方法
38. Supabase / 后端原则
当前作品集第一版基于静态内容开始。
优先使用
content/*.ts
等后端(如 Supabase)仅在出现以下实际需求时添加:
- 管理页面
- 项目 CRUD
- 博客
- 开发记录
- 咨询存储
- 身份验证
- 动态数据管理
在不需要后端的阶段,不要先引入数据库。
39. Git 工作流
完成有意义的工作单元后提交。
基本流程:
git add .
git commit -m "工作内容"
git push
提交信息建议采用 Conventional Commit 格式。
示例:
feat: add portfolio homepage
feat: add project section
style: improve project cards
fix: resolve mobile layout
refactor: simplify project components
docs: update portfolio documentation
chore: update dependencies
避免将工作单元合并得过大。
40. 最终质量标准
完成的画面应能对以下问题回答“是”。
- 首页是否能立即识别出开发者的身份?
- 项目是否看起来是核心内容?
- 是否能理解每个项目解决了什么问题?
- 是否强调了实际结果和过程,而非技术列表?
- 在移动设备上是否易于阅读?
- 内容与 UI 是否分离?
- 是否易于添加新项目?
- 是否不包含不存在的虚假信息?
- 是否给人以专业印象,而非过度设计效果?
- 是否没有不必要地删除现有功能?
41. 不可协商的规则
以下原则始终保留:
- 装饰不凌驾于内容之上。
- 项目是作品集的核心。
- 不要编造非实际经历的内容。
- 不要随意添加用户未提供的成果或数字。
- 分离内容与 UI。
- 响应式设计是基础。
- 考虑可访问性。
- 不要添加不必要的库。
- 不要随意删除现有功能。
- 重大结构更改在实现前需与用户确认。
- 设计应保持专业 / 现代 / 简约 / 技术性方向。
- 第一版默认保持浅色模式。
- 添加项目时,设计应确保无需修改 UI 代码。
- 所有设计决策优先考虑可读性和信息传达。