laok775/jobflow-for-codex

---

求职流 JobFlow for Codex 是一套给 Codex 使用的本地求职工作流。它把“找岗位、按规则筛选、打招呼、看消息、发简历、记录进度、生成日报”整理成可复用的流程、模板和脚本。

它适合正在主动找工作的用户，尤其适合希望用 Codex 辅助处理 BOSS 直聘、猎聘这类招聘网站的人。它不是自动投递外挂，也不会绕过验证码、登录、平台风控或安全限制。

你可以用它做什么

• 初始化一套本地求职工作区。
• 维护一份 applications.jsonl 求职台账。
• 用 screening_rules.md 记录你的岗位筛选规则。
• 让 Codex 按规则辅助筛选岗位。
• 让 Codex 检查招聘方消息并分类处理。
• 生成每日求职日报。
• 生成可审核的定时自动化 prompt。

v0.2 主要变化

• 初始化创建空台账，示例记录不会混入真实日报。
• 统一 BOSS直聘/BOSS、猎聘/Liepin 以及中英文状态值。
• 为岗位生成稳定的 job_id，减少重复记录。
• 用迁移命令生成新台账，原始文件保持不变。
• 用 upsert_ledger.py 原子追加或更新本地记录。
• 目标统计会识别已发简历、已面试等后续状态，不再只统计 contacted。
• 校验器区分错误和警告，并支持 --strict 严格模式。
• GitHub Actions 在 Python 3.10、3.11、3.12 上运行本地测试。

适用场景

• 你正在找产品经理、增长、AI、Web3、运营、技术等岗位。
• 你希望每天固定节奏投递和跟进。
• 你希望有一份本地记录，知道哪些岗位已打招呼、已发简历、被拒、待回复。
• 你希望 Codex 帮你做重复流程，但关键判断仍由你确认。

前置条件

• 已安装 Codex，并能在本地运行 Python 脚本。
• Python 3.10 或更高版本。
• 如果要让 Codex 操作招聘网站，需要浏览器里已经登录对应平台。
• 如果要自动发送简历，需要先在本地配置简历文件路径。
• 如果要使用定时任务，需要你自己在 Codex 里创建或审核自动化 prompt。

兼容性说明

当前项目只在 Windows + 本地 Codex 工作流下自测通过。其他操作系统、浏览器控制方式或自动化模式可能也能使用，但需要使用者自行验证和适配。

快速开始

克隆仓库后，进入项目目录：

git clone https://github.com/laok775/jobflow-for-codex.git
cd jobflow-for-codex

初始化你的私有求职工作区：

python skills/jobflow/scripts/init_jobflow.py --workspace /path/to/your/workspace

它会创建：

/path/to/your/workspace/data/job_search/
  user_profile.yaml
  screening_rules.md
  applications.jsonl
  applications.example.jsonl
  automation_prompt.md
  reports/

然后编辑：

• user_profile.yaml：你的目标岗位、城市、平台、简历路径。
• screening_rules.md：你的岗位偏好、必投信号、排除项。

常用命令

校验求职台账：

python skills/jobflow/scripts/validate_ledger.py --workspace /path/to/your/workspace

生成某天日报：

python skills/jobflow/scripts/summarize_day.py --workspace /path/to/your/workspace --date 2026-01-01

检查当天投递目标是否达成：

python skills/jobflow/scripts/check_targets.py --workspace /path/to/your/workspace --date 2026-01-01 --boss 5 --liepin 5

生成定时自动化 prompt：

python skills/jobflow/scripts/build_automation_prompt.py --workspace /path/to/your/workspace --output /path/to/your/workspace/data/job_search/automation_prompt.generated.md

# 将旧台账迁移到新文件，源文件不会被覆盖
python skills/jobflow/scripts/migrate_ledger.py --ledger /path/to/your/workspace/data/job_search/applications.jsonl --output /path/to/your/workspace/data/job_search/applications.v0.2.jsonl

# 通过 job_id 原子追加或更新一条本地记录
python skills/jobflow/scripts/upsert_ledger.py --ledger /path/to/your/workspace/data/job_search/applications.jsonl --record-file /path/to/private-record.json

# 严格检查重复 ID、重复 URL、未知别名和推荐字段缺失
python skills/jobflow/scripts/validate_ledger.py --workspace /path/to/your/workspace --strict

初始化会创建空的 applications.jsonl，示例记录单独放在 applications.example.jsonl，不会被日报当成真实投递。

哪些地方需要你介入

求职流不会假装自己能完全无人值守。下面这些情况需要用户介入：

