DanielPan12/JobHuntBot

JobHuntBot – AI 辅助求职申请工作流程

功能说明

• 提供一个结构化的工作流程，让 AI 编程助手（如 Claude Code, Codex CLI, Cursor 等）能协助您寻找工作、填写申请表并跟踪进度。
• 核心指令位于 SKILL.md；代理程序会读取此文件，询问您几个必要问题，并创建模板的个性化副本（包含个人资料、规则、简历投递路径、回答/经验库等）。
• 轻量级本地仪表板（静态 HTML + 小型 Node.js 服务器）可可视化四种视图 – 已申请、待处理、已拒绝、录取 – 以及用于面试和其他活动的 7 天日历。所有数据皆存储于简单的 CSV 文件中，仪表板会直接读取并写入这些文件。

关键组件

文件夹 / 文件	角色
SKILL.md	代理层级的工作流程与安全合约 – AI 助手的进入点。
references/	详细的操作手册（设置、潜在机会发现、申请处理、安全规则）。
templates/	用于个人资料、申请规则、简历选择、可重复使用回答、经验片段及 CSV 仪表板架构的空白 JSON/MD 模板。
dashboard/	最小化的 Node 服务器 (server.js) 与 UI (dashboard.html)，用于显示并安全更新 CSV 数据。
scripts/ & tests/	验证脚本、回归测试，以及防止意外发布个人数据的公开包检查。

运作方式

1. 准备代理程序 – 提供浏览器自动化工具（Playwright MCP），使其能与真实的申请页面互动。
2. 建立私人工作区 – 将模板复制到该处，并加入您的简历、成绩单、项目笔记等。
3. 启动工作流程 – 告诉代理程序“使用 SKILL.md 初始化我的求职搜索”。代理程序会填入您的个人文件。
4. 执行安全试验 – 要求代理程序仅发现潜在机会并更新仪表板；不会进行任何表单提交。
5. 开启仪表板 – 执行提供的启动脚本；UI 会显示当前的职位池，并让您记录结果或安排面试活动。
6. 完整申请 – 代理程序使用浏览器工具填写表单、上传简历，并在您明确授权提交后，送出申请。所有更新都会写回 CSV 文件。

安全与隐私

• 工作流程强制执行严格边界：代理程序绝不能猜测身份、工作许可、薪资或捏造经验，且无法绕过 CAPTCHA 或使用未知凭证登录。
• 最终提交需要明确的用户授权；现有的授权仅在原始范围内重复使用。
• 本仓库仅提供空白模板。用户被警告需将填写后的数据保持私密，切勿推送到公开仓库。

适用对象

• 习惯使用 LLM 驱动的编程助手，且希望拥有可重复、可审计流程（而非“一键大量投递”机器人）的求职者。
• 偏好透明、基于文件（CSV + JSON）系统，且能进行检查、版本控制并完全在本地执行的开发者。

授权条款

• MIT，源自 Yvonne He 的开源 ApplyPilot 工作流程。

---

所有细节均直接取自 README；未推论任何额外功能。