Communitygithub.com

RiverAi7z/pdf-resume-skills

從一份 PDF 履歷表打造令人驚豔的個人網站。每當使用者想要建立個人網站、作品集網站或線上履歷時,即可使用此技能。當使用者提及將履歷轉換為網站、從 CV 建立作品集,或想要基於個人專業背景的登陸頁面時,也會觸發此技能。

pdf-resume-skills 是什麼?

此技能能夠從 PDF 格式的履歷表自動生成一個風格獨特、可直接上線的個人網站。它深入剖析使用者的專業背景(如軟體工程師、設計師、學術研究者等),並根據其職業類別,提供高度客製化的設計方向,涵蓋字體選擇、色彩調配、動態效果與背景質感,確保每個網站都獨一無二,而非套用模板。工作流程包含使用 `uv` 腳本或備援的 pdf-reader MCP 來擷取 PDF 內容,接著與使用者互動詢問設計偏好,最終生成具有強烈個人風格的靜態 HTML 網站。支援 Claude Code 等 AI 代理平台,能顯著降低建立專業個人網站的門檻,同時避免 AI 生成網站常見的「美學趨同」問題。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add RiverAi7z/pdf-resume-skills

在你喜歡的 AI 中提問

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

說明文件

履歷網站建置器

從一份 PDF 履歷表,打造一個與眾不同、可直接上線的個人網站。這個網站應反映使用者的專業、個性與設計偏好——而不是一個看起來千篇一律的通用模板。


設計美學規範

在撰寫任何一行程式碼之前,請先內化這個觀念:AI 生成網站最大的失敗模式就是「美學趨同」——每個網站看起來都差不多。務必避免這種情況。你的目標是做出一個真正為「這個人」量身設計、感覺獨特的東西。

字體排版

選擇優美、特別且符合個人領域的字體。目標是創造出一種會讓人注意到並評論的字體搭配,而不是安全的備用方案。

禁用字型(使用過度,以至於沒有識別度):Inter、Roboto、Arial、Helvetica、system-ui、-apple-system、Space Grotesk、Poppins。這些是預設值,不是選擇。

可參考的獨特 Google Fonts(根據職業與美學挑選合適的,不要全部使用):

編輯 / 表現性襯線體:

  • Cormorant Garamond — 浪漫、文學、時尚編輯的奢華感
  • Playfair Display — 經典印刷編輯,高對比筆畫
  • Fraunces — 獨特的光學襯線體,個性出人意料
  • Instrument Serif — 精緻而現代,低調的信心
  • DM Serif Display — 現代襯線體,力道十足
  • Abril Fatface — 超高對比,標題首選
  • Yeseva One — 裝飾藝術的溫暖感,平易近人的權威
  • Cinzel — 古典羅馬的莊嚴感

乾淨但獨特的無襯線體:

  • Syne — 幾何感、設計前衛、現代
  • Unbounded — 粗體、完美網格、原生的網路字型
  • Plus Jakarta Sans — 溫暖現代,有別於 Inter
  • Outfit — 清新的幾何風格,有個性
  • DM Sans — 乾淨但不冷冰冰
  • Josefin Sans — 優雅的幾何極簡主義

內文字體(易讀、有特色):

  • Lora — 溫暖的襯線體,適合長篇閱讀
  • Source Serif 4 — 編輯風格的信任感
  • Spectral — 優雅的數位襯線體
  • Literata — 專為閱讀精準設計

技術 / 開發者美學:

  • JetBrains Mono — 開發者的信賴感
  • IBM Plex Mono — 企業技術風格,結構嚴謹
  • Space Mono — 復古數位風,充滿個性
  • Fira Code — 連字,駭客美學

表現性 / 小眾美學:

  • Exo 2 — 科幻精準感
  • Orbitron — 太空時代感(節制使用——對的人用起來會很完美)
  • Rajdhani — 有角度的、技術性的能量感

搭配原則: 選擇一個標題/展示字體和一個內文字體。它們應該形成對比——例如一個高戲劇性的襯線標題搭配一個乾淨的無襯線內文,或一個精準的等寬標題搭配一個溫暖的襯線內文。無聊的搭配就是兩個字體感覺重量相當。

