Communitygithub.com

wjdgus6480/portfolio

定義個人開發者作品集的整體 UI/UX 及視覺設計標準。

portfolio 是什麼?

此技能定義了個人開發者作品集(Portfolio)完整的設計主題與風格指南,特別針對 AI、軟體及產品開發者角色打造。它強調「內容優先於裝飾」,致力於呈現「發現問題並透過 AI 與軟體解決問題」的開發者形象,而非單純的技術陳列。技能涵蓋色彩系統、排版比例、佈局網格、元件規則(React Server Component 優先)、內容與 UI 分離原則、資料完整性(嚴禁虛構資訊)以及可及性與響應式設計等。支援的平台主要是基於 Next.js、React、TypeScript 與 Tailwind CSS 的靜態網站生成,並建議將專案資料以結構化檔案(如 content/projects.ts)管理,以便輕鬆新增或修改。整個設計哲學以專業、現代、簡約、技術感及可讀性為核心,並規範了 Header、Hero、專案卡片、技術標籤、聯絡區塊等元件的具體樣式與行為規則,確保最終產出兼顧視覺一致性與開發效率。

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

在你喜歡的 AI 中提問

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

說明文件

設計主題技能 (Design Theme Skill)

1. 技能識別 (Skill Identity)

  • 名稱: design-theme
  • 目的: 定義個人開發者作品集的整體 UI/UX 及視覺設計標準。
  • 目標對象: AI / 軟體 / 產品開發者作品集
  • 主要目標: 傳達的印象不是「列出技術的作品集」,而是「發現實際問題,並運用 AI 與軟體來打造產品的開發者」。

2. 核心設計哲學 (Core Design Philosophy)

本作品集優先傳達以下印象:

  • Professional
  • Modern
  • Minimal
  • Technical
  • Product-oriented
  • Readable
  • Trustworthy

核心原則

「內容與專案應是主角,而非裝飾。」

當使用者看到首頁時,應能快速理解以下幾點:

  1. 這個人是誰?
  2. 這個人做了什麼?
  3. 這個人解決了什麼問題?
  4. 這個人建立了哪些專案?
  5. 這個人使用了哪些技術?
  6. 這個人是真的能開發的人嗎?

3. 視覺方向 (Visual Direction)

基本方向

  • 以 Light Mode 為優先
  • 基於乾淨的白色/淺灰色
  • 限制使用 Blue Accent
  • 使用細邊框
  • 充足的留白
  • 強而有力的排版
  • 整齊的網格
  • 最小化過度的裝飾

應避免的方向

基本上不使用以下設計:

  • 過度的漸層
  • 強烈的發光效果
  • Glassmorphism 風格
  • 過度的 3D 效果
  • 無意義的動畫
  • 過度的陰影
  • 彩虹色調
  • 過多的標籤
  • 濫用裝飾性插圖
  • AI 作品集中常見的通用模板
  • 為每個技術使用不同顏色的浮濫技術標籤
  • 讓設計先於內容被看見的佈局

4. 色彩系統 (Color System)

基礎色

背景色     #FAFAFA
表面色     #FFFFFF
前景色     #18181B
次要文字   #52525B
弱勢文字   #71717A
佔位文字   #A1A1AA
邊框       #E4E4E7
弱勢背景   #F4F4F5

強調色

強調色      #2563EB
強調懸浮色  #1D4ED8
強調柔和色  #EFF6FF

強調色應在整個畫面中有限度地使用。

強調色的使用位置

  • 主要行動呼籲按鈕 (Primary CTA)
  • 主要連結
  • 啟用中的導航項目
  • Focus 狀態
  • 重要資訊
  • 專案狀態中需要強調的狀態

請勿將強調色過度用於畫面背景或裝飾。

狀態色

成功 #16A34A
警告 #D97706
錯誤 #DC2626

狀態色僅在表達實際狀態時使用。


5. 排版 (Typography)

字型優先順序

優先考慮韓文可讀性。

建議順序:

Pretendard
system-ui
sans-serif

程式碼、技術名稱、數字、元資訊可以使用以下字型:

Geist Mono
monospace

字級比例

Hero 區塊

桌面版:

56px ~ 72px
字重: 700 ~ 800
行高: 1.05 ~ 1.15

行動版:

40px ~ 48px
字重: 700 ~ 800
行高: 1.1 ~ 1.2

H2

桌面版:

36px ~ 44px

行動版:

