Communitygithub.com

MikeCheng1208/BattleTree

極簡、專注於排版的作品集設計系統,靈感來自新粗獷主義與瑞士設計原則。強調大膽排版、充裕留白、單色配色方案,以及為開發者/設計師作品集打造的優雅簡潔風格。

BattleTree 是什麼?

此技能提供一個全面的指南,用於建立以排版為核心的極簡作品集網站,靈感源自新粗獷主義與瑞士設計原則。它涵蓋核心設計理念、排版系統、色彩系統、佈局與間距、元件設計模式,以及完整的作品集頁面結構。支援的平台包括所有現代網頁開發環境,例如使用 HTML、CSS 與 JavaScript 開發的靜態網站,以及 React、Next.js 或 Vue.js 等框架。此技能的主要優點在於其系統化的方法,能透過強烈的視覺層次、充裕的留白與嚴謹的網格系統,確保一致性與專業感。它明確區分了「應該做」與「不該做」的事項,避免過度裝飾或花俏的動畫,以維持永恆的優雅與可讀性。此外,它也提供了深色模式的實作考量,以及針對行動裝置響應式設計的詳細規範,使開發者能輕易地將這些原則應用於真實的專案中。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MikeCheng1208/BattleTree/tree/HEAD/.agents/skills/minimalist-portfolio-design

在你喜歡的 AI 中提問

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

說明文件

極簡作品集設計技能

本技能指導創建以排版為核心、具有極簡美學的乾淨作品集網站。此方法基於新粗獷主義與瑞士設計原則,優先考慮可讀性、視覺層次與專業呈現,而非裝飾性元素。

核心設計理念

設計原則:

  • 排版為主軸:讓字型承擔主要視覺工作
  • 徹底簡化:移除所有非必要的元素
  • 充裕留白:空間本身即為設計元素,而非空白
  • 單色調色盤:黑色、白色、以及各種灰色
  • 網格精準:所有元素都對齊到隱形網格
  • 無裝飾:形式追隨功能
  • 瑞士設計影響:清晰、不對稱的佈局,具有明確的層次

此風格「是」什麼:

  • 大膽、自信、專業
  • 乾淨、不雜亂
  • 由排版驅動
  • 永恆且優雅
  • 易於掃讀與瀏覽

此風格「不是」什麼:

  • 色彩豐富或俏皮(無亮色)
  • 大量動畫(僅限微互動)
  • 雜亂或繁忙
  • 裝飾性或華麗
  • 潮流或花俏

排版系統

字型選擇

主要字型選項(新無襯線/幾何無襯線):

  1. Aeonik(如參考資料所示)– 新無襯線、幾何、現代
  2. Inter – 多功能、螢幕可讀性佳、免費
  3. Satoshi – 幾何、乾淨、現代感
  4. Supreme – 大膽、幾何、適合大型展示文字
  5. Space Grotesk – 具有個性的現代幾何字型
  6. Neue Montreal – 瑞士風格、線條乾淨
  7. General Sans – 平衡、專業、多功能

系統字型堆疊(備用):

font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell', sans-serif;

字級與層級

展示/主標題文字(如大型問候語「Hello」):

  • 桌面版:8rem-12rem (128px-192px)
  • 平板版:6rem-8rem (96px-128px)
  • 手機版:4rem-6rem (64px-96px)
  • 字重:400-500(一般到中等)
  • 行高:0.9-1.0(緊密)
  • 字距:-0.02em 至 -0.04em(緊密)

區塊標題(如「Colors」「Typography」):

  • 桌面版:4rem-6rem (64px-96px)
  • 平板版:3rem-4rem (48px-64px)
  • 手機版:2.5rem-3rem (40px-48px)
  • 字重:400-500
  • 行高:1.1
  • 字距:-0.02em

副標題/標籤(如「Primary」「Secondary」):

  • 大小:1.25rem-1.5rem (20px-24px)
  • 字重:400-500
  • 行高:1.4
  • 字距:0

內文(如「Colors」下方的描述):

  • 大小:1rem-1.125rem (16px-18px)
  • 字重:400
  • 行高:1.6-1.7
  • 字距:0
  • 最大寬度:65ch(字元)以維持可讀性

小型文字/標籤(如「Scroll down ↓」):

  • 大小:0.875rem-1rem (14px-16px)
  • 字重:400
  • 行高:1.5
  • 字距:0.01em

導覽連結:

  • 大小:1rem-1.125rem (16px-18px)
  • 字重:400-500
  • 字距:0

排版規則

  • 整個網站使用一種字型(一致性勝於多樣性)
  • 使用字重來建立層次,而非多種字型
  • 大型展示文字使用緊密字距
  • 內文使用標準字距
  • 內文使用寬鬆行高 (1.6-1.7) 以提高可讀性
  • 展示文字使用緊密行高 (0.9-1.1)
  • 文字靠左對齊(除非是特定主視覺元素,否則不置中)
  • 內文不使用全大寫(僅小型標籤可視需要採用)

