# Job Matcher

> 根据用户简历(CV)和求职意向，抽取CV结构化字段、实时检索匹配职位、生成可交互HTML报告。当用户提供简历文件(pdf/docx/txt/md)或粘贴简历文本，并希望找工作、匹配职位、获取职位推荐、做求职匹配时使用。

- Skill: `sangowu/job-matcher` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add sangowu/job-matcher`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sangowu/job-matcher/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: sangowu (https://skillmd.com/u/sangowu)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/sangowu/job-matcher

---


# Job Matcher

把简历(CV) + 求职意向 变成一份匹配职位的可交互 HTML 报告。

**执行方式：先读 [`WORKFLOW.md`](WORKFLOW.md)，按它的 0–7 步流程做。** WORKFLOW.md 是 agent-中立的单一事实源，包含：所需能力、如何映射到你当前运行时的工具、脚本调用契约、缺能力时的降级策略。本文件兼容 Claude Code 与 Codex 的 skill 机制（同样的 `name`/`description` + `scripts/`、`references/`、`assets/` 结构）。

## 执行要点（任何 agent 通用）

把流程里的三种能力映射到**你自己运行时的工具**：

| 能力 | 必需性 | 各 agent 对应 | 缺失时 |
|------|:---:|------|------|
| **web 搜索** | 必需 | Claude: `WebSearch`；Codex: 内置 web 搜索 | 无法做职位检索 |
| **子代理**（并行+隔离） | 可选 | Claude: `Task`/`Agent`（单消息内并行 spawn）；Codex: custom agents | **降级为串行** |
| **网页抓取** | 可选 | Claude: `WebFetch` | **回退** `scripts/fetch_rendered.py` |

- CV 抽取 / 搜索 / 打分这类重活交给子代理（若有）；委派时只回传「**摘要 + 文件路径**」，CV 全文 / 搜索原始结果 / JD 全文 **留在子代理或文件**，保持主上下文整洁。无子代理则你自己串行做，但仍坚持"大文本写文件、上下文只留摘要"。
- 搜索每条 query 恰好 1 次 web 搜索，计入 `config.json` 的 `max_websearch_calls`；并行度受 `max_parallel_subagents` 约束。
- 每批 Web 候选交给 `ats_pipeline.py discover` 识别官方 ATS board；仅当 `ats_enabled` 为 true 时同步已验证/到期 board。ATS 使用独立请求预算，返回候选仍由主 agent 串行交给同一个 `merge_jobs.py`。
- 搜索与职位评估可以并行执行，但 worker 只返回结果；`jobs_table.json` 的 `merge/update` 必须由主 agent 串行提交。按 `WORKFLOW.md` 使用 `eval_run` 快照和 `run_id`，不要让 worker 直接写共享主表。
- **批间重叠**：第 N 批 `merge` 拿到 `eval_run` 后，在同一条消息里并行 spawn「第 N 批评估 worker + 第 N+1 批搜索 worker」（Claude 的 Task/Agent 支持单消息并行）；`max_parallel_subagents` 是搜索+评估共用的全局预算，重叠期建议 1 搜 + 2 评。
- `merge/update` 会写入 PII-safe 运行指标；若返回 `metrics_recorded:false`，应告知用户。健康汇总使用 `scripts/summarize_metrics.py`。
- 每次启动先运行 `scripts/version_check.py`。只在 `different`、`version_different` 或 `local_modified` 时简短提醒；`unknown` 不阻断流程。检查器只读且有 24 小时缓存，绝不能自行 `git pull` 或覆盖本地文件。
- 子代理创建前用 `scripts/subagent_metrics.py profile` 解析角色模型/effort；创建后记录实际生效配置、耗时、成功率所需计数与 fallback。运行时不支持覆盖时继承当前模型并如实标记，不得伪报。
- 可选远程隔离浏览器只作为最终抓取兜底：先通过 `scripts/browser_setup.py` 配置 Kernel BYOK，再由 browser 子代理使用 `scripts/browser_control.py` 视觉操作。单站翻页串行、不同网站可并行；验证码/登录/限流只做人工接管或降级。
- 缺目标职位 / 地点完全缺失 → 停下追问用户。

## 其余

脚本契约、容错阶梯、护栏、配置、降级 —— 全部见 [`WORKFLOW.md`](WORKFLOW.md)。
指令文档在 `references/`，完整流程见 [`WORKFLOW.md`](WORKFLOW.md)。