빌드 및 수정

언제 쓰나

빌드 오류를 해결하거나 프로젝트의 안정성을 높일 때 사용합니다.

---
description: 프로젝트 빌드 시스템을 감지하고 최소한의 안전한 변경으로 빌드/타입 오류를 점진적으로 수정합니다.
---

# 빌드 및 수정

최소한의 안전한 변경으로 빌드 및 타입 오류를 점진적으로 수정합니다.

## 단계 1: 빌드 시스템 감지

프로젝트의 빌드 도구를 식별하고 빌드를 실행합니다:

| 지표 | 빌드 명령 |
|-----------|---------------|
| `package.json`에 `build` 스크립트가 있는 경우 | `npm run build` 또는 `pnpm build` |
| `tsconfig.json` (TypeScript 전용) | `npx tsc --noEmit` |
| `Cargo.toml` | `cargo build 2>&1` |
| `pom.xml` | `mvn compile` |
| `build.gradle` | `./gradlew compileJava` |
| `go.mod` | `go build ./...` |
| `pyproject.toml` | `python -m compileall -q .` 또는 `mypy .` |

## 단계 2: 오류 구문 분석 및 그룹화

1. 빌드 명령을 실행하고 stderr를 캡처합니다.
2. 오류를 파일 경로별로 그룹화합니다.
3. 의존성 순서대로 정렬합니다 (논리 오류 전에 가져오기/타입 수정).
4. 진행 상황 추적을 위해 총 오류 수를 계산합니다.

## 단계 3: 수정 루프 (한 번에 오류 하나씩)

각 오류에 대해:

1. **파일 읽기** — Read 도구를 사용하여 오류 컨텍스트(오류 주변 10줄)를 확인합니다.
2. **진단** — 근본 원인(누락된 가져오기, 잘못된 타입, 구문 오류)을 식별합니다.
3. **최소한으로 수정** — Edit 도구를 사용하여 오류를 해결하는 가장 작은 변경을 적용합니다.
4. **빌드 재실행** — 오류가 사라졌고 새로운 오류가 발생하지 않았는지 확인합니다.
5. **다음으로 이동** — 남은 오류를 계속 처리합니다.

## 단계 4: 안전 장치

다음과 같은 경우 사용자에게 중지하고 질문합니다:

- 수정으로 인해 해결된 것보다 **더 많은 오류가 발생하는 경우**
- **3번의 시도 후에도 동일한 오류가 지속되는 경우** (더 깊은 문제일 가능성 높음)
- 수정에 **아키텍처 변경**이 필요한 경우 (빌드 수정 이상의 경우)
- 빌드 오류가 **누락된 종속성**에서 비롯된 경우 (`npm install`, `cargo add` 등 필요)

## 단계 5: 요약

결과를 표시합니다:

- 수정된 오류 (파일 경로 포함)
- 남은 오류 (있는 경우)
- 발생한 새 오류 (0이어야 함)
- 해결되지 않은 문제에 대한 제안된 다음 단계

## 복구 전략

| 상황 | 조치 |
|-----------|--------|
| 누락된 모듈/가져오기 | 패키지가 설치되었는지 확인하고 설치 명령 제안 |
| 타입 불일치 | 두 타입 정의를 읽고 더 좁은 타입을 수정 |
| 순환 종속성 | 가져오기 그래프로 주기를 식별하고 추출 제안 |
| 버전 충돌 | `package.json` / `Cargo.toml`에서 버전 제약 조건 확인 |
| 빌드 도구 misconfiguration | 구성 파일을 읽고 작동하는 기본값과 비교 |

안전을 위해 한 번에 하나의 오류를 수정합니다. 리팩토링보다 최소한의 diff를 선호합니다.

1. 1

   SKILL.md 저장

   아래 버튼으로 복사 → 다음 경로로 저장.

   SKILL.md 복사

   macOSLinuxWindows

   ~/.claude/skills/everything-claude-code-104/SKILL.md경로 복사
2. 2

   호출

   Claude Code 채팅창에서 자연어로 부르면 자동 발동:

   예) 빌드 오류를 해결하거나 프로젝트의 안정성을 높일 때 사용합니다

   트리거가 안 잡히면 SKILL.md의 description 줄에 더 구체적인 한국어 키워드를 추가해보세요.