1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | JobHuntBot |
| 作者/维护者 | DanielPan12（GitHub 个人开发者） |
| 来源链接 | https://github.com/DanielPan12/JobHuntBot |
| 许可证 | MIT（数据来自仓库 LICENSE 文件；同时保留原始项目 ApplyPilot 作者 Yvonne He 的版权声明） |
| GitHub Stars | 502（数据来自 GitHub API） |
| Forks | 40（数据来自 GitHub API） |
| 最新版本 | 未使用 Git Tags/Releases，以最近一次提交为准（2026-08-08） |
| 安装方式 | git clone 到本地后，让编程 Agent 读取 SKILL.md 并按其中工作流执行 |
2. 功能介绍与亮点
JobHuntBot 把求职投递变成一套可重复的系统化工作流，核心信条是“追求真实、可追溯、能带来面试的投递，而非盲目海投”：
- 五大前置要素：正式开始投递前，要求先建好候选人档案、进度追踪看板、筛选规则、简历策略、安全边界五项基础设施，缺一项就先补齐，而不是让用户手填一堆表格。
- 逐公司调研留痕：每接触一家公司先在
job_pool建档，专门提示“实习已确认、全职未确认”这类常见陷阱，调研结论立即写回看板而非留在对话记忆里。 - 经历匹配作为显式确认点：投递前从经历库中挑选 2–4 段最贴合该岗位 JD 的经历，主动把选择理由展示给用户确认，而非静默决定。
- 提交前预览 + 显式确认：点击最终提交前必须展示公司、岗位、简历版本、所选经历等完整摘要，“用户明确说可以提交”之前不会点提交；提交后需看到真实确认证据（成功文案、确认页 URL 或候选 ID）才记为“已投递”。
- 本地进度看板：配套一个零依赖 Node.js 静态服务器 + 网页看板，按“已投递/待处理/已结束”三视图展示 CSV 数据，全程只读写本地文件，不经过任何外部服务器。
- 明确的安全边界：遇到验证码、登录/双重验证、支付提示、权限弹窗等一律停下转交用户，不做规避尝试；不篡改学历、工作授权、薪资等高风险事实。
3. 适用场景
固定分类：集成与工作流自动化。
适合正在系统性投递校招、社招、暑期实习、转行等岗位的求职者——尤其是希望用编程 Agent 驱动 LinkedIn Easy Apply、Greenhouse、Lever、Ashby、Workday 等多个 ATS 平台完成投递，同时保留可追溯的进度看板与筛选规则，而不是简单粗暴地群发简历的用户。
4. 跨 Agent 兼容性
- Claude Code：原生支持。README 给出专属安装命令（
claude mcp add playwright npx '@playwright/mcp@latest'）为其配上浏览器操作能力。 - Codex CLI：原生支持。README 明确列出并给出通用启用指引（查找对应的浏览器自动化/computer-use 能力并按其文档启用）。
- OpenClaw：需适配。项目定位为“任何能读文件、听懂指令的编程 Agent 均可用”，未见 OpenClaw 专属安装步骤或验证记录。
- Hermes Agent：未验证。抓取到的材料未提及。
仅做调研找岗位（不实际投递）时只需网页搜索能力，不依赖浏览器自动化；实际填表提交才需要上述浏览器工具。
5. 推荐理由
多数求职自动化工具止步于“填表即投”，容易滑向被招聘方判定为垃圾投递的批量海投。JobHuntBot 把研究、筛选、经历匹配、投递、复盘串成一条强制经过用户确认的链路，并用零依赖本地看板保留完整可追溯记录，适合希望“系统化投递但不失控”的求职者。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 502 stars（API 数据），落在 200–1k 区间上段；40 个 fork 显示有实际使用而非单纯点星；仓库约 3 周内积累这一热度，但未发现独立第三方媒体或社区讨论 |
| 可用性 | 8 | 需先完成候选人档案、筛选规则等少量配置，但配有完整分步初始化文档与全套模板；核心工作流零付费依赖；最近一次提交为 2026-08-08，维护尚属近期 |
| 安全性 | 9 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 仅本地看板配一个零依赖 Node.js 静态文件服务器（读写本地 CSV），实际浏览器操作由用户自行配置的浏览器工具（如 Playwright MCP）执行，权限范围清楚 |
| ② 运行时联网外发 | 看板服务器仅监听本地端口，不发起任何外部网络请求；未发现将候选人资料回传第三方服务器的行为 |
| ③ API key / 凭据 | 不需要任何 API key；明确禁止将简历、联系方式、证件等隐私信息提交进公开仓库 |
| ④ 可疑指令 | 未发现提示注入或隐藏指令；正文反复强调“不得编造经历/学历/工作授权”等诚实底线 |
| ⑤ 作者/组织信誉 | 独立开发者，公开声明本项目是对 Yvonne He 原始 ApplyPilot 项目的署名改编（LICENSE 文件同时保留双方版权声明），未见刷星等异常增长痕迹 |
| ⑥ License | MIT，条款明确 |
| ⑦ 最近维护时间 | 最近一次代码推送为 2026-08-08 |
综合评分 = 三项均值 ≈ 7.67。
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 与 JobHuntBot 的差异 |
|---|---|---|
| job-application-agent（vaibhavarora14） | Node.js CLI 驱动的求职投递工具，含 OS 级凭据存储、去重台账与自主投递档位 | 工程化程度更高，但默认开启遥测上报且安装脚本会建立开机自启的后台自动更新任务；JobHuntBot 完全本地运行、无遥测、无后台常驻进程 |
| get-job.skill（agentenatalie） | 覆盖岗位调研→改简历→面试准备的内容生成链路 | 止步于材料准备阶段，不驱动浏览器实际填表投递；JobHuntBot 额外覆盖真实 ATS 表单填写、提交与结果追踪 |
| ApplyPilot（yvonnehe772，原始项目） | JobHuntBot 改编所依据的原始工作流 | 发布后未见后续更新维护；JobHuntBot 在此基础上补充了完整安全边界文档、本地看板与分步初始化流程 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
仓库同时提供中英文双语 README；LICENSE 文件公开注明本项目是对 Yvonne He 开源项目 ApplyPilot 的署名改编。
10. 安装使用方式
git clone https://github.com/DanielPan12/JobHuntBot克隆后，在该目录下用编程 Agent 打开会话并说：
Use SKILL.md to initialize my job search workflow.Agent 会引导补齐候选人档案、目标岗位、简历策略等最小必要信息。若需实际操作浏览器完成表单填写与提交，需提前给 Agent 配好浏览器自动化工具（如 Claude Code 下的 Playwright MCP）；仅做岗位调研与看板追踪则不需要。看板通过 dashboard/start-dashboard.sh（macOS/Linux）或 start-dashboard.bat（Windows）启动，访问 http://localhost:8420/dashboard.html 查看。
11. 注意事项
- 不是“一键全自动海投”工具——最终提交前必须获得用户显式确认，遇到验证码、登录、双重验证、支付提示等会直接停下转交用户处理。
- 看板需通过其自带的本地服务器脚本打开，直接双击 HTML 文件会因浏览器限制无法读取 CSV 数据。
- OpenClaw、Hermes Agent 的适配情况未见明确验证材料。
- 填入真实个人信息后的工作副本不应公开发布或截图分享，仓库本身只提供空白模板。