DanielPan12/JobHuntBot

JobHuntBot – AI 지원 채용 지원 워크플로우

기능 설명

• AI 코딩 어시스턴트(Claude Code, Codex CLI, Cursor 등)가 채용 정보 탐색, 지원서 작성, 진행 상황 추적을 수행할 수 있도록 구조화된 워크플로우를 제공합니다.
• 핵심 지침은 SKILL.md에 포함되어 있습니다. 에이전트가 이 파일을 읽고 몇 가지 필수 질문을 한 뒤, 템플릿(프로필, 규칙, 이력서 라우팅, 답변/경력 은행 등)의 개인화된 사본을 생성합니다.
• 가벼운 로컬 대시보드(정적 HTML + 소형 Node.js 서버)를 통해 4가지 뷰(지원 완료, 대기 중, 거절, 합격)와 면접 및 기타 이벤트를 위한 7일 캘린더를 시각화합니다. 모든 데이터는 간단한 CSV 파일에 저장되며, 대시보드가 이를 직접 읽고 씁니다.

주요 구성 요소

폴더 / 파일	역할
SKILL.md	에이전트 수준의 워크플로우 및 안전 계약 – AI 어시스턴트의 진입점.
references/	상세 플레이북(설정, 채용 정보 탐색, 지원 처리, 안전 규칙).
templates/	개인 프로필, 지원 규칙, 이력서 선택, 재사용 가능한 답변, 경력 스니펫 및 CSV 대시보드 스키마를 위한 빈 JSON/MD 템플릿.
dashboard/	CSV 데이터를 표시하고 안전하게 업데이트하는 최소한의 Node 서버(server.js) 및 UI(dashboard.html).
scripts/ & tests/	검증 스크립트, 회귀 테스트 및 개인 데이터의 우발적 게시를 방지하는 공개 패키지 체크.

작동 방식

1. 에이전트 준비 – 브라우저 자동화 도구(Playwright MCP)를 제공하여 실제 지원 페이지와 상호 작용할 수 있게 합니다.
2. 개인 작업 공간 생성 – 템플릿을 복사하고 이력서, 성적 증명서, 프로젝트 노트 등을 추가합니다.
3. 워크플로우 시작 – 에이전트에게 “SKILL.md를 사용하여 채용 검색을 초기화해”라고 지시합니다. 에이전트가 개인 파일을 채웁니다.
4. 안전한 시험 실행 – 에이전트가 채용 정보를 탐색하고 대시보드를 업데이트하도록만 지시합니다. 양식 제출은 수행되지 않습니다.
5. 대시보드 열기 – 제공된 시작 스크립트를 실행합니다. UI에 현재 채용 풀이 표시되며 결과를 기록하거나 면접 일정을 잡을 수 있습니다.
6. 전체 지원 – 에이전트가 브라우저 도구를 사용하여 양식을 작성하고 이력서를 업로드하며, 사용자가 명시적으로 제출을 승인한 후 지원을 완료합니다. 모든 업데이트는 CSV 파일에 다시 기록됩니다.

안전 및 개인정보 보호

• 워크플로우는 엄격한 경계를 강제합니다. 에이전트는 신원, 취업 허가, 급여를 추측하거나 경력을 조작해서는 안 되며, CAPTCHA를 우회하거나 알 수 없는 자격 증명으로 로그인할 수 없습니다.
• 최종 제출에는 명시적인 사용자 승인이 필요하며, 기존 승인은 원래 범위 내에서만 재사용됩니다.
• 저장소에는 빈 템플릿만 포함되어 있습니다. 사용자는 작성된 데이터를 비공개로 유지하고 공개 저장소에 푸시하지 않도록 주의해야 합니다.

대상 사용자

• LLM 기반 코딩 어시스턴트 사용에 익숙하며, “원클릭 대량 지원” 봇이 아닌 반복 가능하고 감사 가능한 프로세스를 원하는 구직자.
• 투명하고 파일 기반(CSV + JSON) 시스템을 선호하며, 검사 및 버전 관리가 가능하고 완전히 온프레미스에서 실행되기를 원하는 개발자.

라이선스

• MIT, Yvonne He의 오픈 소스 ApplyPilot 워크플로우에서 파생됨.

---

모든 세부 정보는 README에서 직접 가져온 것이며, 추가 기능에 대한 추론은 포함되어 있지 않습니다.