履歷作品集
使用 Resume Studio 儲存庫中的範本為使用者建立作品集。網站已完整建置，此技能的工作僅是將事實填入。與其重新設計版面，不如花時間精準填寫 content/profile.json。
若當前資料夾中有 gallery/ 與 templates/，則此處即為 Resume Studio。若無，請詢問使用者位置，若尚未下載則引導執行 git clone https://github.com/roadkwonai/resume-studio.git 後再執行 npm install。以下所有路徑皆以此資料夾為基準。
1. 收集資料與選擇範本
這兩項為使用者需自行完成的工作，因此一次詢問即可。
開啟圖庫。 在背景執行 npm run studio（首次執行需花費數分鐘進行建置）。當 http://localhost:4100 回應時，在瀏覽器中開啟。若使用者已指定範本，則可跳過圖庫。
在單一訊息中請求。
- 履歷檔案路徑或貼上內容
- 要求從圖庫中選擇範本（畫面中的「選擇此範本」按鈕會記錄至
selection.json） - 若有：應徵職位、網站語言（韓文/英文）、個人照片、專案圖片、GitHub 等連結
對於猶豫不決的使用者，根據資料量進行推薦。推薦依據請參閱 references/templates.md。
若使用者表示已在圖庫中選擇，請讀取 selection.json 確認。該檔案僅記錄最後一次點擊，可能為舊值。若使用者已說出範本名稱，則以其所說為準。
2. 撰寫 profile.json
讀取 references/profile-guide.md 與所選範本的 templates/<id>/content/README.md，然後在暫存區撰寫 profile.json。規格請參考 shared/profile.ts。
不得撰寫無來源的內容。 作品集是招聘人員會視為事實的文件。若加入不存在的數據、評價或期間，使用者可能在面試中陷入困境，甚至構成經歷造假。空白項目會自動從畫面中消失，因此留空總是安全的。潤飾句子是可以的，但不能增加事實。例如，將「支付系統開發」改寫為「開發了支付系統」是可以的，但改寫為「數百萬用戶的支付系統」則不行。
僅移轉可公開的內容。 履歷是提交給公司的非公開文件，而網站則人人可見。請勿移轉身分證字號、住址、出生日期、家庭狀況、兵役細節、薪資。電話號碼僅在使用者同意公開時才加入。
若資料來源有兩個以上或內容繁雜，請閱讀 references/sources.md。該文件提供了當資料間值不一致時以及如何篩選的準則。
撰寫完成後，使用 npm run validate -- <檔案> 檢查格式。
3. 建立作品集
npm run new -- <template-id> <slug> <profile.json 路徑>
若使用者已指定範本，則使用其 id；僅在遵循圖庫選擇時，於 <template-id> 位置填入 selected。slug 以使用者姓名的英文小寫決定（例如：hong-gildong）。接著：
- 將照片、圖片、履歷 PDF 複製到
portfolios/<slug>/public/profile/。注意是複製而非移動原始檔案。 - 在 profile.json 中將圖片路徑寫為
/profile/檔案名稱。 - 若要讓使用者下載履歷 PDF，則設定
basics.resumeFile，這樣整個 PDF 便會公開。使用pdftotext確認 PDF 中是否仍留有已從網站中移除的電話號碼或地址，若有，務必在報告中記錄。請勿自行修改檔案。 - 讀取
content/site.ko.json中的固定文案。若其中有「開源貢獻活動」這類不適合該使用者的陳述，請根據事實進行修正。 - 若想更改文案，也請修改
content/site.ko.json。請勿修改元件。僅在確實需要規格中沒有的表達方式時，才修改元件並通知使用者。
4. 驗證
npm run verify -- <slug>
此命令會一次檢查格式、生產建置以及範本演示人物的遺留痕跡。通過後，在背景執行 npm run start -w @resume/portfolio-<slug> 並實際查看 1440px 與 390px 的畫面。若重新建置過，必須先關閉舊伺服器。舊伺服器無法正確提供新建置內容，會導致 500 錯誤。需檢查的地方包括：長公司名或專案名的換行、水平溢出、空白區域、照片位置、因自動轉為大寫而變得奇怪的名稱（例如 SaaS 變成 SAAS）。若內容過長導致版面破損，請在修改範本前先縮短該段文案（但保留事實）。
最後，將 profile.json 中的數值與專有名詞再次與履歷原文比對。
5. 交付
通知使用者。
- 執行位址與作品集路徑
- 因缺乏資料而消失的區塊，以及建議補充的順序
- 此範本未顯示的項目。各範本的
content/README.md中有記載。例如，若範本不顯示學歷，務必告知 - 從履歷中刻意移除的個人資訊，以及在下載的 PDF 中仍存在的個人資訊
- 資料間不一致的值與所選的值，以及篩選時刪除的專案
- 潤飾過程中表達方式改變且需要使用者確認的句子
部署屬於公開行為，僅在使用者要求時才執行。作品集資料夾本身為獨立應用程式，可直接部署。
portfolios/、PDF 與 selection.json 已列入 .gitignore，因此不會提交至 Resume Studio 儲存庫。若必須將使用者的履歷、照片、聯絡方式上傳至公開儲存庫，需先顯示即將上傳的檔案清單並取得確認。
當為修改請求時
若為已建立的作品集，只需修改 portfolios/<slug>/content/profile.json 並重新執行步驟 4。
若要更換範本，請使用相同的 profile.json 建立新的 slug。因格式相同，無需重新撰寫內容。在使用者要求前，請勿刪除舊資料夾。