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