---
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 배치 처리

```bash
# 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. 폴더 재분류

```bash
# 특정 폴더의 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. 현재 상태 확인

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

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

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

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

### 파이프라인 단계

| Phase | 작업 | 도구 |
|-------|------|------|
| 1 | URL 처리/중복 체크 | `auto.py --from-urls` 또는 `pipeline.py --url` |
| 2 | JD 추출 + 회사 URL 추출 | HTTP extractor 우선, 필요 시 agent-browser fallback |
| 3 | 회사 정보 | `private/company_info/` 확인 → 없으면 자동 파이프라인 또는 agent-browser 검색 |
| 4 | 스크리닝 | jd-screening-rules.md 로드 → LLM 분석 |
| 5 | 자동 분류 | `pipeline.py --classify` |

### Phase 1: 중복 체크

```bash
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}`):

```bash
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}`):

```bash
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 전용):**

| 플랫폼 | CSS Selector | 추출 URL 형태 |
|--------|-------------|--------------|
| Wanted | `a[href*="/company/"]` | `wanted.co.kr/company/{id}` (방법 A 실패 시에만 사용) |
| Remember | `a[href*="/job/company/"]` | `career.rememberapp.co.kr/job/company/{id}` |
| Saramin | `a[href*="/company-info/view"]` | `saramin.co.kr/zf_user/company-info/view?csn={csn}` |
| Jumpit / JobKorea | (프로필 링크 없음) | 회사명만 파싱 → Phase 3 검색 폴백 |

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

- 추출 성공 → URL을 Phase 3에 전달 (검색 단계 생략)
- 추출 실패 → 회사명 기반 검색으로 폴백 (Phase 3에서 처리)

#### 경로 선택 요약

| 플랫폼 | 기본 경로 | 비고 |
|--------|-----------|------|
| Wanted | 방법 A | company_id JSON 포함, 회사 URL 조립 가능 |
| Remember | 방법 A | 회사 URL 조립은 Phase 3에서 처리 |
| Saramin | 방법 B | anti-bot/CSR |
| Jumpit, JobKorea, GroupBy | 방법 B 또는 기타 CLI | 현행 유지 |

**플랫폼별 참조:**
- 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) 검증 (필수)**:
   ```bash
   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: 자동 분류

```bash
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/`

### 에러 핸들링

| 상황 | 처리 |
|------|------|
| 방법 A (HTTP) 추출 실패 (status != ok) | 방법 B agent-browser fallback 진입 |
| JD 추출 실패 (방법 B도 실패) | 사용자에게 수동 입력 요청, 해당 URL 스킵 |
| 회사 프로필 URL 추출 실패 | 회사명 기반 멀티소스 검색으로 폴백 (Phase 3b) |
| 회사 정보 추출 실패 (플랫폼 장애/네트워크 오류/로그인·접근 제한 등 불가항력) | 경고 출력 후 제한된 정보로 스크리닝 계속 가능 |
| 회사 정보 미수집/저완성도 (기존 스텁, `정보 없음` 다수, 검색·추출 미완료) | 스크리닝 중단, `company_info_incomplete`로 보류 |
| 회사 정보 검증 실패 (파싱 오류 등 불가항력) | 불완전 데이터로 진행 가능하되 누락 필드 명시 |
| 회사 정보 검증 결과 기준 미달 | 스크리닝 중단, 회사 정보 보완 후 재시도 |
| 스크리닝 실패 | `private/job_postings/conditional/hold/`로 기본 분류 |
| agent-browser 연결 실패 | 브라우저 상태 확인 후 대기 |

### 배치 처리

여러 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`로 판정 기반 분류

## 분류 매핑

| 판정 | 대상 폴더 |
|------|----------|
| 🟢 지원 추천 | `private/job_postings/conditional/high/` |
| 🟡 지원 보류 | `private/job_postings/conditional/hold/` |
| 🔴 지원 비추천 | `private/job_postings/pass/` |

## 관련 스킬

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