前端履歷
建立零依賴、動畫豐富的 HTML 履歷頁面,完全在瀏覽器中執行。協助使用者透過視覺探索發掘個人偏好的美學風格,然後產生適合生產環境的互動式履歷。
核心哲學
- 零依賴 — 單一 HTML 檔案,CSS/JS 均內嵌於檔案中。無需 npm,無需建置工具。
- 展示,而非告知 — 產生視覺預覽,讓使用者挑選喜歡的風格。
- 獨特設計 — 避免泛用的「AI 生成美學」。每個履歷都應感覺像是量身訂做。
- 適合列印 — 每個履歷都必須包含
@media print樣式,以產出清晰的 PDF。 - 可及性 — 使用語意化 HTML、鍵盤導覽、支援減少動畫設定、符合 WCAG AA 對比度。
階段 0:偵測模式
判斷使用者的需求:
模式 A:從檔案處理 — 使用者提供履歷檔案(.pdf、.docx、.md、.txt、.json)→ 進入階段 1 模式 B:從文字處理 — 使用者以純文字提供履歷內容 → 進入階段 1 模式 C:增強模式 — 使用者有現有 HTML 履歷想要改進 → 讀取檔案,然後進入階段 2
階段 1:內容提取與結構化
步驟 1.1:檔案提取(僅限模式 A)
在使用者的履歷檔案上執行 scripts/extract_resume.py:
python [skill-dir]/scripts/extract_resume.py <resume_file>
支援的格式與相依套件:
| 格式 | 副檔名 | Python 相依套件 | 備註 |
|---|---|---|---|
pdfplumber(建議)或 PyPDF2 | pip install pdfplumber | ||
| Word | .docx | python-docx | pip install python-docx |
| Markdown | .md | 無 | 解析標題、列表、粗體/斜體 |
| 純文字 | .txt | 無 | 全大寫行推斷為標題 |
| JSON Resume | .json | 無(內建 json) | jsonresume.org 結構;已結構化 — 可跳過步驟 1.2 |
如果缺少必要的相依套件,腳本會印出安裝說明。
向使用者呈現提取的內容以供確認。對於 JSON Resume 檔案,資料已經結構化 — 直接呈現對應的區段,並跳至步驟 1.3,除非使用者想要調整。
步驟 1.2:結構化內容
將原始文字解析為結構化區段:
- header:姓名、職稱/標語、地點、聯絡方式(電子郵件、電話、LinkedIn、GitHub、作品集)
- about:專業摘要
- experience[]:公司、職位、日期、地點、條列重點
- education[]:學校、學位、日期、榮譽/GPA
- skills{}:按類別分組,可選熟練度百分比(0-100)
- projects[]:名稱、描述、技術棧、連結
- certifications[]:名稱、發證機構、日期(可選)
- languages[]:語言、熟練度(可選)
向使用者呈現結構化內容以供審閱。詢問:「看起來正確嗎?有沒有要新增、刪除或修改的區段?」
步驟 1.3:區段優先順序
透過 AskUserQuestion 詢問:
- Header:「版面配置」
- 問題:「哪些區段應該最突出?」
- 選項:
- 「經歷為主」 — 工作經歷是重點(資深專業人士)
- 「技能為重」 — 技術技能置於最前方(開發者/工程師)
- 「專案導向」 — 作品集/專案為焦點(設計師/自由工作者)
- 「均衡」 — 所有區段權重相同
階段 2:風格探索
步驟 2.0:風格選擇路徑
詢問:「您希望如何選擇履歷風格?」
- 「讓我看看選項」 — 產生 3 個視覺預覽(建議)→ 步驟 2.1
- 「我知道我要什麼」 — 直接從預設清單挑選 → 直接顯示預設選擇器
可用預設風格:
| 預設風格 | 氛圍 | 最適合 |
|---|---|---|
| 午夜建築師 | 精緻、高級 | 高階主管、顧問 |
| 霓虹終端機 | 駭客時尚、開發者風格 | 軟體工程師、DevOps |
| 暗黑奢華 | 優雅、編輯風格 | 創意總監、行銷人員 |
| 宇宙深淵 | 大膽、未來感 | 科技創辦人、AI/ML 工程師 |
| 潔淨石板 | 極簡、瑞士風格 | 設計師、產品經理 |
| 紙藝風格 | 溫暖、觸感 | 作家、教育工作者、學者 |
| 柔軟藍圖 | 技術感、易親近 | 工程師、資料科學家 |
| 野獸派單色 | 原始、反設計 | 品牌策略師、求獨特者 |
| 鼠尾草花園 | 自然啟發、平靜 | 人資、健康、教育工作者 |
| 復古油墨 | 復古編輯風格 | 記者、個人品牌 |
如果使用者直接挑選,則跳至階段 3。
步驟 2.1:引導式探索
問題 1 — 情緒(可複選,最多 2 個):
- 「專業/權威」 — 穩重、可信賴
- 「創意/獨特」 — 獨特、設計前衛
- 「現代/技術」 — 簡潔、開發者導向
- 「溫暖/親和」 — 友善、有個人特色
問題 2 — 色調:
- 「淺色」 — 簡潔、適合列印
- 「深色」 — 大膽、針對螢幕最佳化
- 「皆可」 — 讓風格自行決定
步驟 2.2:產生 3 個預覽
根據情緒 + 色調,選擇 3 個預設風格。閱讀 references/STYLE_PRESETS.md 以取得完整的預設風格定義。
情緒到預設風格的對應:
| 情緒 | 深色 | 淺色 | 特殊 |
|---|---|---|---|
| 專業 | 午夜建築師、暗黑奢華 | 潔淨石板、柔軟藍圖 | — |
| 創意 | 暗黑奢華、宇宙深淵 | 紙藝風格 | 野獸派單色、復古油墨 |
| 現代/技術 | 霓虹終端機、宇宙深淵 | 柔軟藍圖 | 野獸派單色 |
| 溫暖 | 暗黑奢華 | 紙藝風格、鼠尾草花園 | 復古油墨 |
在 .claude-design/resume-previews/ 中產生 3 個迷你 HTML 預覽:
.claude-design/resume-previews/
├── style-a.html
├── style-b.html
└── style-c.html
每個預覽:自包含(約 80-120 行),顯示主視覺區 + 一筆經歷 + 技能條。足以傳達美學風格。
絕對不要使用以下泛用模式:
- Inter、Roboto、Arial 作為顯示字型
- 白色背景上的紫色漸層、泛用的靛藍色
#6366f1 - 全部置中沒有任何變化
- 不必要的玻璃擬態效果
步驟 2.3:選擇
呈現預覽,請使用者選擇一個或混合元素。
階段 3:產生履歷
對於所選的預設風格,讀取以下參考檔案:
references/STYLE_PRESETS.md— 完整的 CSS 變數、字型 URL、色彩調色盤、動畫風格references/RESUME_COMPONENTS.md— 互動式元件 CSS/JS 模式references/HTML_ARCHITECTURE.md— 基礎 HTML 範本、強制 CSS、JS 架構、列印樣式、可及性檢查清單
輸出
產生一個自包含的 HTML 檔案:
- 所有 CSS 內嵌在
<style>中 - 所有 JS 內嵌在
<script>中 - Google Fonts / Fontshare 透過
<link>(優雅降級) - 語意化 HTML5 結構
必要功能
- 滾動觸發顯示 — 元素透過 IntersectionObserver 動畫入場
- 浮動導覽 — 固定導覽列,並追蹤當前區段
- 動畫技能條 — 滾動到視窗後填滿
- 滾動進度條 — 頂端細長條
- 回到頂部按鈕 — 滾動後出現
- 列印樣式表 —
@media print,白色背景,無動畫,顯示 URL - 減少動畫 —
@media (prefers-reduced-motion: reduce)停用動畫 - 響應式設計 — 所有尺寸使用
clamp(),適用於手機到桌機
驗證檢查清單
在交付前,確認:
- 所有排版使用
clamp(min, preferred, max) - 所有間距使用
clamp()或視埠單位 - 語意化 HTML(
<header>、<main>、<section>、<nav>) - 已包含並可運作列印樣式
- 已尊重減少動畫設定
- 導覽、按鈕、進度條有 ARIA 標籤
- 色彩對比度符合 WCAG AA
- 外部連結使用
target="_blank" rel="noopener"
階段 4:交付
- 清理 — 如果
.claude-design/resume-previews/存在則刪除 - 開啟 — 在瀏覽器中啟動:
open [filename].html - 摘要:
您的互動式履歷已準備就緒!
檔案:[filename].html
風格:[Style Name]
區段:[list]
功能:
- 滾動觸發動畫
- 動畫技能條
- 互動式時間軸
- 浮動導覽
- 適合列印(Ctrl+P)
- 響應式,適用所有螢幕尺寸
自訂方式:
- 色彩:編輯頂端的 :root CSS 變數
- 字型:變更字型匯入連結
- 動畫:修改 .reveal 類別的時間設定
- 內容:直接在 HTML 中編輯文字
需要我進行任何調整嗎?
疑難排解
PDF 提取內容稀少: PDF 可能是基於圖片的掃描檔。請使用者直接提供文字內容。
DOCX 提取缺少結構: 部分 DOCX 檔案未使用標準標題樣式(Heading 1/2/3)。提取器會根據字型大小回退。如果結構仍不清楚,請使用者確認哪些行是區段標題。
JSON Resume 缺少欄位: JSON 可能省略了選用區段(專案、證書等)。呈現可用的內容,並詢問使用者是否要手動新增缺少的區段。
Markdown frontmatter 干擾: YAML frontmatter 分隔符號(---)會自動跳過。如果履歷內容本身使用 --- 作為水平線,也會被跳過 — 這通常無害。
字型無法載入: 檢查字型 URL。確保 font-family 宣告包含系統字型備援。
動畫未觸發: 確認 IntersectionObserver 已初始化。檢查 .visible 類別是否已新增。
列印輸出異常: 確保 @media print 區塊存在。檢查動畫是否已停用,背景是否為白色。