Communitygithub.com

個人網站:履歷一鍵變精緻首頁

Resume2Site 把 Word/PDF 履歷連同 GitHub、論文與 Demo 連結,變成可部署到 GitHub Pages 的精緻個人首頁,內建從學術到創意作品集的 6 種風格,預設保護隱私。

個人網站:履歷一鍵變精緻首頁 是什麼?

「個人網站」配方第 1 步(先上線第一版),來自 Bearcoder6/Resume2Site-Skill。把 .docx 或 PDF 履歷、頭像以及選填的 GitHub、arXiv、DOI、Scholar、Demo 連結交給 Codex、Claude Code 或 Cursor。Skill 先把事實擷取到 work/profile.json,再讓你從內建風格中選擇(學術編輯、學術實驗室、工程商務、商務精緻、創意作品集、極簡履歷站),從上傳檔或 DOCX 中還原頭像,保留所有公開連結,預設不公開手機號碼,也不會把原始履歷整段塞進網頁。產出 UTF-8 靜態網站,直接推到 GitHub Pages。不需要 CLI、npm 或 pip。

相容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/Bearcoder6/Resume2Site-Skill/tree/HEAD/skills/resume2site

在你喜歡的 AI 中提問

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

說明文件

Resume2Site

使用此技能引導編碼代理從履歷材料打造一個可直接部署至 GitHub Pages 的個人網站。

此技能並非 CLI、解析器、爬蟲、SaaS 應用程式、Python 套件、npm 套件或全自動化系統。請使用代理環境提供的檔案讀取、寫入和開發工具。

預設情況下,不需要瀏覽器、Playwright、螢幕截圖工具、本地開發伺服器或視覺回歸環境。直接產生靜態 HTML/CSS 網站,執行輕量級基於檔案的檢查,然後提供使用者 output/site/index.html 的路徑,供其在本機預覽。瀏覽器或螢幕截圖檢查僅在使用者明確要求,或環境明確支援且無需額外設定的情況下才為可選項目。

所有產生的 HTML、CSS、JSON、Markdown 與素材致謝檔案均須以 UTF-8 編碼寫入。每個產生的 HTML 頁面都必須在 <head> 中包含 <meta charset="utf-8">。

必要工作流程

  1. 從提供的路徑讀取使用者的履歷與可選材料。
  2. 若 PDF 或 DOCX 提取不穩定,請要求提供 resume.txt。
  3. 不要直接從原始履歷產生網站。
  4. 先使用 prompts/extract-profile.md 建立 work/profile.json。
  5. 若履歷中包含個人肖像,請遵循 avatar-rules.md,並在提取可靠時保留它。
  6. 使用 mode-rules.md 選擇學術模式或著陸頁模式。
  7. 若使用者尚未選擇風格變體與需求,請暫停並詢問下方的「風格輸入」問題。
  8. 使用 prompts/plan-site.md、profile-schema.md 和 information-architecture.md 建立 work/site-plan.md。
  9. 在決定何者為公開內容之前,先套用隱私規則。
  10. 套用選定的內建風格變體,參考 style-pack.md 和 design-token-rules.md。使用者提供的螢幕截圖為可選補充,非必要的風格研究資料。
  11. 當代理具有瀏覽或網路能力且有用時,搜尋免費、開放或已授權的視覺素材。
  12. 視需要產生 output/site/index.html、output/site/styles.css、output/site/README.md、output/site/.nojekyll 與素材。
  13. 若推薦或使用了素材,請建立 work/asset-recommendations.md 和 output/site/ASSET_CREDITS.md。
  14. 僅從檔案執行輕量級的最終品質檢查,若有必要則改善頁面一次,然後報告本地預覽路徑。

風格輸入

在 work/profile.json 建立後,從 style-pack.md 中推薦一個風格變體,然後在使用者尚未做出明確選擇的情況下,在產生網站前提出一個簡潔的問題。

使用此選單:

我已閱讀履歷。推薦風格:<變體名稱>。原因:<一個簡短理由>。

