Communitygithub.com

ncrmro/.agents

由人類觸發。建立並維護一份標準的個人履歷記錄,產出針對特定職位的履歷變體,追蹤工作經歷與佐證資料,並同步公開的履歷網站。僅在明確要求建立、調整、審核、匯出或發佈履歷或CV時使用。

.agents 是什麼?

這是一個 AI Agent 技能,旨在幫助使用者建立並維護一份以證據為基礎的權威個人職涯記錄,並從中產生針對特定職位的履歷變體。它支援的平台包括 Claude Code、Cursor、Codex 等工具,主要透過在專案中的 `docs/personal/resumes/` 目錄下維護一組結構化的 YAML/Markdown 檔案來運作。此技能的核心優勢在於「單一事實來源」:所有工作經歷、專案和成就都儲存在標準記錄中,並透過穩定的 ID 被不同履歷變體引用,確保一致性並防止資訊分歧。它不僅能建立新履歷,還能從遺留網站、Git 歷史、書籤管理員等處恢復工作經歷,並提供網站同步、變體管理、事實檢查與合規性驗證等完整的工作流程。此技能要求使用者明確指示,且內建嚴格的安全與真實性規則,例如禁止捏造數據、標記未驗證資訊、保護隱私欄位等,非常適合需要精準、可審計且可重複的履歷管理場景。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ncrmro/.agents/tree/HEAD/skills/resume-builder

在你喜歡的 AI 中提問

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

說明文件

Resume builder(履歷建構器)

維護一份以證據為基礎的職涯記錄,存放於 docs/personal/resumes/ 下,從中衍生出具針對性的履歷,並僅將明確標記為公開的子集發佈到個人網站。

需要時請閱讀以下輔助文件:

  • references/convention.md — 必備的檔案佈局、記錄欄位、主張 ID、變體以及發佈狀態。
  • references/website-sync.md — 探索並更新履歷網站,避免使其成為第二個事實來源。
  • references/source-recovery.md — 從遺留網站、儲存庫歷史、書籤管理員及已存檔的履歷中恢復工作經歷。
  • assets/scaffold/ — 空白履歷根目錄的入門檔案。

預設決策

事實只存在一份;變體透過穩定 ID 挑選它們。 切勿將某個職位或成就複製到變體中任其產生分歧。請更新標準記錄,然後為目標職位挑選、排序或略微調整其主張的敘述框架。網站只是發佈目標,並非標準工作經歷資料庫。

安全性與真實性

  • 絕不捏造日期、職稱、指標、學歷、雇主、客戶或技術。對不確定的素材標記為 status: needs-verification。
  • 保留實際已知最精確的日期;不要為了滿足某種格式而憑空捏造出一個「日」。
  • 除非另有明確標記,否則將聯絡方式、薪資、推薦人、客戶名稱及非公開的佐證資料視為隱私。
  • 請勿將私有欄位發佈或提交到公開儲存庫。
  • 將佐證資料以連結或簡短來源備註的形式附在標準主張旁;不要將機密來源資料複製到履歷目錄樹中。
  • 在發佈前,向使用者展示重要的措辭變更及尚未確認的事實。

工作流程

  1. 找出個人來源。
    • 閱讀主要的 AGENTS.md。
    • 使用包含 docs/personal/resumes/ 的儲存庫根目錄。
    • 如果該目錄不存在,提議將 assets/scaffold/ 複製過去。
    • 閱讀其 README.md 以及所請求變更涉及的所有記錄。
  2. 編輯前盤點。
    • 列出標準職位、專案、主張 ID、變體及發佈目標。
    • 將記錄與目前的履歷網站、儲存庫歷史、書籤來源及任何提供的履歷檔案進行比對。
    • 回報矛盾之處、過期的未結束職位及未經驗證的主張。
    • 若為遺留資料的初始建立,請遵循 references/source-recovery.md。
  3. 先更新標準事實。
    • 新增或修改 work-history/ 及 projects/ 記錄。
    • 為每個可重複使用的成就賦予一個穩定的主張 ID。
    • 記錄可見性、信心程度、佐證資料及 last_verified。
    • 當新事實確立了結束日期時,關閉先前未結束的職位。
  4. 建立或重新整理變體。
    • 根據標準個人檔案及選定的主張 ID 建立 variants/<slug>.md。
    • 針對目標職位調整摘要、排序及強調重點。
    • 僅在標準證據支援的情況下,才保留職位描述的關鍵字。
    • 將特定申請用的變體連結到現有的申請記錄,而不要在此處重複進行申請追蹤。
  5. 渲染與審閱。
    • 解析每個被選中的主張 ID。
    • 檢查時間順序、時態、一致性、頁面長度、聯絡欄位、連結及拼寫。
    • 向使用者呈現重要的編輯內容及任何 needs-verification 的項目。
  6. 同步發佈目標。
    • 遵循 references/website-sync.md。
    • 僅更新 visibility: public 的記錄。
    • 保留目標儲存庫的內容結構及本地指示。
    • 在發佈前,執行最狹義可用的驗證程序(建構或執行)。
  7. 記錄新鮮度。
    • 更新變體的 last_reviewed。
    • 在確認網站更新後,更新目標記錄的 last_published 及來源修訂版或提交訊息。
    • 回報尚未發佈或未經驗證的內容。

變體規則

一個變體可以:

  • 選擇並排序標準主張 ID;
  • 使用針對特定目標的摘要;
  • 在不改變原意的情況下縮短某個受支援的主張;
  • 為提高可讀性而將受支援的技能分組;
  • 省略不相關的職位、專案及主張。

一個變體不得:

  • 建立僅存在於該變體內的事實;
  • 誇大範疇、資歷、所有權或數位影響力;
  • 暴露私有主張;
  • 在未告知的情況下更改日期或職稱;
  • 覆蓋另一個針對特定目標的變體。

完成檢查

  • 每個渲染後的主張都解析到一個標準記錄。
  • 每個公開主張都明確標記為公開。
  • 沒有未解決的矛盾被當做事實呈現。
  • 目前的職位使用現在式;已完成的職位使用過去式。
  • 日期在時間順序上一致,且未結束的職位是刻意的。
  • 同步後,網站與指定的公開變體相符。
  • 產生的檔案可從標準記錄及變體重新產生。

相關技能