Communitygithub.com

wjdgus6480/portfolio

个人开发者作品集的整体 UI/UX 及视觉设计标准。

portfolio 是什么?

该技能定义了一套全面的设计主题标准,适用于个人开发者作品集(尤其是 AI、软件或产品开发者)。其核心理念是打造一个专业、现代、简洁且以内容为中心的作品集,重点突出开发者解决实际问题的能力,而非仅仅罗列技术栈。它从设计理念、视觉方向、色彩系统、排版、布局、网格等方面提供了详细且可操作的指导原则,并明确了需避免的设计元素(如过度渐变、玻璃态效果等)。该设计主题涵盖了响应式设计、可访问性、动画规范、内容与 UI 分离、数据完整性等关键方面,为开发者或 AI 代理(如 Claude Code、Cursor、Codex)提供了构建一致、高质量个人作品集网站的完整蓝图。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wjdgus6480/portfolio/tree/HEAD/claude/skills/design-theme

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

设计主题技能

1. 技能标识

  • 名称: design-theme
  • 目的: 定义个人开发者作品集的整体 UI/UX 及视觉设计标准。
  • 目标受众: AI / 软件 / 产品开发者 作品集
  • 首要目标: 传递的印象是,开发者不仅会罗列技术,更能发现实际问题并利用 AI 和软件来构建产品。

2. 核心设计理念

本作品集优先传达以下印象:

  • 专业
  • 现代
  • 简约
  • 技术性
  • 以产品为导向
  • 可读性强
  • 可信赖

核心原则

"内容与项目应凌驾于装饰之上。"

用户在浏览首页时,应能迅速理解以下信息:

  1. 这是谁?
  2. 他/她做什么?
  3. 他/她解决什么问题?
  4. 他/她做过哪些项目?
  5. 使用什么技术?
  6. 是否具备实际开发能力?

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. 变更管理

小幅修改应尽可能保持现有结构。

进行重大更改前,遵循以下步骤:

  1. 检查当前结构
  2. 解释更改理由
  3. 确认影响范围
  4. 提出替代方案
  5. 获得用户批准
  6. 实施

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. 不可协商的规则

以下原则始终保留:

  1. 装饰不凌驾于内容之上。
  2. 项目是作品集的核心。
  3. 不要编造非实际经历的内容。
  4. 不要随意添加用户未提供的成果或数字。
  5. 分离内容与 UI。
  6. 响应式设计是基础。
  7. 考虑可访问性。
  8. 不要添加不必要的库。
  9. 不要随意删除现有功能。
  10. 重大结构更改在实现前需与用户确认。
  11. 设计应保持专业 / 现代 / 简约 / 技术性方向。
  12. 第一版默认保持浅色模式。
  13. 添加项目时,设计应确保无需修改 UI 代码。
  14. 所有设计决策优先考虑可读性和信息传达。

相关技能