ai-job-search 是一个运行在本地机器上的求职申请框架，基于 Claude Code 构建。据项目说明，它把 Claude Code 变成一位全流程求职申请助手：评估职位匹配度、定制简历、撰写求职信，并帮助准备面试。项目作者为地球物理学出身，2025 年末岗位被裁后构建了该框架用于自己的求职，据其自述使用 /scrape、/apply 和 /interview 工作流每周运行，最终完成 69 份定制申请、获得 20 次首轮面试，并于 2026 年 6 月入职 AI 工程师岗位。作者声明该项目为独立开源项目，与 Anthropic 无隶属、背书、赞助或维护关系；同时声明没有任何关联的加密货币、代币或付费赞助计划，唯一支持方式是 Ko-fi 和 GitHub 贡献。
一、用途与核心工作流 该框架面向求职申请场景。核心工作流包括自我画像（self-profiling）、匹配评估（fit evaluation）以及“起草-审核”申请流水线，据称与语言和国家无关。职位门户搜索技能目前针对丹麦市场（Jobindex、Jobnet、Akademikernes Jobbank 等），但该模式设计为可替换为用户本地的招聘网站。三条核心命令为 /setup、/scrape、/apply。
二、主要能力
- 资料设置：/setup 提供三种路径——读取已填充的 documents/ 文件夹（简历 PDF、LinkedIn 导出、文凭、推荐信、过往申请）、导入在聊天中粘贴的单份简历，或通过访谈完成设置；会自动检测已有内容并询问。文档文件夹模式为幂等操作，可随材料增加安全重跑。
- 职位搜索：/scrape 在多个职位门户搜索与个人资料匹配的职位，去重并按匹配度排序。可选择某个匹配直接运行 /apply，或先用 /rank 批量打分获得排序候选清单。
- 申请流程：/apply 运行完整流水线——解析职位信息（URL 或文本）、对照个人资料评估匹配度（技能、经验、文化、地点、职业契合度）、以 LaTeX 起草定制简历和求职信、启动审核代理研究公司并批评草稿、根据反馈修订、编译并检查两份 PDF（简历用 lualatex，求职信用 xelatex）、进行 ATS 检查、最后附验证清单展示最终输出。
- PDF 验证循环：/apply 会编译并目视检查每个 PDF，应用针对性修复（\needspace、\enlargethispage、列表项字体匹配包装等），直到简历正好 2 页且无孤立的条目标题、求职信正好 1 页且签名可见、字体一致。
- ATS 验证：提取编译后简历的文本层（pdftotext），按 ATS 解析器视角验证联系方式是否为字面文本、有无乱码、阅读顺序是否正常，并对职位关键词覆盖率打分。诚实规则：个人资料不支持的关键词会被承认为缺口，绝不堆砌。
- 相关性加权的简历裁剪：当简历超过 2 页时，按与目标职位的相关性、文档中的独特性、求职信是否依赖该内容三项评分，优先裁掉总分最低的行。
- 起草-审核分离：起草者写作，第二个 Claude 代理以全新上下文研究公司并批评草稿，然后起草者修订，以捕捉遗漏关键词、弱框架和泛化语言。
- 扩展命令：共 13 条命令。除核心三条外，还有 /interview（为已安排面试构建分阶段准备包、研究公司和面试官、映射可能问题到 STAR 案例、提供模拟面试）、/outcome（记录申请结果、归档材料、更新跟踪表、/outcome followup 跟进沉默申请、起草感谢信）、/notion-sync（通过官方 Notion MCP 服务器单向只读同步管线到 Notion 数据库）、/gmail-sync（通过 Gmail 连接器读取状态信号并批量提议）、/rank（批量打分排序）、/expand（扫描个人资料中已链接的公开来源丰富画像）、/upskill（分析技能缺口并生成学习计划）、/html-report（生成离线 HTML 仪表板）、/add-template（注册自有简历或求职信模板）、/add-portal（为本地招聘网站生成搜索技能）、/reset。
三、使用方式
- Fork 并克隆仓库。注意：公开仓库的 fork 始终是公开的，且 /setup 会把个人数据写入被跟踪的文件；如仅用于自己求职，建议使用以本仓库为 upstream 的私有仓库，SETUP.md 第 8 节有说明。
- 安装求职搜索工具（Bash / zsh / Git Bash 命令，资料中具体命令因格式截断暂未完整提供）。linkedin-search 和 freehire-search 的安装是可选的：两者零运行时依赖，用普通 bun 即可运行；bun install 仅拉取 TypeScript 开发类型。
- 运行 /setup 设置个人资料。
- 运行 /scrape 搜索职位。
- 运行 /apply 申请职位；若 URL 无法抓取（部分门户阻止自动访问），可直接粘贴职位描述。
四、依赖要求 Claude Code（CLI），无免费层，需要 Claude Pro/Max/Team 订阅或 Anthropic API 额度；使用其他代理工具（Codex、Antigravity、Gemini CLI）可从 AGENTS.md 开始，门户搜索技能可开箱即用，社区 fork 适配完整工作流。Bun（用于求职搜索 CLI 工具）。带 lualatex 和 xelatex 的 LaTeX 发行版（TeX Live、MacTeX、TinyTeX 或 MiKTeX）；简历用 lualatex 编译（pdflatex 在现代 MiKTeX 上常因 fontawesome5 字体扩展错误失败），求职信用 xelatex 编译（cover.cls 需要 fontspec）；如用 TinyTeX 或 BasicTeX 等最小安装，需按 SETUP.md 安装额外包。可选：pip install pypdf 用于 /apply 的 ATS 可解析性检查；Poppler pdftotext 作为后备；两者都缺失时检查降级为视觉关键词审查。
五、适用场景与限制 适用场景包括：自动化求职申请全流程、批量评估职位匹配度、定制简历与求职信、准备面试、分析技能缺口做职业规划。限制包括：核心工作流语言和国家无关，但职位门户搜索技能目前仅针对丹麦市场；使用 Claude Code 需要付费订阅或 API 额度；需具备 LaTeX 环境；职位信息被视为不可信输入，工作流不遵循其中嵌入的指令也不从其正文抓取链接，但代理防御是指令级的而非沙箱，在不熟悉的招聘网站上发送前应检查抓取和写入的内容（细节见 SECURITY.md）；系统不编造技能或经验，所有简历和求职信中的声明都对照真实个人资料验证；模板、编译命令等自定义细节需参考 SETUP.md。