色彩與主題

選用一個強烈且具有凝聚力的調色盤。膽怯的調色盤(顏色平均分布)會顯得業餘。一個主色 + 一個強烈的強調色 + 細心的中性色組合,幾乎總是比三個等重的顏色來得更強而有力。

禁用的顏色組合(陳腔濫調、預料之中):

  • 紫色/紫羅蘭漸層搭配白色背景(預設的「AI 美學」)
  • 青綠色 + 珊瑚色搭配白色(過度使用的 startup 調色盤)
  • 通用深色模式:#1a1a1a 背景 + 白色文字 + 藍色強調色
  • 沒有對比或張力的扁平粉彩

可參考的獨特調色盤原型(調整使用,不要直接複製):

  • 深森林 #1a2e1a + 暖金色 #c9a84c + 奶油色 #f5f0e8 — 有機的權威感
  • 午夜海軍藍 #0d1b2a + 電光青 #00d4ff + 白色 — 技術精準感
  • 暖黑色 #1a1208 + 琥珀色 #f59e0b + 象牙白 — 編輯風格的溫暖感
  • 炭灰色 #2a2a2a + 鏽紅色 #c0392b + 米白色 #fafaf7 — 大膽的信心
  • 深酒紅 #3d0c02 + 香檳金 #e8d5b7 + 象牙白 — 學術奢華感
  • 接近黑色 #0e0e0e + 酸性萊姆 #a8d729 + 白色 — 技術邊緣感
  • 石板灰 #2c3e50 + 深珊瑚 #ff6b4a + 奶油色 — 溫暖現代感
  • 米白色 #fafaf8 + 墨水藍 #1a1a2e + 陶土紅 #c4602a — 紮實的溫暖感
  • 深紫羅蘭 #1a0533 + 熱粉紅 #ff6b9d + 白色 — 創意極繁主義

在淺色與深色主題之間積極變化,針對不同使用者。不要因為深色「看起來比較技術性」就預設使用——一個有強烈編輯調色盤的淺色網站同樣可以引人注目。

為每個顏色使用 CSS 自訂屬性:

:root {
  --color-bg: #1a2e1a;
  --color-surface: #243824;
  --color-accent: #c9a84c;
  --color-text: #f5f0e8;
  --color-muted: #8a9e8a;
}

動態效果

一個精心編排的進場序列,比十個分散的微互動更能創造驚喜感。將頁面載入視為一個單一、經過編排的時刻。

有效的模式:

/* 載入時的交錯顯示 — 透過漸增的 animation-delay 來應用 */
@keyframes fadeUp {
  from { opacity: 0; transform: translateY(24px); }
  to   { opacity: 1; transform: translateY(0); }
}
.hero-name    { animation: fadeUp 0.6s ease forwards; animation-delay: 0.1s; }
.hero-title   { animation: fadeUp 0.6s ease forwards; animation-delay: 0.25s; }
.hero-tagline { animation: fadeUp 0.6s ease forwards; animation-delay: 0.4s; }
.hero-cta     { animation: fadeUp 0.6s ease forwards; animation-delay: 0.55s; }
  • 預設使用 opacity: 0,然後動畫到 opacity: 1 — 乾淨、可組合
  • 懸停狀態應使用 transition: all 0.2s ease — 夠快才能感覺反應靈敏
  • 觸發滾動顯示:使用 IntersectionObserver + CSS class 切換來控制區塊進入視口
  • 對於邊框、底線和高亮:動畫化的 width 或 clip-path 變換感覺精準且有目的性

避免: particle.js / canvas 粒子效果、過度的彈跳、與內容競爭的視差效果、總計延遲內容可見性超過約 1 秒的動畫。

背景

純色是懶惰的預設值。每個背景至少應該有一層深度或紋理。

技巧:

/* 網格漸層 — 多層徑向漸層疊加 */
background:
  radial-gradient(ellipse at 20% 50%, rgba(201,168,76,0.15) 0%, transparent 60%),
  radial-gradient(ellipse at 80% 20%, rgba(0,212,255,0.08) 0%, transparent 50%),
  #0d1b2a;

