Batch 대규모 변경

워크플로우고급

Claude Code의 공식 번들 스킬 /batch는 대규모 코드 변경을 자동으로 처리합니다. 먼저 코드베이스를 리서치하여 변경 범위를 파악한 뒤, 5~30개의 독립적인 단위로 분해합니다. 각 단위는 별도의 git worktree에서 독립 에이전트가 처리하며, 완료 후 PR을 자동 생성합니다.

트리거/batch

사용빈도대규모 작업 시

수백 개 파일의 API 마이그레이션이 필요한 팀라면? /batch로 변경 단위를 자동 분해하고 병렬 처리

코드 표준을 전체 코드베이스에 적용하려는 테크 리드라면? /batch로 모듈별로 나눠서 한 번에 PR 생성

batch병렬 처리워크트리번들 스킬대규모

작동 흐름

/batch [변경 설명] 실행 → 코드베이스 리서치

↓

5~30개 독립 단위로 분해 + 실행 계획 생성

↓

Phase 2: 워크트리별 에이전트 병렬 실행

worktree-1

단위 1 변경 처리

worktree-2

단위 2 변경 처리

worktree-N

단위 N 변경 처리

↓

✓ 단위별 PR 자동 생성 + 변경 요약

스킬 코드

# Batch Orchestrator — Built-in Bundled Skill
## Trigger: /batch [change description]

Claude Code's official bundled skill for large-scale codebase changes.

### Workflow:

1. Research phase:
  - Scan codebase for affected files
  - Identify dependencies and impact scope
  - Map change boundaries

2. Decomposition:
  - Split into 5-30 independent units
  - Ensure each unit is self-contained
  - Generate execution plan with ordering

3. Parallel execution (git worktrees):
```bash
# Each unit runs in its own worktree
.claude/worktrees/batch-unit-1/
.claude/worktrees/batch-unit-2/
.claude/worktrees/batch-unit-N/

# Each agent:
# 1. Creates a branch
# 2. Applies changes
# 3. Runs tests
# 4. Creates a PR
```

4. Post-processing:
  - Collect results from all worktrees
  - Report success/failure per unit
  - Generate summary with PR links

### Key features:
- Automatic conflict detection between units
- Shared memory across worktrees (v2.1.63+)
- Resume capability for failed units
- Dry-run mode for preview

### SKILL.md structure:
```yaml
---
name: batch
description: Research codebase, decompose, and parallelize changes
```

복사해서 CLAUDE.md에 붙여넣으면 바로 사용할 수 있습니다.