boss-agent-cli（boss Agent CLI 搜索）

boss-agent-cli

BOSS 直聘求职 CLI，专为 AI Agent 设计。32 个命令覆盖搜索、筛选、打招呼、沟通、流水线、简历优化全流程。通过 Bash 调用 boss 命令，解析 stdout JSON 完成求职操作链。

Codex 环境默认约定

在 Codex 沙箱里，默认使用可写数据目录：

boss --data-dir /tmp/boss-agent-codex --json <command>

• 不要依赖默认的 ~/.boss-agent，该目录在 Codex 沙箱里可能不可写
• 优先显式带上 --json，确保稳定返回 JSON 信封
• 所有命令统一复用 /tmp/boss-agent-codex

如果本机已有登录态，但 /tmp/boss-agent-codex 还是空的，先做一次迁移：

mkdir -p /tmp/boss-agent-codex
if [ ! -f /tmp/boss-agent-codex/auth/session.enc ] && [ -f ~/.boss-agent/auth/session.enc ]; then
  cp -R ~/.boss-agent/auth /tmp/boss-agent-codex/
fi

若命令因沙箱网络限制失败（典型表现：DNS/network error、无法访问 zhipin.com），应对同一条 boss 命令申请提权后重试，而不是改掉命令参数或跳过该步骤。

安装前置

运行此 skill 需要 boss 命令可用。若不可用，提示用户执行：

uv tool install boss-agent-cli
patchright install chromium    # QR httpx 模式可省略此步

验证安装：boss schema（应返回 JSON 能力描述）。

Agent 决策树

用户意图 → 选择命令链
│
├─ "帮我找工作"
│   → boss status → boss search "关键词" --city X --welfare "Y"
│   → boss detail <sid> → boss greet <sid> <jid>
│
├─ "有什么新职位？"
│   → boss watch run <name>  (已有监控)
│   → boss recommend         (个性化推荐)
│
├─ "我的求职进展怎样？"
│   → boss pipeline → boss follow-up → boss digest
│
├─ "帮我优化简历"
│   → boss ai analyze-jd → boss ai polish → boss ai optimize
│
├─ "查看沟通记录"
│   → boss chat → boss chatmsg <sid> → boss chat-summary <sid>
│
├─ "登录/环境有问题"
│   → boss doctor → boss login
│
└─ "不知道能做什么"
    → boss schema  (返回全部能力 JSON)

输出协议

所有命令输出 JSON 到 stdout，格式固定：

{
  "ok": true,
  "schema_version": "1.0",
  "command": "命令名",
  "data": {},
  "pagination": null,
  "error": null,
  "hints": {"next_actions": ["下一步建议"]}
}

• ok=false 时读 error.code 判断错误类型，error.recovery_action 包含修复命令
• hints.next_actions 包含 Agent 可直接执行的下一步命令
• stderr 为日志/进度信息，忽略即可
• exit code 0 = 成功，1 = 失败

调用流程

必须按此顺序操作：

1. boss --json status         → 检查登录态
2. boss --json login          → 若未登录（四级降级：Cookie → CDP → QR → patchright）
3. boss --json search <关键词>  → 搜索职位
   boss --json recommend       → 或获取推荐
4. boss --json detail <sid>    → 查看详情
5. boss --json greet <sid> <jid> → 打招呼
6. boss --json pipeline        → 追踪进度
7. boss --json digest          → 每日摘要

Codex 环境中所有命令加 --data-dir /tmp/boss-agent-codex

搜索前的环境兜底

• boss search / boss recommend / boss greet 依赖浏览器通道，不是纯 httpx
• 如果上一条相关命令报 NETWORK_ERROR，不要直接判断成“skill 参数错了”或“未登录”
• 先执行 boss --data-dir /tmp/boss-agent-codex --json doctor
• 若 network=ok 但 browser_channel=warn 或 cdp=warn，说明命令会降级到 headless patchright，此时更容易出现页面预热超时或风控
• 优先修复浏览器通道后再重试：启动带 --remote-debugging-port=9222 的 Chrome，或接入 Bridge；仅在 status / doctor 也失败时，再回头排查 data dir、登录态或网络

命令速查（32 个）

运行 boss schema 获取完整命令定义。运行 boss <cmd> --help 查看单个命令帮助。

基础

搜索

动作

沟通

流水线

简历与 AI

系统

福利筛选（核心功能）

用户提到福利要求（如"要双休"、"五险一金"）时，使用 --welfare 参数：

boss --json search "golang" --city 广州 --welfare "双休,五险一金"

• 逗号分隔 = AND 逻辑，所有条件都必须满足
• 自动翻页逐个检查职位福利标签和描述
• 结果带 welfare_match 字段说明匹配来源
• 常用关键词：双休、五险一金、年终奖、餐补、住房补贴、定期体检、股票期权、加班补助

错误处理

行为规则

1. 先检查登录态：每次操作前调用 boss status，失败则 boss login
2. 福利要求用 --welfare：用户说"要双休"→ --welfare "双休"
3. 无需额外 sleep：工具内置高斯分布请求延迟
4. 批量打招呼先 dry-run：boss batch-greet... --dry-run 让用户确认
5. 解析 JSON 不解析文本：用 ok 字段判断成败
6. 未指定关键词用 recommend：用户说"推荐职位"→ boss recommend
7. 导出用 export：用户说"导出"、"下载列表"→ boss export
8. 展示结果含福利：welfare 字段是列表，向用户展示时列出
9. 遇到沙箱网络错误先提权重试：不要在 DNS/网络受限时报"工具不可用"
10. 求职进度用 pipeline：用户问"进展怎样"→ boss pipeline + boss digest