30px ~ 34px

H3

20px ~ 24px

內文

16px ~ 18px
行高: 1.6 ~ 1.75

小型 / 元資訊

13px ~ 14px

6. 佈局系統 (Layout System)

容器

預設最大寬度:

1200px

水平內距

桌面版:

32px ~ 48px

平板:

24px

行動版:

20px

區塊間距

桌面版:

120px ~ 160px

行動版:

80px ~ 100px

不要強制對整個頁面套用相同的間距。

請根據內容重要性調整間距。


7. 網格系統 (Grid System)

專案區域預設使用以下結構:

桌面版

2 欄

平板

2 欄

行動版

1 欄

除非有特殊理由,否則不使用 3 欄以上的網格。

讓專案卡片的內容能被充分閱讀,比網格欄數更重要。


8. 頁首 (Header)

Header 是由協助瀏覽作品集的最小化 UI 構成。

建議結構:

Logo / 姓名
Projects
About / Approach
Contact

如有需要,可加入 Resume 或 GitHub 連結。

Header 原則

  • 避免過大的 Header
  • 不要過度增加導航項目
  • 行動版視情況收合為選單
  • 啟用狀態應有限度地使用強調色

9. Hero 區塊

Hero 是首頁最重要的區域。

目標不是看起來華麗,而是立即傳達開發者的身份認同。

建議結構:

上標題
↓
主標題
↓
簡短描述
↓
主要 CTA / 次要 CTA

示範方向:

發現問題,
就自己動手做。

運用 AI 與軟體解決實際問題
並打造產品的開發者,尹正賢

但實際最終文案應由獨立的內容檔案管理。

請勿將內容硬編碼在 Hero 元件中。


10. 專案設計 (Project Design)

專案是作品集的核心內容。

Project Card 不該只是顯示技術名稱的卡片。

如果可能,請傳達以下資訊:

專案名稱
狀態
簡短摘要
問題
解決方案
技術
期間

請勿強迫在一張卡片中放入所有資訊。

如果資訊量較多,可引導至詳細頁面。


11. 專案卡片 (Project Card)

基本樣式:

背景色: #FFFFFF
邊框: 1px solid #E4E4E7
圓角: 12px ~ 16px
內距: 24px ~ 32px
陰影: 無 或 非常輕微

將懸浮效果最小化。

建議:

border-color 變化
background 變化
transform: 非常輕微的程度

請勿使用過度的放大效果或發光效果。


12. 專案狀態 (Project Status)

清楚表達專案狀態。

例如:

已上線
進行中
已歸檔

不要僅依賴顏色來傳達狀態的意義。

請同時使用文字或圖示。


13. 技術標籤 (Technology Tags)

技術標籤是輔助快速了解資訊的元素。

不要為每個技術套用彩虹色。

預設使用中性 (Neutral) 風格。

例如:

Next.js
TypeScript
Python
FastAPI
Supabase
SQLite
AI Agent

技術標籤不應比專案描述更醒目。


14. 專案詳細頁面 (Project Detail Page)

點擊 Project Card 時可使用以下結構:

專案頁首
↓
概覽
↓
問題
↓
方法
↓
實作
↓
挑戰
↓
結果
↓
學到什麼
↓
技術
↓
連結

並非所有專案都需要包含所有區塊。

僅顯示該專案實際存在的資訊。


15. 精選專案 (Featured Projects)

在首頁,不要以相同比重顯示所有專案。

根據 featured 狀態來選定主要專案。

例如:

featured: true

UI 應根據 featured 值來顯示專案。

因此,不應為了將專案從精選區移除而修改元件程式碼。


16. 更多專案 (More Projects)

在精選專案下方,可以提供一個區域讓使用者查看其他專案。

目的:

不是為了讓專案看起來不少, 而是為了展示開發者解決過哪些多樣化的問題。

保持精選專案與一般專案之間的視覺階層。


17. 開發方法區塊 (Approach Section)

優先考慮展示開發方式,而非一般的「關於我」區域。

例如:

01 發現問題
02 調查研究
03 學習新知
04 動手建置
05 檢視結果

核心訊息如下:

發現問題 → 進行調查 → 學習必要技術 → 親手打造 → 確認結果。

與其單純自我介紹,優先展示實際開發過程與思維方式。


18. 技能 (Skills)

Skills 區塊不應只是列出技術清單,而是展示實際使用的脈絡。

建議分類:

