BOSS 直聘 · HR 智能体技能包

[!NOTE] 由 7 个 AI 智能体 Skill 组成，基于 boss-agent-cli 实现 BOSS 直聘简历筛选的全流程自动化：从岗位到可视化报告，一键搞定。

📑 目录

• ✨ 这是什么
• 🎯 核心能力
• 🧩 技能一览与工作流
• 🚀 快速开始
• 🧠 评分系统
• 🛡️ 安全与风控
• 📂 项目结构
• 📤 输出文件
• ⚙️ 环境变量
• 🔗 相关链接

✨ 这是什么

你有一个岗位，剩下的交给 AI：

   岗位          →   AI 自动提取 JD   →   自动下载候选人简历   →   自动评分排名   →   可视化报告 + 沟通建议
(一句话需求)        (boss-job-detail)      (recommend / 沟通列表)     (resume-screener)     (html-report)

一句话概括： AI 帮你在几十份简历中，几分钟内筛出最匹配的那几个，并告诉你该和每个人聊什么。

🎯 核心能力

🚪 boss-hr-auto 是唯一入口，其余 Skill 是其子步骤。使用时始终从 boss-hr-auto 开始。

🧩 技能一览与工作流

工作流示意图

flowchart LR
    A[岗位需求] --> B[boss-job-detail<br/>提取 JD]
    B --> C{简历来源}
    C -->|沟通列表| D1[boss-resume-downloader]
    C -->|推荐牛人| D2[boss-recommend-downloader]
    D1 --> E[resume-screener<br/>评分排名]
    D2 --> E
    E --> F[html-report<br/>可视化报告 + 沟通建议]

🚀 快速开始

无需打包任何二进制文件。 以下全部通过包管理器安装，浏览器用系统自带的即可。

前置依赖

1. 安装

# boss CLI
uv tool install boss-agent-cli

# Python 依赖
pip install patchright

2. 启动 CDP 浏览器

Windows（推荐自带 Edge）：

Start-Process "msedge" -ArgumentList `
  "--remote-debugging-port=9222", `
  "--user-data-dir=$env:USERPROFILE\.workbuddy\chrome-profiles\boss-cdp"

macOS / Linux：

google-chrome \
  --remote-debugging-port=9222 \
  --user-data-dir="$HOME/.workbuddy/chrome-profiles/boss-cdp"

3. 登录

# 浏览器扫码 → 提取到 CLI
boss login --cdp --timeout 30

# 验证（必须两步都通过）
boss --role recruiter me
boss --role recruiter --platform zhipin --cdp-url http://localhost:9222 hr jobs list

4. 关闭低风险模式（简历下载必需）

# 创建/编辑配置文件
cat > ~/.boss-agent/config.json << 'EOF'
{
  "low_risk_mode": false,
  "platform": "zhipin",
  "role": "recruiter"
}
EOF

[!WARNING] 必须关闭：low_risk_mode 默认开启会阻止简历获取。

5. 开始使用

在智能体中调用：

@skill://boss-hr-auto 车架工程师

或直接说：

帮我筛选车架工程师的简历

🧠 评分系统

当前权重（5 维加权求和）

[!NOTE] 当前 resume-screener/scripts/score_resumes.py 已统一为单套 5 维权重（合计 100%）。如需区分岗位类型，建议在 WEIGHTS 常量上扩展，不要直接硬编码多套。

总分与档位

• weighted[d] = round(dims[d] * WEIGHTS[d], 2)
• total = round(sum(weighted.values()), 1)
• 档位阈值：>= 70 → 推荐　>= 60 → 待定　否则 → 不推荐
• 全部逻辑在 resume-screener/scripts/score_resumes.py，由 tests/ 下的单元测试用例覆盖：python -m pytest tests/

学历分档表

[!IMPORTANT] 学历评分必须严格执行分档表，禁止给所有人相同分数。

行动建议规则

输出格式：📊 排名表（含 5 维加权分）+ 📋 每人评分依据 + 🎯 个性化行动建议

• 推荐面试：每人必须写「候选人背景」+「沟通方向」
• 待沟通确认：每人必须写「优势」+「需确认问题」
• ❌ 禁止所有人使用相同的沟通方向

🛡️ 安全与风控

推荐牛人下载

通用规则

• ❌ 不自动发消息（CLI 权限不足）
• ✅ 批量操作间隔随机延迟
• ✅ 增量同步（已下载简历自动跳过）
• ✅ Cookie 优先从浏览器本地提取

风控检测维度

📂 项目结构

boss-hr-agent-toolkit/
├── README.md                          # 本文件
├── FILE_MANAGEMENT.md                 # 文件管理规范
├── .gitignore
│
├── boss-hr-auto/                      # 🚪 全流程编排（唯一入口）
│   └── SKILL.md
│
├── boss-agent-cli/                    # 📖 CLI 命令参考
│   ├── SKILL.md
│   └── scripts/
│       ├── boss_login_guard.py        # 登录守护
│       └── patch_stoken.py            # stoken 补丁
│
├── boss-job-detail/                   # Step 1：JD 提取
│   ├── SKILL.md
│   └── scripts/boss_jd.py
│
├── boss-resume-downloader/            # Step 2A：沟通列表简历下载
│   ├── SKILL.md
│   ├── scripts/sync_boss_resumes.py
│   └── references/
│
├── boss-recommend-downloader/         # Step 2B：推荐牛人简历下载
│   ├── SKILL.md
│   └── scripts/
│       ├── recommend_list.py          # 获取候选人列表
│       ├── recommend_download.py      # 批量获取简历（patchright + fetch）
│       └── run_all.py                 # 一键运行（list + download）
│
├── resume-screener/                   # Step 3：评分系统
│   ├── SKILL.md
│   ├── references/
│   └── scripts/
│       ├── score_resumes.py           # 加权评分 + 分档校准
│       └── school_tier.py             # 学历分档表
│
├── html-report/                       # Step 4：报告生成
│   ├── SKILL.md
│   ├── scripts/generate_html_report.py
│   └── templates/report.html
│
├── shared/                            # 共享工具
│   ├── output_manager.py              # 统一文件路径管理
│   ├── fix_encoding.py                # 编码修复
│   └── human_interaction.py           # 人工交互兜底
│
└── tests/                             # 单元测试
    ├── conftest.py
    ├── test_school_tier.py
    └── test_score_resumes.py

📤 输出文件

所有输出自动保存到：

~/Desktop/boss-hr-output/
└── <岗位名>/
    ├── <岗位名>_统一方案.html          # 最终 HTML 报告
    └── process/                       # 过程文件（留痕查阅）
        ├── job_detail.json            # JD 数据
        ├── recommend_geek_ids.json    # 累计候选人 ID
        ├── test_resumes.json          # 累计所有简历
        └── screening_results.json     # 评分结果

[!TIP]

• 禁止在桌面散落文件；HTML 报告放岗位文件夹根目录，中间数据放 process/
• 临时 Python 脚本任务结束后删除
• 复用 skill 内已有的 Python 脚本，禁止重复造轮子

详见 FILE_MANAGEMENT.md。

⚙️ 环境变量

🔗 相关链接

• boss-agent-cli — 底层 CLI 工具
• patchright — Playwright 分支（CDP 浏览器控制）

📄 License

MIT