배치 생성 완전 자동화 가이드

가이드 문서

# pullh 데이터 확장 가이드

## 사전 조건
```bash
# 환경 변수 설정
export ANTHROPIC_API_KEY="sk-ant-..."
# 또는
export OPENAI_API_KEY="sk-..."

# 의존성 설치
pip install anthropic openai
npm install
```

## 1단계: 현재 상태 확인
```bash
node scripts/dashboard.js
```

## 2단계: 언어 선택 및 범위 결정
- kotlin.js 현재 마지막 ID 확인: grep "id: 'k-" data/kotlin.js | tail -5
- 다음 번호 확인 후 START/END 결정

## 3단계: 항목 생성
```bash
# Anthropic Claude API 사용
python3 scripts/generate.py --lang kotlin --start 33 --end 52

# 또는 OpenAI GPT-4o 사용
python3 scripts/generate.py --lang kotlin --start 33 --end 52 --provider openai
```

## 4단계: 품질 검증
```bash
# 생성된 파일 개별 검증
ls data/generated/kotlin_*.json

# JSON 유효성 확인
for f in data/generated/kotlin_*.json; do
  python3 -c "import json; json.load(open('$f'))" && echo "✅ $f" || echo "❌ $f"
done
```

## 5단계: 기존 파일에 병합
```bash
node scripts/merge.js kotlin 33 52
```

## 6단계: 최종 검증
```bash
node scripts/validate.js kotlin
node scripts/dashboard.js
```

## 7단계: 사이트맵 업데이트
```bash
node scripts/sitemap.js > sitemap.xml
```

## 8단계: PR 생성
```bash
git checkout -b feat/add-kotlin-33-52
git add data/kotlin.js sitemap.xml
git commit -m "feat(data): Kotlin 항목 k-033~k-052 추가 (20개)"
git push origin feat/add-kotlin-33-52
```

## 자주 발생하는 문제 해결

### JSON 파싱 오류
LLM이 마크다운 코드블록(```json)을 포함하는 경우:
```python
text = text.strip()
if text.startswith('```'):
    text = text.split('```')[1]
    if text.startswith('json'):
        text = text[4:]
```

### 중복 ID 오류
```bash
node -e "
  const items = require('./data/kotlin.js'); // window.DATA.kotlin.items
  const ids = items.map(i => i.id);
  const dups = ids.filter((id, i) => ids.indexOf(id) !== i);
  console.log('중복:', dups);
"
```

### 레이트 리밋
generate.py의 --delay 옵션을 1.0 이상으로 설정하거나
--parallel 옵션을 1로 낮추세요.