name: jd-batch description: This skill should be used when the user asks to "배치 처리", "JD 배치", "일괄 스크리닝", "batch screening", "URL 목록 처리", or wants to process multiple job postings at once

JD 배치 처리 스킬

여러 채용공고를 일괄 처리합니다.

Codex 실행 원칙

• 이 스킬은 resume repo 루트(/Users/teslamint/workspace/resume)에서 사용한다.
• Python 명령은 기본적으로 uv run python을 사용한다. 시스템 python3는 구버전일 수 있어 타입 힌트 문법에서 실패할 수 있다.
• URL 입력은 가능하면 통합 자동 파이프라인을 먼저 사용한다.
• 웹 자동화 fallback이 필요하면 repo 지침의 agent-browser를 사용한다.

주요 기능

1. URL 배치 처리: URL 목록에서 중복 체크 및 추출 필요 여부 판별
2. 폴더 재분류: 스크리닝 결과 기반 파일 자동 분류
3. 상태 확인: 현재 JD 분류 현황 조회

사용법

1. URL 배치 처리

# URL 목록 파일은 사용자가 제공한 파일을 쓰거나, repo 내 unprocessed/에 생성한다.
# 예: private/job_postings/unprocessed/batch_YYYYMMDD_HHMM.txt

# 통합 처리 실행 (추출 → 회사정보 → 스크리닝 → 자동 분류)
uv run python templates/jd/auto.py --from-urls <url-file>

# 중복/수동 필요 여부만 확인
uv run python templates/jd/pipeline.py --file <url-file>

출력 예시:

결과           ID         메시지
======================================================================
⏭️ duplicate  123456     이미 존재: 123456-company-position.md
📝 needs_manual 234567   추출 필요 (플랫폼: wanted)
📝 needs_manual 345678   추출 필요 (플랫폼: remember)
======================================================================
총 3건: 중복 1, 수동필요 2

2. 폴더 재분류

# 특정 폴더의 JD 파일들을 스크리닝 결과에 따라 재분류
uv run python templates/jd/pipeline.py --rescreen private/job_postings/pass/

# 미리보기 (dry-run)
uv run python templates/jd/pipeline.py --rescreen private/job_postings/pass/ --dry-run

3. 현재 상태 확인

uv run python templates/jd/pipeline.py --status

출력 예시:

📊 JD 현황
========================================
  🔴 pass                  43건
  🟢 conditional/high       5건
  🟡 conditional/hold      10건
  ✅ applied                3건
========================================
  총계: 61건

통합 파이프라인 (자동화)

URL 입력 시 채용공고 추출 → 기업 정보 추출 → 스크리닝 → 자동 분류를 한 번에 처리합니다.

파이프라인 단계

Phase 1: 중복 체크

uv run python templates/jd/pipeline.py --url "{URL}"

• duplicate → 기존 파일 경로 출력, 종료
• needs_manual → Phase 2 진행

Phase 2: JD 추출 + 회사 URL 추출

전환 정책 (2026-04-17): HTTP 우선 + browser fallback 구조. Wanted/Remember는 이미 production에서 auto.py가 사용 중인 HTTP 모듈을 직접 호출하여 15~30배 빠름. R1 감사 실측 33건 ~15초(건당 0.5초).

방법 A — HTTP 우선 (Wanted / Remember, 권장)

URL prefix로 플랫폼 판별 후 해당 경로로 분기.

Wanted (wanted.co.kr/wd/{id}):

uv run python templates/jd/wanted_extract.py <job_id>

• stdout의 JSON 결과에서 status == "ok" 확인. 아니면 → 방법 B
• 마크다운 저장: private/job_postings/unprocessed/{id}-{company}-{position}.md (자동)
• 회사 프로필 URL 조립: JSON의 company_id 또는 company_profile_url 사용 (예: company_id=15095 → wanted.co.kr/company/15095)
• 브라우저 탭 열지 않음

Remember (rememberapp.co.kr/job/posting/{id} 또는 /job/{id}):

echo "<url>" > /tmp/remember_url.txt
uv run python templates/jd/remember_batch_extract.py /tmp/remember_url.txt

• private/job_postings/unprocessed/batch_results.json에서 entry 확인 (status == "ok")
• 마크다운 저장: private/job_postings/unprocessed/{id}-{company}-{title}.md (자동)
• 회사 프로필 URL 조립: batch_results.json의 orgId 활용. 현재 규격 미검증이라 확실한 URL 조립 방법 없음 → Phase 3에서 회사명 검색 폴백 권장
• 배치 시 remember_batch_extract.py 내부에서 time.sleep(0.5) 자동 적용됨

방법 B — agent-browser fallback

방법 A 실패(status != ok, HTTP 404, 파싱 오류) 또는 Saramin / Jumpit / JobKorea 등 미지원 플랫폼일 때:

