設計主題技能 (Design Theme Skill)
1. 技能識別 (Skill Identity)
- 名稱: design-theme
- 目的: 定義個人開發者作品集的整體 UI/UX 及視覺設計標準。
- 目標對象: AI / 軟體 / 產品開發者作品集
- 主要目標: 傳達的印象不是「列出技術的作品集」,而是「發現實際問題,並運用 AI 與軟體來打造產品的開發者」。
2. 核心設計哲學 (Core Design Philosophy)
本作品集優先傳達以下印象:
- Professional
- Modern
- Minimal
- Technical
- Product-oriented
- Readable
- Trustworthy
核心原則
「內容與專案應是主角,而非裝飾。」
當使用者看到首頁時,應能快速理解以下幾點:
- 這個人是誰?
- 這個人做了什麼?
- 這個人解決了什麼問題?
- 這個人建立了哪些專案?
- 這個人使用了哪些技術?
- 這個人是真的能開發的人嗎?
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)
小幅修改應盡可能維持既有結構。
在進行大型變更前,遵循以下順序:
- 確認目前結構
- 說明變更理由
- 確認影響範圍
- 提出替代方案
- 取得使用者核准
- 實作
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)
以下原則始終維持:
- 裝飾不應優先於內容。
- 專案是作品集的核心。
- 不要編造非實際經驗的內容。
- 不要任意加入使用者未提供的成就或數據。
- 分離內容與 UI。
- 以響應式設計為基本。
- 考慮可及性。
- 不加入不必要的函式庫。
- 不要任意刪除既有功能。
- 大型結構變更應在實作前與使用者確認。
- 設計應維持 Professional / Modern / Minimal / Technical 的方向。
- 以 Light Mode 為第一版本的預設值。
- 設計應確保新增專案時無需修改 UI 程式碼。
- 所有設計決策以可讀性與資訊傳達為優先。