前端
後端
AI / 自動化
資料庫
工具

例如:

前端
Next.js
React
TypeScript
Tailwind CSS

後端
Python
FastAPI
Flask

AI / 自動化
AI Agent
RAG
LLM API
自動化

資料庫
SQLite
PostgreSQL
Supabase

工具
Git
GitHub
VS Code

但是,請勿加入沒有實際使用經驗的技術。


19. 技能呈現 (Skill Representation)

不要使用隨意的數字或星級來表達技術熟練度。

禁止使用:

Python ★★★★★
React 90%
AI 95%

取而代之的是,將技術與實際專案及使用目的連結。

例如:

Python
→ 用於 AI Agent / 自動化 / 後端專案

20. 聯絡資訊 (Contact)

聯絡資訊區域應簡潔明瞭。

建議:

簡短訊息
電子郵件
GitHub
LinkedIn 或其他實際連結

請勿產生實際上不存在的聯絡資訊或連結。


21. 頁尾 (Footer)

Footer 應保持最小化。

例如:

© 2026 尹正賢
Built with Next.js

不要放入超過需求的資訊。


22. 響應式設計 (Responsive Design)

務必考慮以下環境:

桌面版
平板
行動版

不要以單純縮小畫面的方式實現響應式。

特別在行動版上,應套用以下調整:

  • 導航結構變更
  • Hero 排版調整
  • 網格 → 1 欄
  • 按鈕尺寸調整
  • 內距縮小
  • 確認長文字的換行
  • 調整專案卡片的資訊優先順序

23. 可及性 (Accessibility)

務必考慮基本的可及性。

  • 適當的標題階層
  • 充足的色彩對比
  • 鍵盤焦點 (Keyboard Focus)
  • 明確的按鈕/連結
  • 圖片替代文字 (Alt Text)
  • 建議觸控區域大於 44px
  • 不要僅用顏色區分狀態
  • 確保即使沒有動畫也能傳達資訊

24. 動畫 (Animation)

動畫僅在輔助功能時使用。

建議:

150ms ~ 300ms
ease-out

可使用的區域:

  • 按鈕懸浮
  • 連結懸浮
  • 卡片懸浮
  • 導航
  • 簡短的區塊顯現

不使用以下項目:

  • Parallax 效果
  • 過度的滾動動畫
  • 持續的移動
  • 無意義的裝飾動畫
  • 頁面進入時過度的特效

25. 深色模式 (Dark Mode)

目前第一個版本以 Light Mode 為優先。

Dark Mode 將在有額外需求時再加入。

不要因為 Dark Mode 而使目前的設計系統或元件結構變得複雜。


26. 技術設計規則 (Technical Design Rules)

使用 Tailwind CSS 作為預設樣式系統。

CSS Variables 用於管理全域設計 Token。

建議:

Tailwind
+
CSS Variables

請勿使用不必要的內聯樣式。


27. 元件規則 (Component Rules)

預設使用 React Server Component。

僅在以下情況使用 Client Component:

  • 使用者輸入
  • 狀態管理
  • 瀏覽器 API
  • 基於事件的互動
  • 動畫函式庫等需要在用戶端執行的情況

不要不必要的將整個頁面做成 Client Component。


28. 內容 / UI 分離 (Content / UI Separation)

分離內容與 UI。

建議結構:

content/
├─ profile.ts
├─ projects.ts
├─ skills.ts
└─ types.ts

請勿在 UI 元件中直接撰寫專案資訊。

新增或修改專案時,盡可能只修改:

content/projects.ts

即可反映在畫面上。


29. 專案資料原則 (Project Data Principle)

Project 資料應以結構化的形式管理。

例如:

{
  slug,
  title,
  summary,
  problem,
  solution,
  tech,
  status,
  featured,
  period,
  image,
  links,
  highlights
}

僅使用需要的欄位。

請勿隨意填入實際上不存在的資訊。


30. 圖片規則 (Image Rules)

如果專案圖片實際不存在,請勿自行產生或擷取任意圖片。

如果需要佔位符,請明確標示其為佔位符。

確保在取得實際專案螢幕截圖後,能夠替換為專案圖片。


31. 資料完整性 (Data Integrity)

這是作品集最重要的原則之一。

絕對不要任意產生以下內容:

  • 不存在的專案
  • 不存在的技術經驗
  • 不存在的成就
  • 不存在的數據
  • 不存在的客戶
  • 不存在的公司經歷
  • 不存在的連結
  • 不存在的認證/資格
  • 不存在的專案結果