1. agent-browser open <url>
2. agent-browser snapshot -i
3. 페이지 텍스트와 링크를 확인해 채용공고 정보 파싱
4. 회사 프로필 URL 또는 회사명 추출
5. 필요 시 agent-browser로 회사 정보 검색
6. private/job_postings/unprocessed/{id}-{company}-{position}.md 저장

회사 프로필 URL 추출 DOM 셀렉터 (방법 B 전용):

• agent-browser snapshot -i 결과에서 위 selector에 해당하는 링크를 확인한다.

• 추출 성공 → URL을 Phase 3에 전달 (검색 단계 생략)

• 추출 실패 → 회사명 기반 검색으로 폴백 (Phase 3에서 처리)

경로 선택 요약

플랫폼별 참조:

• Wanted: /extract-job-posting 스킬의 Wanted 섹션 참조
• Remember: /extract-job-posting 스킬의 Remember 섹션 참조

Phase 3: 회사 정보

1. private/company_info/{company}.md 존재 확인 (Glob 사용)

2. 있으면 스킵 (기존 파일 사용)

3. 없으면 /extract-company-info 스킬 워크플로우로 풀 추출:

   a) 회사 URL 있음 (Phase 2에서 추출 성공):

   • agent-browser open <url> → 데이터 추출
   • 회사명으로 추가 플랫폼 검색 (Wanted/Remember/Saramin/TheVC 4개 소스)
   • /extract-company-info Phase 4 참조

   b) 회사 URL 없음 (Phase 2에서 추출 실패):

   • 회사명 기반 멀티소스 검색
   • /extract-company-info Phase 3 참조

   c) 데이터 병합 + 저장:

   • 필드별 우선순위 적용 (연봉: Remember > Wanted > Saramin)
   • private/company_info/{company_slug}.md 저장
   • /extract-company-info Phase 5~7 참조

   d) 검증 (필수):

   uv run python templates/jd/company_validator.py --file private/company_info/{company_slug}.md --fix
   

4. 배치 내 중복 방지: 같은 회사의 URL이 여러 건 있을 경우 첫 번째만 추출, 나머지는 기존 파일 재사용

Phase 4: 스크리닝

1. private/job_postings/jd-screening-rules.md 로드
2. private/company_info/{company}.md 로드 (있으면)
3. 6가지 기준 분석:
   • 기업 안정성
   • 연봉 구조
   • 업무 적합성
   • 개발 환경
   • 기타 우대조건
   • 채용 프로세스
4. private/jd_analysis/screening/{id}-{company}-{position}.md 저장
5. private/jd_analysis/screening/SUMMARY.md 업데이트

Phase 5: 자동 분류

uv run python templates/jd/pipeline.py --classify private/job_postings/unprocessed/

판정에 따라 자동 이동:

• 🟢 지원 추천 → private/job_postings/conditional/high/
• 🟡 지원 보류 → private/job_postings/conditional/hold/
• 🔴 지원 비추천 → private/job_postings/pass/

에러 핸들링

배치 처리

여러 URL 처리 시:

1. 각 URL에 대해 Phase 1~5 순차 실행
2. 중간 실패 시 해당 URL만 스킵, 나머지 계속
3. 최종 요약 테이블 출력:

처리 결과 요약
==================================================================================
URL                                    상태      회사정보      분류
----------------------------------------------------------------------------------
wanted.co.kr/wd/123456                ✅ 완료   ✅ 추출      conditional/high/
wanted.co.kr/wd/234567                ✅ 완료   ✅ 기존      pass/
rememberapp.co.kr/job/345678          ⏭️ 중복   -            (기존 파일)
wanted.co.kr/wd/456789                ❌ 실패   ⚠️ 실패      JD 추출 오류
==================================================================================
총 4건: 성공 2, 중복 1, 실패 1
회사 정보: 추출 1, 기존 1, 실패 1

수동 워크플로우 (개별 실행)

새 URL 일괄 처리

1. URL 목록 파일 준비
2. --file 옵션으로 중복 체크
3. needs_manual 항목에 대해 /extract-job-posting 실행
4. /extract-company-info 로 회사 정보 추출 (스크리닝 품질 향상)
5. /jd-screening 실행 (회사 정보 참조하여 분석)
6. --classify 또는 --rescreen으로 자동 분류

회사 정보가 있으면:

• 매출/인원 데이터로 회사 안정성 정확히 판단
• 연봉 데이터로 연봉 구조 리스크 확인
• 투자 정보로 스타트업 조건 충족 여부 검증

기존 파일 재분류

1. 스크리닝 결과 파일이 private/jd_analysis/screening/에 있어야 함
2. --rescreen 또는 --classify로 판정 기반 분류

분류 매핑

관련 스킬

• /extract-job-posting - 단일 URL 추출
• /jd-screening - 스크리닝 분석
• /extract-company-info - 회사 정보 수집