/* 細微的網格圖案 */
background-image: linear-gradient(rgba(255,255,255,0.03) 1px, transparent 1px),
                  linear-gradient(90deg, rgba(255,255,255,0.03) 1px, transparent 1px);
background-size: 48px 48px;

/* 透過 SVG 濾鏡實現的顆粒紋理 */
filter: url(#grain); /* 定義 SVG feTurbulence 濾鏡 */

/* 對角線條紋強調 */
background: repeating-linear-gradient(
  -45deg,
  transparent,
  transparent 8px,
  rgba(201,168,76,0.05) 8px,
  rgba(201,168,76,0.05) 9px
);

將背景技巧與整體美學相匹配——一個終端機美學的開發者網站可能使用微妙的掃描線效果;一個奢華金融網站可能使用非常淡的亞麻紋理。


工作流程

步驟 1:擷取 PDF 履歷

按以下順序嘗試——先使用 script,如果失敗再退回到 MCP。

選項 A:uv script(首選)

使用 uv 執行擷取 script。它會自動處理相依性,除了安裝 uv 之外無需額外設定。

uv run .claude/skills/resume-website/scripts/pdf-extract.py <path-to-resume.pdf>

如果尚未安裝 uv,請指示使用者先安裝:

  • macOS / Linux:
    curl -LsSf https://astral.sh/uv/install.sh | sh
    
  • Windows (PowerShell):
    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
    

安裝後,重新執行上述 script 命令。

選項 B:pdf-reader MCP(備援方案)

如果 script 因任何原因失敗,請退回使用 pdf-reader MCP。確認它已安裝——如果沒有,請安裝:

claude mcp add pdf-reader -- npx @sylphx/pdf-reader-mcp

安裝後,重新啟動 Claude Code 以啟用 MCP。然後使用 MCP 的 read_pdf 工具來擷取履歷內容。

步驟 2:閱讀並分析履歷

使用 pdf-reader MCP 讀取使用者的 PDF 履歷。提取並整理:

  • 姓名與聯絡資訊(電子郵件、電話、地點、LinkedIn、GitHub、作品集連結)
  • 專業頭銜 / 標題
  • 工作經歷(公司、職位、日期、成就)
  • 學歷(學位、學校、日期)
  • 技能(技術、軟實力、語言)
  • 專案(如果有)
  • 證照、獎項、出版品(如果有)
  • 摘要 / 目標(如果有)

步驟 3:分析使用者的職業

使用者的職業決定了網站的美學方向。將設計與他們的專業身份相匹配——但不要只做表面的分類。一家對沖基金的「軟體工程師」與一家設計公司的「軟體工程師」有著不同的美學需求。

職業類別美學方向字體起點色彩方向
軟體工程師 / 開發者終端機啟發、精準、偏好深色JetBrains Mono 或 IBM Plex Mono + 乾淨的無襯線體深色背景 + 電光強調色(青、綠、琥珀)
設計師 / 創意總監大膽、實驗性、強烈的字體排版風格表現性展示襯線體 + 幾何無襯線體高對比、意想不到的搭配
資料科學家 / 分析師結構化、分析性、資料視覺化啟發精準的無襯線體 + 易讀的襯線體內文深藍色/石板灰 + 尖銳的單一強調色
行銷 / 業務編輯雜誌風格、自信、以行動呼籲為導向高對比襯線標題 + 溫暖的無襯線體溫暖的主色 + 大膽的強調色
學術 / 研究員學者風範、大量使用襯線體、知識分子極簡主義Cormorant 或 Spectral + Lora 內文奶油色/象牙白 + 墨水色 + 一個溫暖的強調色
醫療 / 醫護乾淨、值得信賴、冷靜的權威感DM Sans 或 Plus Jakarta Sans + 易讀的內文平靜的中性色 + 值得信賴的強調色
金融 / 顧問奢華、權威、精緻Cinzel 或 Yeseva One + 優雅的襯線內文深色 + 金色/香檳色 或 深藍色 + 銀色
藝術家 / 攝影師畫廊風格、以圖像為主、戲劇化Abril Fatface 或 Syne + 極簡的內文取決於他們的作品——通常是接近黑色 + 一個大膽的顏色
產品經理現代、有組織、以指標為導向Instrument Serif + 乾淨的無襯線體自信的中間色調 + 清晰的強調色
教師 / 教育者溫暖、平易近人、易讀Fraunces 或 DM Serif + 溫暖的無襯線內文溫暖的調色盤,較高的亮度
法律權威、傳統、結構化Cinzel 或 Playfair Display + 襯線內文深藍色或炭灰色 + 金色
自由工作者 / 通才個人品牌表達——根據履歷細節決定取決於他們的個性取決於他們的個性

將此作為起點,然後根據具體履歷所揭示的個人特質、資歷和產業背景進行調整。

步驟 4:詢問使用者的設計偏好

使用 AskUserQuestion 工具來收集設計偏好。以友善、非技術性的方式提問,因為使用者可能不熟悉設計術語。

關鍵原則:每個問題必須根據使用者已回答的內容進行調整。 不要一次性批次提出所有問題並呈現預先生成的選項——後續問題的選擇取決於使用者先前的選擇。如果你在還不知道他們想要淺色還是深色主題之前就詢問字體,你會建議到錯誤的字型。

第 1 輪——錨點決策:氛圍 + 調性

一起詢問整體氛圍和淺色/深色方向,因為這兩個軸是其他所有決策的分支點。根據使用者的職業生成 3-4 個美學方向(例如,軟體工程師會看到「終端機/精準」,設計師會看到「編輯/表現性」)。先提出你的首要推薦,並解釋為什麼它特別適合他們。包含一個「給我驚喜」的選項。

一旦你得到他們的答案,將它作為後續所有決策的錨點。

第 2 輪——色彩 + 視覺風格(根據第 1 輪調整)

現在生成實際適用於他們所選主題的調色盤選項。如果他們選擇了淺色,就顯示淺色調色盤——而不是「這裡有 5 個選項,其中 3 個是深色的」。同樣地,對於視覺風格——顯示與他們所選氛圍一致的風格。使用「設計美學規範」中的調色盤原型作為起點並進行調整。

視覺化顯示顏色: 在詢問顏色問題之前,生成一個臨時的 color_preview.html 檔案並在瀏覽器中開啟,以便使用者可以查看真實的色票。然後請他們根據名稱/編號選擇。

生成 3-4 個調色盤選項。每個調色盤應包含:背景、表面、強調色和文字顏色。像這樣編寫 HTML:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>選擇你的調色盤</title>
<style>
  body { font-family: sans-serif; padding: 32px; background: #f5f5f5; }
  .palettes { display: flex; flex-wrap: wrap; gap: 24px; }
  .palette { border-radius: 12px; overflow: hidden; width: 260px; box-shadow: 0 2px 12px rgba(0,0,0,0.12); }
  .swatch { height: 56px; display: flex; align-items: center; padding: 0 16px; font-size: 13px; font-weight: 500; }
  .label { padding: 14px 16px; background: white; }
  .label h3 { margin: 0 0 4px; font-size: 15px; }
  .label p { margin: 0; font-size: 12px; color: #666; }
</style>
</head>
<body>
<h2>選擇一個調色盤</h2>
<div class="palettes">
  <!-- 為每個調色盤選項重複此區塊 -->
  <div class="palette">
    <div class="swatch" style="background:#1a2e1a; color:#f5f0e8;">Background</div>
    <div class="swatch" style="background:#243824; color:#f5f0e8;">Surface</div>
    <div class="swatch" style="background:#c9a84c; color:#1a2e1a;">Accent</div>
    <div class="swatch" style="background:#f5f0e8; color:#1a2e1a;">Text</div>
    <div class="label">
      <h3>1. 森林與金色</h3>
      <p>有機的權威感——深綠色、暖金色、奶油色</p>
    </div>
  </div>
</div>
</body>
</html>

將它儲存為當前目錄下的 color_preview.html,然後執行 open color_preview.html。告訴使用者:「我已在瀏覽器中開啟了一個顏色預覽——請查看並告訴我您喜歡哪個調色盤編號。」

在他們選擇後,刪除 color_preview.html 並繼續

相關技能