build-error-resolver

Build Error Resolver

빌드 에러를 체계적으로 진단하고 해결합니다.

핵심 원칙

1. 에러 메시지 정확히 파악: 전체 에러 로그 분석
2. 근본 원인 식별: 표면적 에러가 아닌 실제 원인 찾기
3. 최소 변경: 문제 해결에 필요한 최소한의 수정
4. 회귀 방지: 수정이 다른 문제를 일으키지 않는지 확인

진단 프로세스

Step 1: 에러 수집

전체 빌드 로그를 수집하여 분석 대상을 확보합니다.

Step 2: 에러 분류

1. 첫 번째 에러 식별 (cascade 에러 무시)
2. 에러 유형 분류 (의존성/타입/구문/런타임/환경)
3. 관련 파일 식별

Step 3: 컨텍스트 수집

- 에러 발생 파일 내용
- 관련 설정 파일
- 의존성 정보
- 최근 변경 사항 (git diff)

Step 4: 해결책 적용

1. 최소 변경으로 수정
2. 빌드 재실행
3. 성공 시 테스트 실행
4. 실패 시 Step 2로 복귀

에러 유형별 해결 전략 및 프레임워크별 패턴

에러 유형(의존성, 타입, 구문, 런타임, 환경)별 상세 진단 방법과 Python/FastAPI, JavaScript/TypeScript, Java/Spring Boot, Docker 에러 패턴: Read references/error-patterns.md in this skill directory.

사용 방법

빌드 에러 해결 요청

빌드 에러가 발생했습니다:
[에러 메시지 붙여넣기]

상세 진단 요청

다음 빌드 에러의 근본 원인을 분석해주세요:
[전체 빌드 로그]

문서화 (작업 완료 후 자동 실행)

작업 완료 시 auto-documenter를 호출하여 프로젝트 문서를 업데이트한다.

Completion

빌드 성공 + 테스트 통과가 확인되면 완료.

Troubleshooting

에러 메시지가 실제 원인과 다른 경우: cascade 에러를 무시하고 첫 번째 에러에 집중. 빌드 로그를 위에서부터 읽을 것. 수정 후 다른 에러 발생: 수정이 연쇄 에러를 해소했지만 숨겨져 있던 에러가 드러난 것. 정상 진행이므로 Step 2부터 재시작. 환경별로 빌드 결과가 다른 경우: Node/Python/Java 버전, OS, 환경변수 차이 확인. --verbose 플래그로 상세 로그 수집.