如果資訊不足:

留空

或

向使用者確認

為優先處理方式。


32. 既有專案保存 (Existing Project Preservation)

請勿任意變更既有專案的意義。

請基於使用者提供的專案描述或需求進行作業。

如果需要刪除或縮減既有功能,應先說明理由並請求確認。


33. 作品集資訊架構 (Portfolio Information Architecture)

基本首頁結構優先考慮以下順序:

Header
↓
Hero
↓
精選專案
↓
更多專案
↓
開發方法
↓
技能
↓
聯絡資訊
↓
Footer

但可根據實際內容與可用性進行調整。


34. 設計決策優先順序 (Design Decision Priority)

當設計發生衝突時,請遵循以下優先順序:

1. 內容可讀性
2. 資訊階層
3. 可及性
4. 響應式可用性
5. 一致性
6. 視覺美感
7. 裝飾效果

優先選擇易於閱讀和理解的設計,而非漂亮的設計。


35. 實作流程 (Implementation Workflow)

建立新頁面或 UI 時,請遵循以下順序:

步驟 1. 分析

先確認目前的專案結構與既有 UI。

步驟 2. 規劃

提出所需的資訊結構與畫面構成。

步驟 3. 設計

基於此 SKILL.md 的設計原則,提出視覺方向。

步驟 4. 元件

提出所需的元件結構。

步驟 5. 確認

在實作大型結構變更或新功能前,先取得使用者確認。

步驟 6. 實作

僅實作已確認的範圍。

步驟 7. 驗證

確認以下項目:

TypeScript
建置
響應式
可及性
視覺一致性
既有功能

36. 變更管理 (Change Management)

小幅修改應盡可能維持既有結構。

在進行大型變更前,遵循以下順序:

  1. 確認目前結構
  2. 說明變更理由
  3. 確認影響範圍
  4. 提出替代方案
  5. 取得使用者核准
  6. 實作

37. 相依套件 (Dependencies)

僅在需求明確時才加入新的函式庫。

如果能夠透過既有的 Next.js / React / TypeScript / Tailwind 功能解決,則不加入新的函式庫。

如果需要加入函式庫,請先檢討:

為什麼需要
解決了什麼問題
是否有替代方案

38. Supabase / 後端原則 (Supabase / Backend Principle)

目前作品集的第一個版本基於靜態內容開始。

優先使用:

content/*.ts

當以下需求實際產生時,再加入 Supabase 等後端服務:

  • 管理員頁面
  • 專案 CRUD
  • 部落格
  • 開發紀錄
  • 聯絡資訊儲存
  • 認證
  • 動態資料管理

在不需要後端的階段,請勿先行導入資料庫。


39. Git 工作流程 (Git Workflow)

當完成有意義的工作單位時,請進行 Commit。

基本流程:

git add .
git commit -m "工作內容"
git push

Commit Message 建議採用 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. 最終品質標準 (Final Quality Standard)

完成的畫面應能對以下問題回答「是」。

  • 在首頁能看到開發者的身份認同嗎?
  • 專案看起來是核心內容嗎?
  • 能理解每個專案解決了什麼問題嗎?
  • 相較於技術清單,是否更強調了實際結果與過程?
  • 在行動版上也易於閱讀嗎?
  • 內容與 UI 是否分離?
  • 能否輕鬆新增新的專案?
  • 是否未包含實際上不存在的資訊?
  • 是否在沒有過度設計效果的情況下給人專業印象?
  • 是否未不必要的刪除既有功能?

41. 不可協商的規則 (Non-Negotiable Rules)

以下原則始終維持:

  1. 裝飾不應優先於內容。
  2. 專案是作品集的核心。
  3. 不要編造非實際經驗的內容。
  4. 不要任意加入使用者未提供的成就或數據。
  5. 分離內容與 UI。
  6. 以響應式設計為基本。
  7. 考慮可及性。
  8. 不加入不必要的函式庫。
  9. 不要任意刪除既有功能。
  10. 大型結構變更應在實作前與使用者確認。
  11. 設計應維持 Professional / Modern / Minimal / Technical 的方向。
  12. 以 Light Mode 為第一版本的預設值。
  13. 設計應確保新增專案時無需修改 UI 程式碼。
  14. 所有設計決策以可讀性與資訊傳達為優先。

相關技能