Agent skill
build-error-resolver
빌드 에러, 빌드 오류, 컴파일 에러, 빌드 실패 해결, 의존성 에러 - Specialized in resolving build errors, compilation failures, and dependency issues. Use when build fails, compilation errors occur, or dependency conflicts arise. Do NOT use for runtime bugs or logic errors (use debug-specialist instead).
Install this agent skill to your Project
npx add-skill https://github.com/aimskr/aims-claude-toolkit/tree/main/skills/build-error-resolver
Metadata
Additional technical details for this skill
- author
- jaehashin
- version
- 1.2.0
SKILL.md
Build Error Resolver
빌드 에러를 체계적으로 진단하고 해결합니다.
핵심 원칙
- 에러 메시지 정확히 파악: 전체 에러 로그 분석
- 근본 원인 식별: 표면적 에러가 아닌 실제 원인 찾기
- 최소 변경: 문제 해결에 필요한 최소한의 수정
- 회귀 방지: 수정이 다른 문제를 일으키지 않는지 확인
진단 프로세스
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 플래그로 상세 로그 수집.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
brainstorming
브레인스토밍, 아이디어, 기획, 구상, 아이디어회의, 설계, 요구사항 분석, 접근법 탐색 - Use before creating new features or significant changes to explore user intent, requirements, and design options. Collaborative brainstorming through step-by-step questioning. Do NOT use for simple bug fixes, config changes, or tasks with clear requirements already defined.
doc-coauthoring
문서 작성, 문서화, 문서, 스펙 작성, 기술 문서, 제안서, RFC, 설계 문서, 의사결정 문서 - Collaborative document co-authoring through 3 stages: context gathering, iterative refinement, and reader testing. Use when writing docs, proposals, tech specs, decision docs, or RFCs. Do NOT use for PRD/product requirements (use prd-strategist) or implementation plans (use writing-plans).
testing-strategy
테스트 전략, 테스팅 계획, QA 전략, 품질 보증, 테스트 피라미드, 테스트 시나리오, 커버리지 목표 - Designs test strategies including test pyramid ratios, scenario categories, and coverage targets. Use when planning how to test a feature, designing QA approach, or creating test plans. Do NOT use for TDD implementation (use tdd-workflow) or E2E test execution (use e2e-runner).
learning-research
학습 리서치, 학습 자료, 공부 자료, 학습, 공부, 스터디, 개념 정리, 이해 - 특정 주제를 깊이 이해하기 위한 학습 자료를 수집·정리한다. 병렬 전문가 서브에이전트로 개념, 원리, 실습, 심화 자료를 수집하고 이해도별로 체계화된 학습 노트를 생성한다. Obsidian vault에 자동 저장. 의사결정용 자료 조사는 research 스킬을, 시장조사는 market-research 스킬을 사용할 것.
devil-advocate
ui-ux-design
UI, UX, 디자인, UI 디자인, UX 디자인, 사용자 경험, 화면, 인터랙션, 라이브 리뷰, 와이어프레임, 화면 설계 - Create and review UI/UX designs with live browser testing. Use for design implementation, interaction testing, visual inspection, and iterative refinement with Playwright. Also triggered when continuing from prd-strategist's Design Direction output.
Didn't find tool you were looking for?