jobfit — 공고 기반 자소서 파이프라인

소개·사용법 페이지: https://donasman.github.io/jobfit/ · 내려받기: 최신 버전

채용공고 링크를 적어 두면 공고를 받아 정리하고, AI가 공고를 분석해 내 경험 카드와 맞춘 뒤, 원안으로 고른 잘 쓴 자소서의 문체·흐름에 내 경험을 맞춰 자기소개서 초안을 쓰고, 다시 스크립트가 글자수·지어낸 숫자·연락처를 검사해 한 장(report.md)으로 정리해 준다. 원안 자소서가 없으면 초안은 쓰지 않는다 — 처음부터 지어 쓰는 도구가 아니다.

스크립트가 보장하고 AI는 판단만 한다. AI는 스크립트가 만든 프롬프트 하나만 보고 답 하나만 낸다. 그 답이 형식을 어기거나 경험 카드에 없는 숫자를 쓰면 스크립트가 잡는다.

내 자료(이력서·포트폴리오, 아무 형식) ─▶ 글자 꺼내기 ─▶ [AI] 경험 카드 뽑기 ─▶ 숫자 원문 대조 ─▶ me/experiences.yaml
원안 자소서(sources/자소서/) ─▶ 문체 수치 ─▶ [AI] 문체·흐름 정리 ─▶ me/style/style_rules.md
공고 링크 ─▶ 받기·정제 ─▶ [AI] 공고 분석 ─▶ 경험 카드 매칭 ─▶ report.md (매칭 점수 · 이력서 강조 포인트)
                                                   │
                              문항과 원안이 있으면 ▼
                              [AI] 자소서 초안 ─▶ 검사 ─▶ (걸린 문항만 [AI] 수정 1회) ─▶ report.md 에 초안 추가

두 가지 쓰는 방식

	붙여넣기 모드	에이전트 모드
AI	아무 무료 웹 채팅 (ChatGPT · Claude · Gemini)	Claude Code · Codex처럼 폴더에서 명령을 실행하는 AI (CLI · 데스크톱 앱 · IDE)
요금	무료	각 서비스 유료 플랜
하는 일	start.bat 메뉴. AI 단계마다 프롬프트 복사 → 웹 채팅에 붙여넣기 → 답 복사 → 메뉴 10	"이 링크 공고 처리해줘: …" 한 마디

두 방식은 같은 스크립트·같은 프롬프트·같은 결과 파일을 쓴다. 웹 채팅은 폴더를 볼 수 없어도 된다 — 필요한 내용은 전부 프롬프트 한 덩어리에 들어간다. API 키는 필요 없다.

준비물

