職業作品集網站
根據三個輸入建立一個精美的單頁作品集:一份履歷、一張專業照片和一個 LinkedIn 個人檔案網址。設計是固定的且已完成(動畫網路背景、逐字顯示姓名、打字機效果的角色、堆疊的案例研究卡片、可點擊的技能以點亮職業時間軸、淺色與深色模式、行動裝置版面)。你的工作是內容:閱讀履歷,撰寫一個 content.json,然後執行建置腳本。
此技能包含的檔案:
assets/template.html:完成的設計;正常使用時請勿編輯scripts/build.py:將content.json和照片合併為一個 HTML 檔案references/content-schema.md:每個欄位、長度指南和圖示名稱examples/sample-content.json:一個完整的運作範例
1. 收集三個輸入
一次詢問,同時提出,針對缺少的部分:
- 履歷:任何格式(PDF、DOCX、純文字、貼上內容)。必填。
- 照片:光線充足、正面面對鏡頭的頭部特寫。可選;如果沒有照片,頭像會顯示他們姓名的縮寫。
- LinkedIn 網址:用於聯絡連結。
一開始不要要求其他東西。LinkedIn 頁面通常會封鎖自動讀取,因此請將該網址視為一個連結,而非資料來源;履歷才是事實來源。如果你能讀取個人檔案並增加一些事實,可以使用它們。
2. 閱讀履歷並找出人物形象
閱讀整份履歷。然後,在開始撰寫任何內容之前,決定統合的人物形象:一個能涵蓋此人所有主要角色的身份,而不僅僅是他們最新的職稱。例如:「客戶成功主管,負責設計入職流程、基於數據執行 CS 營運、並建立高投入度的團隊」,而不是「客戶成功主管」。人們通常不想要一個只關於某個角色的網站;他們想要的是整個職業生涯的脈絡。
挑選出:
- 他們帶來的 4–8 個身份(這些將成為打字機效果顯示的角色)
- 跨角色的不變主軸(成為領導力標題和支柱)
- 3–5 個有明確問題、行動和結果的故事(案例研究)
- 每個明確的數字(統計數據、指標、亮點)
- 工具、平台、認證、教育背景
3. 撰寫 content.json
遵循 references/content-schema.md;模仿 examples/sample-content.json 的結構。規則:
- 僅使用來自履歷的事實。 絕對不要捏造指標、雇主、日期、團隊規模或結果。如果案例研究沒有明確的結果,請定性地描述成果。僅在已有明確陳述的百分比時才使用指標。
- 第一人稱,平實且自信。 句子簡短,不要堆疊流行詞,不要使用「充滿熱情」、「以結果為導向」或「動態」這類詞。
- 尊重長度指南;過長的文字會破壞版面的節奏。
- 技能必須指向真實的角色 ID,並且每個技能應對應到履歷中顯示該技能的所有角色。
- 職業角色依時間從新到舊排序;將目前角色標記為
current: true。 - 除非使用者要求,否則將
contact.phone留空。
將其儲存為工作目錄中的 content.json。
4. 建置
python3 <skill-dir>/scripts/build.py --content content.json --photo <photo-path> --out portfolio.html
Pillow(pip install pillow)會裁切並壓縮照片;如果沒有安裝,照片會原樣嵌入。修正每個 ERROR;閱讀每個 WARNING 並修正它,除非是故意為之。
5. 檢查
如果你能開啟瀏覽器或截圖,請檢視桌機和手機寬度下的主視覺,滾動整個頁面一次,並切換深色模式。檢查照片裁切是否顯示臉部(調整 person.photoPosition),以及沒有文字超出邊界。否則,請根據長度指南重新閱讀 content.json。
6. 交付
- 如果你可以發佈一個檔案或網頁,請私下發佈
portfolio.html並提供連結給他們,解釋他們可以自行決定何時分享。 - 否則,直接將檔案傳送給他們。
然後簡短告訴他們:
- 你圍繞哪個人物形象建立了網站,以便他們可以調整方向
- 他們可以要求任何文案修改,你都會重新建置
- 如何分享它:發佈/分享檔案連結,或將單一檔案免費託管在 GitHub Pages 或 Netlify Drop,然後將連結加入他們 LinkedIn 個人檔案的「精選」區塊
編輯
對於文案修改,編輯 content.json 並重新建置;絕對不要手動編輯已產生的 HTML。設計修改(顏色、字型、區塊)請在 assets/template.html 中進行;保持 /*__PORTFOLIO_DATA__*/null、"/*__PHOTO__*/"、__TITLE__ 和 __DESCRIPTION__ 這幾個佔位符完整不變。