Communitygithub.com

前端履歷生成器

將履歷轉換為互動式、具動畫效果的單頁 HTML 履歷網站,並提供多種獨特視覺風格。適合非設計師使用者透過視覺探索發掘個人美學。

前端履歷生成器 是什麼?

這是一個專注於建立零依賴、動畫豐富的 HTML 履歷頁面的 AI 技能。它能從 PDF、DOCX、Markdown、純文字、JSON Resume 格式或直接輸入的文字中提取履歷內容,並將其結構化為標準區塊(如 header、experience、skills)。使用者可以透過互動式視覺探索或直接從預設風格清單中選擇喜歡的履歷風格。 此技能支援多種 AI 代理平台(如 Claude Code、Coder、Cursor 等),透過產生三個迷你 HTML 預覽圖來引導使用者發現美學偏好,而非強迫使用者從技術描述中想像。最終生成的履歷包含滾動觸發動畫、浮動導覽、動畫技能條、滾動進度條、回到頂部按鈕,並內建列印樣式與輔助功能支援。 其核心哲學是「展示,而非告知」,避免使用泛泛的設計模式(如紫色漸層、千篇一律的中置排版),確保每個履歷都具有獨特且精緻的風格。它不僅能產生全新履歷,還能增強現有的 HTML 履歷,是開發者、設計師與專業人士建立個人品牌的強大工具。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yukiniro/skills/tree/HEAD/skills/frontend-resume

在你喜歡的 AI 中提問

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

說明文件

前端履歷

建立零依賴、動畫豐富的 HTML 履歷頁面,完全在瀏覽器中執行。協助使用者透過視覺探索發掘個人偏好的美學風格,然後產生適合生產環境的互動式履歷。

核心哲學

  1. 零依賴 — 單一 HTML 檔案,CSS/JS 均內嵌於檔案中。無需 npm,無需建置工具。
  2. 展示,而非告知 — 產生視覺預覽,讓使用者挑選喜歡的風格。
  3. 獨特設計 — 避免泛用的「AI 生成美學」。每個履歷都應感覺像是量身訂做。
  4. 適合列印 — 每個履歷都必須包含 @media print 樣式,以產出清晰的 PDF。
  5. 可及性 — 使用語意化 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 相依套件備註
PDF.pdfpdfplumber(建議)或 PyPDF2pip install pdfplumber
Word.docxpython-docxpip 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 結構

必要功能

  1. 滾動觸發顯示 — 元素透過 IntersectionObserver 動畫入場
  2. 浮動導覽 — 固定導覽列,並追蹤當前區段
  3. 動畫技能條 — 滾動到視窗後填滿
  4. 滾動進度條 — 頂端細長條
  5. 回到頂部按鈕 — 滾動後出現
  6. 列印樣式表 — @media print,白色背景,無動畫,顯示 URL
  7. 減少動畫 — @media (prefers-reduced-motion: reduce) 停用動畫
  8. 響應式設計 — 所有尺寸使用 clamp(),適用於手機到桌機

驗證檢查清單

在交付前,確認:

  • 所有排版使用 clamp(min, preferred, max)
  • 所有間距使用 clamp() 或視埠單位
  • 語意化 HTML(<header>、<main>、<section>、<nav>)
  • 已包含並可運作列印樣式
  • 已尊重減少動畫設定
  • 導覽、按鈕、進度條有 ARIA 標籤
  • 色彩對比度符合 WCAG AA
  • 外部連結使用 target="_blank" rel="noopener"

階段 4:交付

  1. 清理 — 如果 .claude-design/resume-previews/ 存在則刪除
  2. 開啟 — 在瀏覽器中啟動:open [filename].html
  3. 摘要:
您的互動式履歷已準備就緒!

檔案:[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 區塊存在。檢查動畫是否已停用,背景是否為白色。

相關技能