請選擇首頁風格,或回覆「使用推薦」:
1. academic-editorial:學術首頁,適合論文、研究與教育優先的個人檔案
2. academic-lab:學術實驗室風格,適合人工智慧、工程、數據或應用研究
3. engineering-commercial:精緻工程風格,適合開發者、演算法與數據求職
4. business-polished:精緻商業風格,適合產品、顧問、營運、金融或企業簡介
5. creative-portfolio:視覺作品集,適合設計、媒體、寫作、創作者或客戶作品
6. minimal-resume-site:保守的單頁網站,適合正式或內容較少的履歷

你也可以加入其他需求,例如語言、是否公開電子郵件、是否使用肖像、是否搜尋背景圖片,或淺色/深色偏好。

儘可能以使用者的語言提出此問題。

若使用者回覆「使用推薦」、「自動」或類似答案,則繼續使用推薦的變體,並在 work/site-plan.md 中記錄該假設。

輸入

建議但非必要:

input/
  resume.pdf 或 resume.docx 或 resume.txt
  avatar.png
  github_links.txt
  paper_links.txt
  website_links.txt
  style_preference.txt
  references/

視需要建立資料夾。若使用者已提供具體的檔案路徑,則不要求使用者準備此結構。

輸出

work/
  profile.json
  site-plan.md
  asset-recommendations.md
  final-review.md

output/site/
  index.html
  styles.css
  assets/
  README.md
  .nojekyll
  ASSET_CREDITS.md

切勿將原始履歷、私人筆記、隱藏對應或內部提取記錄複製到 output/site/ 中。

模式選擇

  • 學術首頁:閱讀 academic-layout-rules.md 和 prompts/generate-academic.md。
  • 個人著陸頁:閱讀 landing-layout-rules.md 和 prompts/generate-landing.md。
  • 若不確定,請閱讀 mode-rules.md。當證據充分程度相當且難以判斷時,請詢問使用者。
  • 風格變體:閱讀 style-pack.md 並一致地使用所選的變體。

核心參考

  • workflow.md:完整順序。
  • profile-schema.md:嚴格的欄位、連結與指標範圍約定。
  • information-architecture.md:內容優先順序與區塊順序規則。
  • privacy-rules.md:公開/私人資料處理規則。
  • content-rules.md:事實性語言與改寫規則。
  • asset-rules.md:免費/開放/已授權素材搜尋、驗證與致謝規則。
  • avatar-rules.md:肖像提取優先順序與備援規則。
  • style-pack.md:內建的學術與著陸頁視覺風格指引。
  • design-token-rules.md:字體、版面、顏色、圓角與反人工智慧視覺代碼規則。
  • bad-smell-checklist.md:需修正的最終內容、設計與素材異常氣味清單。
  • quality-checklist.md:最終審查標準。

不可協商事項

  • 在改寫事實之前先提取它們。
  • 不得捏造遺漏的經歷、著作、指標、獎項、所屬機構、顧問、推薦或證照。
  • 將數值證據保留在原始上下文中。專案或經歷中的數字,如延遲時間、API 數量、測試案例、基準測試結果或成本變動,不得重複用作個人/個人檔案指標。
  • 對於遺漏的個人檔案欄位,請使用空字串或空陣列。
  • 儘可能讓使用者提供的事實可追溯至來源。
  • 在公開包含電話號碼或敏感的個人詳細資料之前,先取得使用者同意。
  • 不要將原始履歷文字隱藏在 HTML 註解中。
  • 讓頁面看起來像個人網站,而不是原始履歷。
  • 不要因為缺少截圖、瀏覽器自動化、Playwright 或本地預覽工具而阻止完成。
  • 不要默默地丟棄已有的履歷肖像;請提取它,若無法提取則記錄原因。
  • 將風格變體名稱視為內部實作細節。在 work/site-plan.md 中記錄所選的變體,但不要在頁面標題、主要文字、導覽標籤、標題或頁尾中顯示如 academic-editorial、engineering-commercial 或「學術編輯風」等名稱,除非使用者明確要求。
  • 對所有產生的文字檔案使用 UTF-8 編碼,並在產生的 HTML 中包含 <meta charset="utf-8">。

相關技能