色彩系統

單色調色盤(主要方法)

這是核心美學 – 僅使用黑色、白色與灰色。

色票:

--color-black: #222222;        /* 主要 – 濃黑色,非純黑 */
--color-gray-dark: #7B7B7B;    /* 次要 – 中灰色 */
--color-gray-light: #F8F8F8;   /* 第三 – 米白背景 */
--color-white: #FFFFFF;        /* 純白 */
--color-gray-50: #FAFAFA;      /* 最淺灰 */
--color-gray-100: #F5F5F5;     /* 非常淺灰 */
--color-gray-200: #EEEEEE;     /* 淺灰 */
--color-gray-300: #E0E0E0;     /* 邊框灰 */
--color-gray-400: #BDBDBD;     /* 停用狀態 */
--color-gray-500: #9E9E9E;     /* 中灰 */
--color-gray-600: #757575;     /* 文字灰 */
--color-gray-700: #616161;     /* 深灰文字 */
--color-gray-800: #424242;     /* 接近黑色 */
--color-gray-900: #212121;     /* 最深灰 */

色彩使用方式:

  • 背景:#F8F8F8 或 #FFFFFF(淺色模式)/ #0A0A0A(深色模式)
  • 主要文字:#222222(淺色模式)/ #F8F8F8(深色模式)
  • 次要文字:#7B7B7B(兩種模式)
  • 邊框:#E0E0E0(淺色模式)/ #2A2A2A(深色模式)
  • 卡片/表面:#FFFFFF(淺色模式)/ #1A1A1A(深色模式)
  • 懸停狀態:稍微變暗/變亮(透明度變化 10-15%)

強調色選項(最低限度使用)

僅在絕對必要時 – 謹慎使用一個強調色:

  • 僅用於 Call To Action(例如「Book A Call」按鈕)
  • 用於關鍵元素的懸停狀態
  • 用於作用中連結指示器
  • 切勿用於背景或大面積

建議的強調色(選擇一個):

  • 科技藍:#0066FF(IBM 藍,專業)
  • 成功綠:#00B386(柔和、值得信賴)
  • 暖紅:#FF3B30(Apple 紅,引人注目)
  • 保持黑色:不使用任何強調色(最純粹的方法)