• 第一次使用前，你需要登录招聘平台。
• 遇到验证码、风控、安全确认时，需要你处理。
• 招聘方问微信、电话、薪资、到岗时间、面试时间时，需要你决定怎么回复。
• 招聘方的问题需要结合个人情况判断时，需要你回复。
• 启用定时自动化前，需要你审核生成的 prompt。
• 平台页面结构变化导致 Codex 无法确认成功状态时，需要你复核。

一次完整运行

1. 初始化私有 workspace，并填写 user_profile.yaml 和 screening_rules.md。
2. 让 Codex 读取规则和台账，检查招聘方消息。
3. 按筛选规则查看岗位详情，只在确认成功状态后记录联系结果。
4. 对需要判断的消息由你决定回复内容、薪资、联系方式和面试安排。
5. 用日报和跟进列表检查当天进展与待处理事项。

求职平台登录、验证码、风控确认、复杂消息回复和简历发送都保留人工确认环节。

消息处理规则

Codex 可以辅助判断消息，但不会替你乱回复：

• 明确说不合适：更新为 not_suitable。
• 明确要简历：如果你配置了简历路径，可以发送简历并更新为 resume_sent。
• 需要判断的问题：标记为 needs_user_action，并提醒你处理。
• 无法确认的页面或消息：标记为 needs_review。

标准状态值

台账使用这些状态：

• contacted
• resume_sent
• interviewed
• not_suitable
• needs_user_action
• needs_review
• recruiter_replied
• interview_scheduled
• rejected
• withdrawn
• offer
• no_response

你可以在日报里显示中文标签，但脚本会使用这些英文状态值。

数据保存在哪里

你的真实数据保存在你自己的 workspace，例如：

/path/to/your/workspace/data/job_search/

这个仓库只提供插件、模板和脚本，不应该保存你的真实简历、账号信息、cookie、session 或真实求职台账。

隐私边界

• 公开仓库只包含通用代码、模板、虚构示例和测试。
• 真实岗位、公司、招聘方消息、联系方式、简历路径和台账只能放在私有 workspace。
• 迁移和更新命令只读写你通过参数指定的本地文件，不会上传求职数据。
• 提交前请运行发布检查，确认 Git 工作区没有私有数据。

项目结构

.codex-plugin/
  plugin.json
skills/
  jobflow/
    SKILL.md
    references/
    scripts/
    templates/

核心内容：

• SKILL.md：告诉 Codex 如何执行求职流。
• references/：BOSS 直聘、猎聘、消息处理、筛选规则说明。
• templates/：用户配置、筛选规则、台账、日报、自动化 prompt 模板。
• scripts/：初始化、校验台账、生成日报、检查目标、生成自动化 prompt。
• templates/schema-v0.2.md：台账字段、别名和迁移说明。
• tests/：不访问招聘平台和真实数据的本地回归测试。

当前支持平台

• BOSS 直聘
• 猎聘

其他平台可以后续通过新增 reference 和流程规则支持。

当前限制

• 不能绕过验证码或平台风控。
• 不能保证平台一定允许自动化操作。
• 不能保证投递结果。
• 招聘网站页面变化后，可能需要更新平台操作规则。
• 复杂消息仍需要用户自己判断。
• 真实简历、账号信息、cookie、session、招聘方消息和求职台账必须保存在用户自己的 workspace，不能提交到本仓库。

致谢

• 感谢 OpenAI Codex 提供本地智能体工作流能力。
• 感谢 Linux.do 社区提供交流、反馈与支持。
• 感谢 BOSS 直聘、猎聘等招聘平台提供职位搜索和招聘沟通服务。
• README 展示结构参考了 CoCo Downloader 等开源项目的写法。

免责声明

1. 本项目仅用于个人求职效率管理、学习和技术研究，不是招聘平台外挂或批量投递工具。
2. 使用者应自行遵守所在地法律法规、招聘平台服务条款和账号安全规则。
3. 本项目不会绕过验证码、登录、风控、安全确认或平台限制。
4. 本项目不保证岗位匹配准确性、消息判断准确性、投递结果或面试机会。
5. 使用者应自行审核自动化 prompt、筛选规则、消息处理结果和发送的简历内容。
6. 本项目与 BOSS 直聘、猎聘、OpenAI 等第三方平台或公司没有官方从属、授权或背书关系。
7. 如发现项目内容影响了你的权益，请通过 GitHub Issues 联系处理。

许可证

本项目使用 MIT License，详见 LICENSE。