MadsLorentzen/ai-job-search

AI Job Search – 由 AI 驱动的求职申请助手

是什么 – 一个命令行框架，允许您在自己的机器上运行完整的求职流程，使用 Claude Code（Anthropic 的代码助手模型）作为推理引擎。输入个人资料后，该工具可以：

1. 抓取 一组求职网站（目前包括丹麦门户、LinkedIn 和 freehire.me），并根据结构化匹配评分标准对职位进行排序。
2. 申请 选定的职位：模型评估匹配度，起草 LaTeX CV 和求职信，启动评审代理对草稿进行批评，迭代直至 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 CV + 求职信，
   • 运行评审代理，
   • 迭代直到 PDF 清晰（2 页 CV，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（用于 CV）和 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；未推断任何额外功能。