에러 처리 패턴과 규칙. 예외 처리, 에러 클래스, 로깅, 재시도 로직 작성 시 참조.
npx skills add https://github.com/uygnoey/autonomous-dev-agent --skill error-handling이 명령을 Claude Code에 복사하여 붙여넣어 스킬을 설치하세요
프로젝트 구조와 모듈 간 관계. 새 모듈 추가, 디렉토리 생성, 파일 배치 결정 시 참조.
코딩 컨벤션과 스타일 가이드. 코드 작성, 리뷰, 수정 시 반드시 참조. 네이밍, 포맷팅, import 순서, 주석 규칙 등.
프로젝트의 디자인 패턴과 아키텍처 규칙. 코드 작성, 리팩토링, 새 모듈 생성, 구조 결정 시 반드시 참조. 새 파일을 만들기 전에 이 스킬을 먼저 읽을 것.
기존 코드베이스에서 유사 패턴이나 구현을 찾을 때 사용. 새 코드 작성 전에 기존 코드를 먼저 검색하여 일관성 유지.
테스트 작성 전략과 규칙. 테스트 코드 작성, 테스트 실행, 커버리지 확인 시 참조. 테스트 100% 통과가 목표.
| name | error-handling |
| description | 에러 처리 패턴과 규칙. 예외 처리, 에러 클래스, 로깅, 재시도 로직 작성 시 참조. |
# errors/base.py
class AppError(Exception):
"""애플리케이션 기본 에러."""
def __init__(self, message: str, code: str = "UNKNOWN"):
self.message = message
self.code = code
super().__init__(self.message)
class NotFoundError(AppError):
"""리소스를 찾을 수 없음."""
def __init__(self, resource: str, identifier: str):
super().__init__(
message=f"{resource} '{identifier}' not found",
code="NOT_FOUND"
)
class ValidationError(AppError):
"""입력 검증 실패."""
def __init__(self, field: str, reason: str):
super().__init__(
message=f"Validation failed for '{field}': {reason}",
code="VALIDATION_ERROR"
)
class ConflictError(AppError):
"""리소스 충돌."""
def __init__(self, message: str):
super().__init__(message=message, code="CONFLICT")
class ExternalServiceError(AppError):
"""외부 서비스 호출 실패."""
def __init__(self, service: str, reason: str):
super().__init__(
message=f"External service '{service}' failed: {reason}",
code="EXTERNAL_ERROR"
)
import asyncio
async def retry_with_backoff(
func,
max_retries: int = 3,
base_delay: float = 1.0,
max_delay: float = 30.0,
):
"""지수 백오프 재시도."""
for attempt in range(max_retries):
try:
return await func()
except Exception as e:
if attempt == max_retries - 1:
raise
delay = min(base_delay * (2 ** attempt), max_delay)
logger.warning(f"Retry {attempt + 1}/{max_retries} after {delay}s: {e}")
await asyncio.sleep(delay)