/build-fix (빌드 수정)
다운로드 후
~/.claude/commands/ 폴더에 복사하여 사용하세요TypeScript 및 빌드 오류를 점진적으로 수정.
🔧
build-error-resolver 에이전트를 호출하여 빌드 오류를 해결합니다.
이 커맨드가 하는 일
- 빌드 실행:
npm run build또는pnpm build - 오류 출력 파싱 (파일별 그룹화, 심각도별 정렬)
- 각 오류에 대해:
- 오류 컨텍스트 표시 (전후 5줄)
- 문제 설명
- 수정 제안
- 수정 적용
- 빌드 재실행
- 오류 해결 확인
- 요약 표시
중지 조건
- 수정이 새 오류를 유발
- 3번 시도 후에도 같은 오류 지속
- 사용자가 중지 요청
사용 예시
# 빌드 오류 발생 시
/build-fix
# 출력 예시
## 빌드 오류 분석
### 발견된 오류: 5개
1. [TypeScript] src/api/client.ts:42
오류: 'user' 매개변수가 암시적으로 'any' 타입입니다
수정: 타입 어노테이션 추가
적용 중...
✅ 해결됨
2. [TypeScript] src/components/Button.tsx:15
오류: 'onClick' 속성이 'ButtonProps' 타입에 없습니다
수정: 인터페이스에 속성 추가
적용 중...
✅ 해결됨
...
## 요약
- 수정된 오류: 5
- 남은 오류: 0
- 새로 발생한 오류: 0
✅ 빌드 성공!일반적인 오류 패턴
타입 추론 실패
// ❌ 오류
function process(data) { ... }
// ✅ 수정
function process(data: DataType) { ... }Null/Undefined 오류
// ❌ 오류
const name = user.name.toUpperCase()
// ✅ 수정
const name = user?.name?.toUpperCase()임포트 오류
// ❌ 오류
import { util } from '@/lib/utils'
// ✅ 수정 (tsconfig 경로 확인 또는 상대 경로 사용)
import { util } from '../lib/utils'모범 사례
- ✅ 한 번에 하나의 오류만 수정
- ✅ 각 수정 후 빌드 재실행
- ✅ 최소한의 변경으로 수정
- ❌ 관련 없는 코드 리팩토링 금지
- ❌ 아키텍처 변경 금지
⚠️
안전을 위해 한 번에 하나의 오류만 수정! 여러 오류를 한 번에 수정하면 새로운 문제가 발생할 수 있습니다.