色彩應用規則

  1. 淺色模式預設:白色/米白背景(#F8F8F8 至 #FFFFFF)
  2. 深色模式選項:深灰/黑色背景(#0A0A0A 至 #121212)
  3. 文字對比度:內文最低 4.5:1,大型文字最低 3:1
  4. 無漸層:僅純色
  5. 無陰影(或非常輕微的 1-2px 陰影):改用邊框
  6. 懸停狀態:透明度變化(0.7-0.8)或背景色偏移
  7. 攝影:黑白或去飽和(如同參考肖像)

深色模式考量

若實作深色模式:

  • 背景:#0A0A0A 至 #121212(非純黑)
  • 表面:#1A1A1A 至 #222222
  • 文字:#F8F8F8 至 #FFFFFF
  • 邊框:#2A2A2A 至 #333333
  • 維持相同的單色調方法
  • 避免純白配純黑(會造成眼睛疲勞)

佈局與間距系統

網格系統

容器寬度:

  • 最大內容寬度:1440px-1600px
  • 內容內距:兩側 5-10%(響應式)
  • 手機版內距:兩側 24px-32px

網格結構:

  • 12 欄網格以提供靈活性
  • 主視覺區:不對稱 60/40 或 50/50 分割(文字/圖片)
  • 寬敞的間距:欄與欄之間 32px-48px

間距比例(8pt 網格)

所有間距皆為 8 的倍數:

4px (0.25rem)   – 最小間距
8px (0.5rem)    – 緊密間距
16px (1rem)     – 小間距
24px (1.5rem)   – 中間距
32px (2rem)     – 標準間距
48px (3rem)     – 大間距
64px (4rem)     – 加大間距
96px (6rem)     – 區塊間距(手機版)
128px (8rem)    – 區塊間距(平板版)
160px (10rem)   – 區塊間距(桌面版)
192px (12rem)   – 主視覺區間距

垂直節奏

區塊之間:

  • 手機版:96px-128px
  • 平板版:128px-160px
  • 桌面版:160px-192px

區塊內部:

  • 標題與內容之間:32px-48px
  • 段落之間:24px-32px
  • 列表項目之間:16px-24px

元件間距:

  • 導覽列內距:垂直 24px-32px
  • 卡片內距:內部 32px-48px
  • 按鈕內距:水平 16px-32px,垂直 12px-16px

響應式中斷點

/* 手機優先方法 */
mobile: 320px-640px
tablet: 641px-1024px
desktop: 1025px-1440px
xl: 1441px+

/* Tailwind 對應 */
sm: 640px
md: 768px
lg: 1024px
xl: 1280px
2xl: 1536px

作品集版面模式

主視覺區(全螢幕)

佈局:50/50 分割(文字左、圖片右)
高度:100vh(全螢幕)
垂直對齊:置中

左側:
- 大型問候文字:「Hello」
- 副標題:「— It's [Name] a [role]」
- 數據(可選):「+200 Project completed」
- 滾動指示器:「Scroll down ↓」
- 垂直文字(可選):「Product designer」

右側:
- 大型肖像照
- 黑白或去飽和處理
- 專業、自信的表情
- 無背景(或微漸層)

導覽列:

  • 位置:絕對定位置頂或固定置頂
  • 高度:80px-100px
  • Logo:左上(距離邊緣 24px-32px)
  • 連結:上方置中或靠右
  • Call To Action:右上(「Book A Call」附箭頭)
  • 背景:透明或滾動時使用微 backdrop-blur
  • 邊框:無或底部 1px 邊框 (#E0E0E0)

關於/資訊區塊

佈局:單欄,內容置中
最大寬度:800px-900px 以維持可讀性
標題:靠左對齊,大尺寸
內文:靠左對齊,舒適的行長

作品集網格

桌面版:3 欄
平板版:2 欄
手機版:1 欄
間距:32px-48px
卡片寬高比:4:3 或 16:9

留白哲學

更多空間 = 更高級

  • 空白是設計元素
  • 不要填滿每個像素
  • 讓內容呼吸
  • 使用留白引導視線
  • 平衡是關鍵:不要太稀疏,也不要太擁擠

留白檢查清單:

  • 所有元素周圍是否有呼吸空間?
  • 眼睛是否能輕易識別區塊?
  • 佈局是否感覺平靜且有組織?
  • 相關項目是否以較小間距分組?
  • 不相關的項目是否以較大間距分隔?

元件設計模式

導覽列

結構:

[Logo]                    [About Me] [Portfolio] [Services] [Blog]                    [Book A Call →]

規格:

  • 高度:80px-100px
  • 位置:固定置頂並使用 backdrop-filter blur,或絕對定位
  • 背景:透明 → 滾動時半透明
  • Logo:簡單的文字商標或圖示(24px-32px 大小)
  • 連結:16px-18px,中等字重
  • 連結間距:間隔 32px-48px
  • CTA 按鈕:外框或填滿,靠右對齊
  • 懸停:透明度 0.7 或微底線(1-2px)

手機版導覽:

  • 漢堡選單:簡單的三線圖示(24px)
  • 選單:全螢幕覆蓋或側邊抽屜
  • 連結:較大文字(24px-32px),垂直堆疊
  • 動畫:流暢的 200-300ms 淡入淡出

按鈕

主要按鈕 (CTA):

padding: 14px-16px 垂直, 28px-32px 水平
border-radius: 4px-8px(輕微,非藥丸形狀)
font-size: 16px-18px
font-weight: 500
background: #222222(或強調色)
color: #FFFFFF
border: 無 或 1-2px 實線
hover: opacity: 0.9 或 transform: translateY(-2px)

次要按鈕:

尺寸與主要按鈕相同
background: 透明
color: #222222
border: 1-2px 實線 #222222
hover: background: #222222, color: #FFFFFF

文字連結:

無背景,無邊框
底線:1px 實線(僅懸停時顯示)或始終存在
懸停:opacity: 0.7

卡片(作品集卡片)

結構:

┌──────────────────────────┐
│                          │
│      專案圖片            │
│      (16:9 比例)         │
│                          │
├──────────────────────────┤
│  專案標題                │
│  簡短描述...            │
│  [標籤] [標籤] [標籤]    │
└──────────────────────────┘

規格:

  • 背景:#FFFFFF 或 #FAFAFA
  • 邊框:1px 實線 #E0E0E0 或微陰影
  • 邊框圓角:8px-12px(輕微)
  • 內距:0(圖片滿版) + 底部 24px-32px
  • 圖片:填滿寬度,固定寬高比
  • 懸停:縮放 1.02 或提升(搭配陰影)或邊框顏色變化
  • 過渡:200-300ms 淡入淡出

卡片內容:

  • 標題:20px-24px,中等字重
  • 描述:16px,一般字重,最多 2-3 行
  • 標籤:12px-14px,內距 6px-12px,圓角滿版,邊框 1px

數據顯示(「+200 Project completed」)

樣式:

數字:3rem-4rem (48px-64px),中等字重
標籤:1rem (16px),一般字重,灰色
佈局:垂直堆疊
間距:數字與標籤之間 8px

位置:

  • 靠近主視覺文字
  • 輕微,不與主要訊息競爭
  • 可以多個數據並排(間距 32px-48px)

攝影/圖片

肖像照(主視覺區):

  • 黑白或高度去飽和
  • 專業、直視鏡頭
  • 乾淨背景(純色或微漸層)
  • 高品質:清晰、光線充足
  • 寬高比:直向(3:4)或方形(1:1)
  • 尺寸:大尺寸,佔據 40-50% 的視窗

專案圖片:

  • 高品質:模型或截圖
  • 所有專案保持一致的寬高比
  • 考慮:16:9(橫向)或 4:3
  • 懸停:輕微放大(縮放 1.05)或無效果
  • Alt 文字:務必包含以確保無障礙性

圖示

圖示風格:

  • 極簡:僅使用線條圖示(無填滿圖示)
  • 線條粗細:1.5px-2px
  • 大小:標準 20px-24px,特色 32px-40px
  • 顏色:與文字顏色一致 (#222222 或 #7B7B7B)
  • 範例:箭頭 (→)、選單 (≡)、關閉 (×)、社交圖示

圖示使用方式:

  • 導覽:漢堡選單、CTA 的箭頭
  • 社交連結:GitHub、LinkedIn、Twitter/X、Email
  • 箭頭:用於連結、按鈕、滾動指示器
  • 保持極簡:不要過度使用圖示

表單(聯絡表單)

輸入欄位:

padding: 16px
border: 1px 實線 #E0E0E0
border-radius: 4px-8px
background: #FFFFFF 或 #FAFAFA
font-size: 16px
focus: border-color: #222222, outline: none

標籤:

font-size: 14px-16px
font-weight: 500
margin-bottom: 8px
color: #222222

佈局:

  • 單欄,滿版寬度
  • 欄位:姓名、電子郵件、訊息(最多 3 個欄位)
  • 間距:欄位之間 24px
  • 送出按鈕:滿版寬度或靠右對齊

滾動指示器

文字樣式:

「Scroll down ↓」
font-size: 14px-16px
color: #7B7B7B
position: 底部置中或底部靠左
animation: 輕微彈跳(可選)

替代方案:

  • 動畫線條/箭頭
  • 帶滾輪動畫的滑鼠圖示
  • 保持輕微與極簡

作品集頁面結構

1. 主視覺區(首屏上方)

目的:立即留下印象,明確識別身分

內容:

  • 大型問候:「Hello」(或您的變化)
  • 姓名與角色:「— It's [Name] a [role]」
  • 可選的數據:「+200 Project completed」「+50 Startup raised」
  • 滾動指示器:「Scroll down ↓」
  • 肖像照:右側,黑白,專業

佈局:

  • 滿版高度(100vh)
  • 50/50 分割(文字左、照片右)或 60/40
  • 垂直置中
  • 白色或米白背景
  • 頂部極簡導覽列

排版:

  • 「Hello」:桌面版 10rem-12rem,手機版 6rem
  • 副標題:1.25rem-1.5rem,灰色 (#7B7B7B)

…

[此處省略以進行翻譯]

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

MikeCheng1208/BattleTree

Index-based file discovery using ABOUTME headers. Use INSTEAD of grep or Explore agent when searching for files by purpose or feature. Faster and more accurate than scanning code. Invoke this skill when user asks "which files handle X", "where is Y implemented", or when you need to find files related to a feature or task.

MikeCheng1208/BattleTree

Factor modeling and portfolio construction (Markowitz, Black-Litterman, constraints, turnover).

MikeCheng1208/BattleTree

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

MikeCheng1208/BattleTree

Analyze the CustomGPT.ai Labs Innovation workbook and cost tracking data to surface portfolio-level insights, trends, and recommendations for where to focus Innovation efforts.

MikeCheng1208/BattleTree

Personal meta-skill for Arach. Use this as the entry point to understand arach's projects, conventions, and available skills. Activates on "arach's projects", "what does arach work on", or when working in any arach/* repo.

MikeCheng1208/BattleTree

High-converting landing pages. Copy + design + implementation. Triggers: landing page, conversion page.

MikeCheng1208/BattleTree

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios,...

MikeCheng1208/BattleTree

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

MikeCheng1208/BattleTree

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

MikeCheng1208/BattleTree

Optimize project portfolio selection under constraints using mathematical optimization

MikeCheng1208/BattleTree

Detect and explain risk drift in lending portfolios over time using vintage analysis, migration matrices, and concentration metrics. Use when monitoring portfolio credit quality trends, preparing board risk reports, conducting stress testing, or when risk metrics deviate from appetite thresholds.

MikeCheng1208/BattleTree

Build a GitHub portfolio that gets you hired — curate 3-5 polished projects, craft compelling READMEs, deploy live demos, tell a coherent story across your repos, and align everything to AI-native development roles. Use when preparing your GitHub for job searches, deciding what to pin, or auditing your public presence.

相關技能