• Windows 또는 macOS
• uv — Python은 uv가 알아서 받는다. 없으면 start.bat이 설치 명령을 알려 준다
  • Windows(PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • macOS: curl -LsSf https://astral.sh/uv/install.sh | sh
• 엑셀은 없어도 된다 — 공고와 자소서 문항은 start.bat 메뉴 1(공고 추가)·**2(문항 넣기)**로 넣는다. Microsoft Excel이 있으면 jobs.xlsx를 직접 고쳐도 된다(LibreOffice Calc로도 열리지만 드롭다운 동작은 확인하지 않았다)

설치

1. Releases에서 jobfit.zip을 받아 원하는 곳에 푼다.
2. start.bat(macOS는 ./start.sh)을 실행하면 처음 설정을 묻는다. Enter를 누르면 jobs.xlsx, me/, sources/, output/이 생기고, 예시 카드를 지우고 빈 상태로 시작할지 묻는다(jobfit init --no-examples).
3. 먼저 공고 링크 하나로 결과를 본다 — 메뉴 1. 공고 추가 → 3. 공고 처리 진행 → AI 단계 한 번. 경험 카드도 원안 자소서도 없이 report.md(공고 요건 정리)가 나온다. 내 자료는 그다음에 채우면 된다.

처음 한 번: 내 정보 넣기 (me/)

공고 하나로 결과를 한 번 본 다음에 채우면 된다. 경험 카드를 넣으면 매칭 점수와 이력서 강조 포인트가, 원안 자소서까지 넣으면 자소서 초안이 나온다.

me/는 내 컴퓨터에만 있는 개인 폴더다. 배포·공유 대상이 아니다.

파일	내용	필수
sources/	내 자료 — 이력서·포트폴리오·프로젝트 문서·예전 자소서. 형식 무관	경험 카드를 AI로 만들 때
me/experiences.yaml	경험 카드 — 경험 하나에 카드 하나. 태그, STAR(상황·과제·행동·결과), facts(확정한 수치·사실만), 쓸 문항 유형, verified	매칭·초안에 필요
me/resume.yaml	이력서 항목 — report의 "위로 올릴 항목·공고 표기로 맞출 것"에 쓰인다	선택
me/profile.yaml	지원서 정보 — 학력·경력·자격증·어학·병역·교육·수상·활동. 지원서 입력표에 쓰인다. 신원 정보(이름·연락처·주소·생년월일)는 넣지 않는다	지원서 입력표를 쓸 때
sources/자소서/	원안 자소서 — 초안이 따를 문체·흐름. 잘 쓴 자소서(.txt · .md · .docx · .hwpx · .pdf), 남의 합격 자소서도 된다. 경험 카드로는 뽑지 않는다	초안을 쓰려면 필수

처음에는 예시(me.example/의 내용)가 복사돼 있다. 예시 카드 두 개는 지우고 내 카드로 채운다.

경험 카드를 AI로 만들기

1. 이력서·포트폴리오·프로젝트 문서를 sources/에 넣는다(메뉴 8 → 1로 폴더 열기).
2. 메뉴 8 → 2(경험 카드 만들기 준비) — 자료마다 프롬프트가 만들어진다. 이어서 메뉴 10을 누르면 첫 프롬프트가 클립보드에 복사된다. 웹 채팅에 붙여 넣는다.
3. 답 전체를 복사하고 메뉴 11. 자료가 길면 조각으로 나뉘니 남은 조각이 없을 때까지 10 · 11을 반복한다.
4. 카드 확인은 지금 다 하지 않아도 된다. 공고 리포트·초안에 쓰일 카드가 생기면 그 카드만 알려 준다. 그때 메뉴 8 → 3(경험 카드 확인)을 누르면 카드를 하나씩 보여 주고, 맞으면 Enter — 스크립트가 verified: true로 바꾸고 STAR에만 있던 숫자를 facts에 넣는다. 파일을 열어 고칠 일은 틀린 곳이 있을 때뿐이다.

자료 형식	누가 읽나
txt · md · csv · docx · hwpx · pptx · xlsx · html · 글자가 있는 PDF	스크립트가 글자를 꺼내 프롬프트에 넣는다
그림(png·jpg 등) · 스캔한 PDF	AI가 원본을 직접 읽는다 — 에이전트는 파일을 열고, 웹 채팅은 그 파일을 첨부한다
hwp · doc · ppt · xls(옛 형식) · 암호 걸린 파일	건너뛴다 — hwpx·docx·PDF로 저장해 다시 넣는다

AI가 뽑은 카드는 받기 전에 스크립트가 검사한다. facts의 숫자가 자료 원문에 없으면 그 fact를 빼고 알려 준다. STAR에만 쓰고 facts에 빠뜨린 숫자는 그 숫자가 든 자료 문장을 facts에 넣고, 자료에 없는 숫자는 STAR에서 [확인 필요: 숫자]로 바꾼다. 이미 있는 카드와 같은 경험은 건너뛰고, 새 카드는 모두 verified: false로 me/experiences.yaml 맨 아래에 붙는다(붙이기 전 .jobfit/backups/에 백업). 한 번 처리한 자료는 바뀌지 않는 한 다시 하지 않는다.

직접 쓰려면 빈 카드는 8 → 4, 확인·검사는 8 → 3.

facts가 핵심이다. 초안에 나오는 숫자는 전부 그 문항에 배정된 카드의 facts에 있어야 한다. 없는 숫자(예: 계산해서 만든 "78% 개선")는 검사에서 오류가 되고, AI에게 다시 고치게 한다. 확인 전 카드(verified: false)의 숫자는 초안에서 [확인 필요]로 비워 두고, 쓰면 경고로 표시된다.

붙여넣기 모드로 쓰기

1. 메뉴 1. 공고 추가에 링크를 넣는다 — 회사명·직무·마감일을 공고 페이지에서 읽어 jobs.xlsx에 넣는다. 엑셀로 공고 시트에 직접 적어도 된다(결정·작업 열은 비워 둔다).
2. 메뉴 3. 공고 처리 진행 — 공고를 받아 정리하고 AI 단계 앞에서 멈춘다(공고 추가 직후에 바로 할지 묻는다).
3. 메뉴 10 — 프롬프트가 클립보드에 복사된다. 웹 채팅에 붙여 넣는다.
4. 답이 나오면 답 전체를 복사하고 메뉴 11 — 검사해서 받아들이고 다음 AI 단계 앞까지 진행한다. 답 앞뒤의 설명·코드블록 표시는 알아서 뗀다. 형식이 틀리면 재요청 프롬프트를 만들어 주니 다시 10번부터.
5. 공고 하나에 AI 왕복은 2~3번(분석 → 초안 → 필요하면 수정 1회).
6. 결과: output/<공고>/report.md, 전체 현황은 dashboard.xlsx. 다음 할 일은 메뉴 5.

공고를 못 받은 경우(화면을 스크립트로 그리는 사이트 · 로그인 필요 · 그림 공고)에는 브라우저에서 공고 본문을 복사해 메뉴 4.

회사 채용 사이트 — 그리팅(○○.career.greetinghr.com)·나인하이어(○○.ninehire.site) 공고는 링크만 넣어도 회사명·직무·마감일과 본문을 읽는다. 리크루터(○○.recruiter.co.kr, 대기업 공채에 많다)는 본문을 화면이 뜬 뒤 따로 불러와서 직무만 읽힌다 — 회사명을 함께 넣고(메뉴 1이 묻는다), 본문은 메뉴 4로 붙여 넣는다. LG·CJ 채용처럼 받은 페이지에 본문이 없는 회사 사이트도 붙여넣기다. 나인하이어는 마감되면 공고가 내려가서, 그때는 붙여넣기 대신 "마감돼 내려간 공고"라고 알려 준다.

자소서 문항은 공고에 원문 그대로 있을 때만 자동으로 잡힌다(지어내지 않는다). 없으면 report까지가 결과이고(문항대기), 문항이 있으면 메뉴 2. 문항 넣기로 넣는다(jobs.xlsx 문항 시트에 직접 적어도 된다 — 공고 칸에는 회사명). 넣고 나면 메뉴가 바로 이어서 진행한다.

에이전트 모드로 쓰기

Claude Code (CLI · 데스크톱 앱의 Code 탭 · VS Code)

1. 이 폴더를 연다. 처음 열 때 나오는 폴더 신뢰 창에서 신뢰를 고른다 — 그래야 .claude/settings.json의 허용 규칙(uv run jobfit … 실행, AI 답 파일 쓰기)이 적용된다. 읽기 차단(me/·공고 원문)은 신뢰 전에도 적용된다.
2. "sources에 넣은 내 자료로 경험 카드 만들어줘", "이 링크 공고 처리해줘: https://…", "새 공고 처리해줘".

Codex (CLI · 앱)

1. 이 폴더에서 연다. Codex는 AGENTS.md를 바로 읽는다.
2. 같은 말로 요청한다.
3. 샌드박스에서 uv가 캐시 폴더 오류를 내면 에이전트가 UV_CACHE_DIR=.uv-cache로 돌려 실행하도록 지침에 적혀 있다.

This is the beginning of the README. Read the rest at the original. Read the full README ↗