Skip to content
Back to search

jobflow-for-codex

JobFlow for Codex: a local job-search workflow plugin for Codex.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/laok775--jobflow-for-codex/badge.svg)](/listings/laok775--jobflow-for-codex)

HTML

<a href="/listings/laok775--jobflow-for-codex"><img src="/api/listings/laok775--jobflow-for-codex/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 256 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # 求职流 JobFlow for Codex
  3. 一套面向 Codex 的本地求职工作流:筛选岗位、跟进消息、维护台账、生成日报。
  4. 当前版本:`0.2.0`。v0.2 增加了台账迁移、平台/状态别名规范化、稳定岗位 ID、原子更新、严格校验和空台账初始化。
  5. [简体中文](README.md) | [English](README.en.md)
  6. [![Codex Workflow](https://img.shields.io/badge/Codex-Workflow-111827)](#)
  7. [![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-3776AB)](#前置条件)
  8. [![Windows Tested](https://img.shields.io/badge/Windows-tested-0078D4)](#兼容性说明)
  9. [![License MIT](https://img.shields.io/badge/License-MIT-3DA639)](LICENSE)
  10. </div>
  11. ---
  12. 求职流 JobFlow for Codex 是一套给 Codex 使用的本地求职工作流。它把“找岗位、按规则筛选、打招呼、看消息、发简历、记录进度、生成日报”整理成可复用的流程、模板和脚本。
  13. 它适合正在主动找工作的用户,尤其适合希望用 Codex 辅助处理 BOSS 直聘、猎聘这类招聘网站的人。它不是自动投递外挂,也不会绕过验证码、登录、平台风控或安全限制。
  14. ## 你可以用它做什么
  15. - 初始化一套本地求职工作区。
  16. - 维护一份 `applications.jsonl` 求职台账。
  17. - 用 `screening_rules.md` 记录你的岗位筛选规则。
  18. - 让 Codex 按规则辅助筛选岗位。
  19. - 让 Codex 检查招聘方消息并分类处理。
  20. - 生成每日求职日报。
  21. - 生成可审核的定时自动化 prompt。
  22. ## v0.2 主要变化
  23. - 初始化创建空台账,示例记录不会混入真实日报。
  24. - 统一 `BOSS直聘`/`BOSS`、`猎聘`/`Liepin` 以及中英文状态值。
  25. - 为岗位生成稳定的 `job_id`,减少重复记录。
  26. - 用迁移命令生成新台账,原始文件保持不变。
  27. - 用 `upsert_ledger.py` 原子追加或更新本地记录。
  28. - 目标统计会识别已发简历、已面试等后续状态,不再只统计 `contacted`。
  29. - 校验器区分错误和警告,并支持 `--strict` 严格模式。
  30. - GitHub Actions 在 Python 3.10、3.11、3.12 上运行本地测试。
  31. ## 适用场景
  32. - 你正在找产品经理、增长、AI、Web3、运营、技术等岗位。
  33. - 你希望每天固定节奏投递和跟进。
  34. - 你希望有一份本地记录,知道哪些岗位已打招呼、已发简历、被拒、待回复。
  35. - 你希望 Codex 帮你做重复流程,但关键判断仍由你确认。
  36. ## 前置条件
  37. - 已安装 Codex,并能在本地运行 Python 脚本。
  38. - Python 3.10 或更高版本。
  39. - 如果要让 Codex 操作招聘网站,需要浏览器里已经登录对应平台。
  40. - 如果要自动发送简历,需要先在本地配置简历文件路径。
  41. - 如果要使用定时任务,需要你自己在 Codex 里创建或审核自动化 prompt。
  42. ## 兼容性说明
  43. 当前项目只在 Windows + 本地 Codex 工作流下自测通过。其他操作系统、浏览器控制方式或自动化模式可能也能使用,但需要使用者自行验证和适配。
  44. ## 快速开始
  45. 克隆仓库后,进入项目目录:
  46. ```bash
  47. git clone https://github.com/laok775/jobflow-for-codex.git
  48. cd jobflow-for-codex
  49. ```
  50. 初始化你的私有求职工作区:
  51. ```bash
  52. python skills/jobflow/scripts/init_jobflow.py --workspace /path/to/your/workspace
  53. ```
  54. 它会创建:
  55. ```text
  56. /path/to/your/workspace/data/job_search/
  57. user_profile.yaml
  58. screening_rules.md
  59. applications.jsonl
  60. applications.example.jsonl
  61. automation_prompt.md
  62. reports/
  63. ```
  64. 然后编辑:
  65. - `user_profile.yaml`:你的目标岗位、城市、平台、简历路径。
  66. - `screening_rules.md`:你的岗位偏好、必投信号、排除项。
  67. ## 常用命令
  68. 校验求职台账:
  69. ```bash
  70. python skills/jobflow/scripts/validate_ledger.py --workspace /path/to/your/workspace
  71. ```
  72. 生成某天日报:
  73. ```bash
  74. python skills/jobflow/scripts/summarize_day.py --workspace /path/to/your/workspace --date 2026-01-01
  75. ```
  76. 检查当天投递目标是否达成:
  77. ```bash
  78. python skills/jobflow/scripts/check_targets.py --workspace /path/to/your/workspace --date 2026-01-01 --boss 5 --liepin 5
  79. ```
  80. 生成定时自动化 prompt:
  81. ```bash
  82. 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
  83. # 将旧台账迁移到新文件,源文件不会被覆盖
  84. 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
  85. # 通过 job_id 原子追加或更新一条本地记录
  86. python skills/jobflow/scripts/upsert_ledger.py --ledger /path/to/your/workspace/data/job_search/applications.jsonl --record-file /path/to/private-record.json
  87. # 严格检查重复 ID、重复 URL、未知别名和推荐字段缺失
  88. python skills/jobflow/scripts/validate_ledger.py --workspace /path/to/your/workspace --strict
  89. ```
  90. 初始化会创建空的 `applications.jsonl`,示例记录单独放在 `applications.example.jsonl`,不会被日报当成真实投递。
  91. ## 哪些地方需要你介入
  92. 求职流不会假装自己能完全无人值守。下面这些情况需要用户介入:
  93. - 第一次使用前,你需要登录招聘平台。
  94. - 遇到验证码、风控、安全确认时,需要你处理。
  95. - 招聘方问微信、电话、薪资、到岗时间、面试时间时,需要你决定怎么回复。
  96. - 招聘方的问题需要结合个人情况判断时,需要你回复。
  97. - 启用定时自动化前,需要你审核生成的 prompt。
  98. - 平台页面结构变化导致 Codex 无法确认成功状态时,需要你复核。
  99. ## 一次完整运行
  100. 1. 初始化私有 workspace,并填写 `user_profile.yaml` 和 `screening_rules.md`。
  101. 2. 让 Codex 读取规则和台账,检查招聘方消息。
  102. 3. 按筛选规则查看岗位详情,只在确认成功状态后记录联系结果。
  103. 4. 对需要判断的消息由你决定回复内容、薪资、联系方式和面试安排。
  104. 5. 用日报和跟进列表检查当天进展与待处理事项。
  105. 求职平台登录、验证码、风控确认、复杂消息回复和简历发送都保留人工确认环节。
  106. ## 消息处理规则
  107. Codex 可以辅助判断消息,但不会替你乱回复:
  108. - 明确说不合适:更新为 `not_suitable`。
  109. - 明确要简历:如果你配置了简历路径,可以发送简历并更新为 `resume_sent`。
  110. - 需要判断的问题:标记为 `needs_user_action`,并提醒你处理。
  111. - 无法确认的页面或消息:标记为 `needs_review`。
  112. ## 标准状态值
  113. 台账使用这些状态:
  114. - `contacted`
  115. - `resume_sent`
  116. - `interviewed`
  117. - `not_suitable`
  118. - `needs_user_action`
  119. - `needs_review`
  120. - `recruiter_replied`
  121. - `interview_scheduled`
  122. - `rejected`
  123. - `withdrawn`
  124. - `offer`
  125. - `no_response`
  126. 你可以在日报里显示中文标签,但脚本会使用这些英文状态值。
  127. ## 数据保存在哪里
  128. 你的真实数据保存在你自己的 workspace,例如:
  129. ```text
  130. /path/to/your/workspace/data/job_search/
  131. ```
  132. 这个仓库只提供插件、模板和脚本,不应该保存你的真实简历、账号信息、cookie、session 或真实求职台账。
  133. ### 隐私边界
  134. - 公开仓库只包含通用代码、模板、虚构示例和测试。
  135. - 真实岗位、公司、招聘方消息、联系方式、简历路径和台账只能放在私有 workspace。
  136. - 迁移和更新命令只读写你通过参数指定的本地文件,不会上传求职数据。
  137. - 提交前请运行发布检查,确认 Git 工作区没有私有数据。
  138. ## 项目结构
  139. ```text
  140. .codex-plugin/
  141. plugin.json
  142. skills/
  143. jobflow/
  144. SKILL.md
  145. references/
  146. scripts/
  147. templates/
  148. ```
  149. 核心内容:
  150. - `SKILL.md`:告诉 Codex 如何执行求职流。
  151. - `references/`:BOSS 直聘、猎聘、消息处理、筛选规则说明。
  152. - `templates/`:用户配置、筛选规则、台账、日报、自动化 prompt 模板。
  153. - `scripts/`:初始化、校验台账、生成日报、检查目标、生成自动化 prompt。
  154. - `templates/schema-v0.2.md`:台账字段、别名和迁移说明。
  155. - `tests/`:不访问招聘平台和真实数据的本地回归测试。
  156. ## 当前支持平台
  157. - BOSS 直聘
  158. - 猎聘
  159. 其他平台可以后续通过新增 reference 和流程规则支持。
  160. ## 当前限制
  161. - 不能绕过验证码或平台风控。
  162. - 不能保证平台一定允许自动化操作。
  163. - 不能保证投递结果。
  164. - 招聘网站页面变化后,可能需要更新平台操作规则。
  165. - 复杂消息仍需要用户自己判断。
  166. - 真实简历、账号信息、cookie、session、招聘方消息和求职台账必须保存在用户自己的 workspace,不能提交到本仓库。
  167. ## 致谢
  168. - 感谢 OpenAI Codex 提供本地智能体工作流能力。
  169. - 感谢 [Linux.do](https://linux.do/) 社区提供交流、反馈与支持。
  170. - 感谢 BOSS 直聘、猎聘等招聘平台提供职位搜索和招聘沟通服务。
  171. - README 展示结构参考了 [CoCo Downloader](https://github.com/markcxx/coco-downloader) 等开源项目的写法。
  172. ## 免责声明
  173. 1. 本项目仅用于个人求职效率管理、学习和技术研究,不是招聘平台外挂或批量投递工具。
  174. 2. 使用者应自行遵守所在地法律法规、招聘平台服务条款和账号安全规则。
  175. 3. 本项目不会绕过验证码、登录、风控、安全确认或平台限制。
  176. 4. 本项目不保证岗位匹配准确性、消息判断准确性、投递结果或面试机会。
  177. 5. 使用者应自行审核自动化 prompt、筛选规则、消息处理结果和发送的简历内容。
  178. 6. 本项目与 BOSS 直聘、猎聘、OpenAI 等第三方平台或公司没有官方从属、授权或背书关系。
  179. 7. 如发现项目内容影响了你的权益,请通过 GitHub Issues 联系处理。
  180. ## 许可证
  181. 本项目使用 MIT License,详见 [LICENSE](LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.