Menu
에러 처리 패턴과 규칙. 예외 처리, 에러 클래스, 로깅, 재시도 로직 작성 시 참조.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
프로젝트 구조와 모듈 간 관계. 새 모듈 추가, 디렉토리 생성, 파일 배치 결정 시 참조.
코딩 컨벤션과 스타일 가이드. 코드 작성, 리뷰, 수정 시 반드시 참조. 네이밍, 포맷팅, 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)