MadsLorentzen/ai-job-search

AI Job Search – 由 AI 驅動的求職申請助手

是什麼 – 一個命令列框架，讓您在自己的電腦上執行完整的求職流程，使用 Claude Code（Anthropic 的程式助理模型）作為推理引擎。輸入個人資料後，該工具可執行以下動作：

1. 抓取 一組求職網站（目前包含丹麥門戶、LinkedIn 和 freehire.me），並根據結構化適配評分標準對職缺進行排序。
2. 申請 選定的職缺：模型評估適配度，起草 LaTeX 簡歷與求職信，啟動審查代理對草稿進行批判，反覆迭代直至 PDF 符合嚴格的排版規則，並執行 ATS 可讀性檢查。
3. 準備面試 透過模擬面試流程，提取公司資訊，將可能問題對應至您的 STAR 範例，並生成準備包。
4. 追蹤結果 – 記錄面試階段、錄用、拒絕，並自動起草禮貌的追蹤信件。
5. 同步 將流程同步至 Notion 或 Gmail，產生離線 HTML 面板，甚至根據識別出的技能差距建議進修計畫。

為何重要 – 多數 AI 驅動的履歷工具僅是單次生成器。本專案將整個端對端工作流程（搜尋 → 適配評估 → 起草 → 審查 → ATS 驗證 → 結果追蹤）打包為可重現的 CLI 命令，並強調 可驗證的輸出（PDF 編譯檢查，無虛構主張）。

---

快速入門概覽（來自 README）

1. 分叉並克隆 倉庫 – 若不想讓個人資料出現在公開倉庫中，請保持私有分叉。
2. 安裝求職工具（基於 Bun 的 CLI 抓取器）以支援您關心的每個門戶。
3. 在 Claude Code 中執行 /setup 以匯入您的履歷、LinkedIn 導出檔、學位證明等，或回答面試風格問卷。這將建立後續所有命令使用的結構化 CLAUDE.md 個人資料。
4. 使用 /scrape 搜尋。該命令查詢內建門戶，去重後返回依適配度評分排序的清單。
5. 使用 /apply <job‑url>（或貼上完整描述）申請。系統將：
   • 解析職缺內容，
   • 評分適配度，
   • 起草 LaTeX 簡歷 + 求職信，
   • 執行審查代理，
   • 反覆迭代直至 PDF 清晰（2 頁簡歷，1 頁求職信），
   • 執行 ATS 文字提取檢查，
   • 並呈現最終文件與檢查清單。
6. 可選功能 – /interview 用於模擬面試，/outcome 用於記錄結果，/rank 用於批量評分抓取的職缺，/upskill 用於學習計畫建議，/html-report 用於本地儀表板，/notion-sync 和 /gmail-sync 用於即時視圖。

---

核心元件（檔案樹亮點）

• .claude/commands/ – 每個 CLI 命令（apply.md、setup.md、interview.md 等）的 Markdown 定義，Claude Code 讀取以執行工作流程。
• .claude/skills/ – 提示詞程式庫：
  • job-application-assistant/ 包含候選人資料架構、寫作風格指南、評分基準與 LaTeX 模板規格。
  • job-scraper/ 協調門戶查詢。
  • upskill/ 執行技能差距分析。
• .agents/skills/ – 每個支援的求職網站的輕量級 Bun 基抓取器（例如 jobindex-search）。透過 bun install 安裝。
• cv/ 與 cover_letters/ – LaTeX 原始碼檔案（moderncv 模板，自訂 cover.cls）。框架會為每次申請即時編譯。
• documents/ – 您的個人資料（PDF 簡歷、LinkedIn 導出、學位證明、過往申請）。/setup 會自動讀取此資料夾。
• job_search_tracker.csv – 一個簡單的試算表，記錄每次申請、其狀態與適配度評分；由 /html-report 與同步命令使用。
• 實用腳本（salary_lookup.py、各種 tools/*.py）– 用於薪資基準、CI 語法檢查、PDF 驗證與安全檢查的輔助工具。

---

前置條件（如所列）

• Claude Code CLI（唯一支援的 LLM 工具；其他代理可透過 AGENTS.md 實現）。
• Python 3.10+。
• Bun（用於門戶抓取 CLI）。
• 完整的 LaTeX 發行版，包含 lualatex（用於簡歷）與 xelatex（用於求職信）。TinyTeX 可用，但需在 SETUP.md 中加入額外套件。
• 可選：pypdf（或系統 poppler 工具）用於 ATS 文字提取步驟。

---

適合誰使用

• 已使用 Claude Code 的求職者，希望獲得可重現、本地執行的流程，而非網路服務。
• 熟悉 CLI 工具的開發者，希望自訂抓取技能或 LaTeX 模板。
• 尋找透明、可審計、從不虛構經驗的 AI 助手的人。

---

限制與警告（來自 README）

• 工作流程 不沙盒化 抓取的職缺頁面；在送出任何申請前，應先瀏覽取得的內容。
• 個人資料資料寫入受追蹤的檔案；若不想公開資訊，請保持您的分叉為私有。
• 目前的門戶抓取器針對丹麥市場優化；更換新網站需透過 /add-portal 建立新技能。
• 系統依賴 Claude Code；使用費用與速率限制由您的 Anthropic 帳戶管理。

---

總結

ai-job-search 是一個真正的開源專案，結合 LLM 提示、網頁抓取、LaTeX 文件生成與工作流程自動化，提供您一個自架設的 AI 求職申請助手。上述所有功能均直接來自倉庫的 README；未推斷任何額外功能。