Remote Job Hunter

自动化远程职位搜索工具。支持从多个来源抓取职位信息，基于用户个人资料进行匹配，验证职位链接是否仍有效，并通过电子邮件或控制台输出报告。

适用场景

当用户出现以下情况时，调用本技能：

• 请求搜索远程职位或工作机会
• 希望根据其简历/技能查找匹配的职位
• 要求设置每日职位搜索或职位提醒服务
• 使用了诸如“job hunt”、“find remote jobs”、“search jobs”、“job alert”、“remote work”等关键词

快捷命令

本技能提供以下入口点，供 Agent 直接调用：

1. 即时职位搜索（立即运行，结果输出至控制台）

python3 run_now.py --dry-run

执行完整流程（搜索 → 匹配 → 验证），并将结果打印至控制台，不发送邮件。适用于用户希望立即查看职位结果的场景。

2. 完整流程 + 邮件报告

python3 daily_scheduler.py

执行完整流程，若发现匹配职位则自动发送邮件报告。适用于定时每日运行场景。

3. 初始化 / 重新配置

python3 setup.py

交互式配置流程。当 config.json 缺失，或用户希望修改配置项时使用。

4. 模板快速配置（非交互式）

python3 setup.py --quick --name "User Name" --title "Job Title" --email "user@example.com"

无需交互提示，直接生成 config.json。适用于用户已在命令行中提供全部必要信息的场景。

Agent 使用指南

若用户说“帮我搜一下远程工作”或“find me remote jobs”：

1. 检查 config.json 是否存在；若不存在，向用户索取：姓名、期望职位名称、邮箱地址。
2. 执行：python3 run_now.py --dry-run
3. 将输出结果中的 Top 匹配职位展示给用户。

若用户说“set up daily job alerts”或“每天帮我找”：

1. 确保 config.json 已存在（如缺失，请先运行 setup.py）。
2. 先执行一次：python3 daily_scheduler.py 进行测试。
3. 协助用户配置 cron 或 TRAE 自动化任务，实现每日定时运行。

若用户希望修改关键词、技能或筛选条件：

• 可直接编辑 config.json 文件 —— 它是标准 JSON 格式，无需重新运行 setup。
• 需关注的关键字段包括：
  • search.keywords —— 职位搜索关键词
  • profile.skills —— 用于匹配的个人技能列表
  • search.location_filter —— 地域偏好设置
  • email.* —— 报告邮件的接收地址与 SMTP 设置

配置说明

config.json 控制全部行为。核心配置节如下：

地域过滤模式

• "all" —— 不做地域过滤，显示全部远程职位
• "exclude_only" —— 仅排除匹配“排除关键词”的职位
• "include_global" —— 优先展示符合“首选地域”的职位，并排除不希望看到的地区

文件结构

remote-job-hunter/
├── SKILL.md              # Agent 指令文档（即本文档）
├── run_now.py            # 即时搜索入口（面向 Agent 友好）
├── daily_scheduler.py    # 完整流程 + 邮件报告
├── setup.py              # 交互式或快速初始化脚本
├── config.json           # 用户配置文件（自动生成）
├── config.template.json  # 配置模板文件
├── scripts/
│   ├── search_jobs.py    # 多源职位搜索
│   ├── match_jobs.py     # 简历与职位匹配打分
│   ├── verify_jobs.py    # 职位链接有效性验证
│   └── send_email.py     # 邮件报告发送
└── README.md             # 面向人类用户的说明文档

故障排查

未找到 config.json：运行 python3 setup.py 或带参数的 python3 setup.py --quick 命令完成初始化。

未搜索到任何职位：检查 config.json 中的 search.keywords 字段；可尝试将 location_filter.mode 设为 "all" 以放宽地域限制。

未收到邮件：检查垃圾邮件文件夹；确认 config.json 中 SMTP 凭据配置正确。

SMTP / Gmail App Password：请前往 https://myaccount.google.com/apppasswords 生成。

许可证: MIT-0