Resume builder(履歷建構器)
維護一份以證據為基礎的職涯記錄,存放於 docs/personal/resumes/ 下,從中衍生出具針對性的履歷,並僅將明確標記為公開的子集發佈到個人網站。
需要時請閱讀以下輔助文件:
references/convention.md— 必備的檔案佈局、記錄欄位、主張 ID、變體以及發佈狀態。references/website-sync.md— 探索並更新履歷網站,避免使其成為第二個事實來源。references/source-recovery.md— 從遺留網站、儲存庫歷史、書籤管理員及已存檔的履歷中恢復工作經歷。assets/scaffold/— 空白履歷根目錄的入門檔案。
預設決策
事實只存在一份;變體透過穩定 ID 挑選它們。 切勿將某個職位或成就複製到變體中任其產生分歧。請更新標準記錄,然後為目標職位挑選、排序或略微調整其主張的敘述框架。網站只是發佈目標,並非標準工作經歷資料庫。
安全性與真實性
- 絕不捏造日期、職稱、指標、學歷、雇主、客戶或技術。對不確定的素材標記為
status: needs-verification。 - 保留實際已知最精確的日期;不要為了滿足某種格式而憑空捏造出一個「日」。
- 除非另有明確標記,否則將聯絡方式、薪資、推薦人、客戶名稱及非公開的佐證資料視為隱私。
- 請勿將私有欄位發佈或提交到公開儲存庫。
- 將佐證資料以連結或簡短來源備註的形式附在標準主張旁;不要將機密來源資料複製到履歷目錄樹中。
- 在發佈前,向使用者展示重要的措辭變更及尚未確認的事實。
工作流程
- 找出個人來源。
- 閱讀主要的
AGENTS.md。 - 使用包含
docs/personal/resumes/的儲存庫根目錄。 - 如果該目錄不存在,提議將
assets/scaffold/複製過去。 - 閱讀其
README.md以及所請求變更涉及的所有記錄。
- 閱讀主要的
- 編輯前盤點。
- 列出標準職位、專案、主張 ID、變體及發佈目標。
- 將記錄與目前的履歷網站、儲存庫歷史、書籤來源及任何提供的履歷檔案進行比對。
- 回報矛盾之處、過期的未結束職位及未經驗證的主張。
- 若為遺留資料的初始建立,請遵循
references/source-recovery.md。
- 先更新標準事實。
- 新增或修改
work-history/及projects/記錄。 - 為每個可重複使用的成就賦予一個穩定的主張 ID。
- 記錄可見性、信心程度、佐證資料及
last_verified。 - 當新事實確立了結束日期時,關閉先前未結束的職位。
- 新增或修改
- 建立或重新整理變體。
- 根據標準個人檔案及選定的主張 ID 建立
variants/<slug>.md。 - 針對目標職位調整摘要、排序及強調重點。
- 僅在標準證據支援的情況下,才保留職位描述的關鍵字。
- 將特定申請用的變體連結到現有的申請記錄,而不要在此處重複進行申請追蹤。
- 根據標準個人檔案及選定的主張 ID 建立
- 渲染與審閱。
- 解析每個被選中的主張 ID。
- 檢查時間順序、時態、一致性、頁面長度、聯絡欄位、連結及拼寫。
- 向使用者呈現重要的編輯內容及任何
needs-verification的項目。
- 同步發佈目標。
- 遵循
references/website-sync.md。 - 僅更新
visibility: public的記錄。 - 保留目標儲存庫的內容結構及本地指示。
- 在發佈前,執行最狹義可用的驗證程序(建構或執行)。
- 遵循
- 記錄新鮮度。
- 更新變體的
last_reviewed。 - 在確認網站更新後,更新目標記錄的
last_published及來源修訂版或提交訊息。 - 回報尚未發佈或未經驗證的內容。
- 更新變體的
變體規則
一個變體可以:
- 選擇並排序標準主張 ID;
- 使用針對特定目標的摘要;
- 在不改變原意的情況下縮短某個受支援的主張;
- 為提高可讀性而將受支援的技能分組;
- 省略不相關的職位、專案及主張。
一個變體不得:
- 建立僅存在於該變體內的事實;
- 誇大範疇、資歷、所有權或數位影響力;
- 暴露私有主張;
- 在未告知的情況下更改日期或職稱;
- 覆蓋另一個針對特定目標的變體。
完成檢查
- 每個渲染後的主張都解析到一個標準記錄。
- 每個公開主張都明確標記為公開。
- 沒有未解決的矛盾被當做事實呈現。
- 目前的職位使用現在式;已完成的職位使用過去式。
- 日期在時間順序上一致,且未結束的職位是刻意的。
- 同步後,網站與指定的公開變體相符。
- 產生的檔案可從標準記錄及變體重新產生。