Nomik94
@Nomik94
Public Skills
audit
by Nomik94
Use when: 프로젝트 규칙 검증, 커스텀 린트, 커밋 전 검사, audit, 규칙 위반 체크, 프로젝트 컨벤션 확인, 배포 전 검증. NOT for: 일반 린트 (ruff/mypy가 처리), 보안 감사 (security-audit 참조).
api-design
by Nomik94
RESTful API 설계 및 버저닝 패턴 레퍼런스. Use when: API 설계, REST API, 엔드포인트 설계, URL 설계, HTTP 메서드, 리소스 네이밍, 상태 코드, 필터링, 정렬, 검색, API 응답 구조, 벌크 작업, idempotency, API 컨벤션, API 버전 관리, v1/v2 경로 설정, 버전 올리기, 버전 분리, EndpointPath 헬퍼 사용법, 엔드포인트 경로 규칙, 하드코딩 경로 금지, admin/app/web 분리, Sub-Application, 클라이언트별 Swagger, 클라이언트별 미들웨어, app.mount, 서브앱 구조, deprecated API, sunset, deprecation 처리. 파라미터 클래스, Depends 파라미터, PaginationParams, PathParams, Query/Path 파라미터 묶기, 파라미터 재사용, 핸들러 시그니처 정리, controllers 폴더, controller 파일 구조, admin_controller, app_controller. NOT for: Pydantic 스키마 (pydantic-schema 참조), 에러 핸들링 설계 (error-handling 참조).
docs
by Nomik94
Technical Writer 에이전트 스폰. Use when: /docs, README 작성해줘, API 문서화, 문서 써줘, 기술 문서, ADR 작성, 변경 로그 생성, 온보딩 문서, 사용자 가이드, 인프라 문서, 시스템 설계 문서, 런북 작성, 아키텍처 문서. NOT for: 코드 주석 추가, 단순 docstring 작성.
fastapi
by Nomik94
FastAPI 프로젝트 고유 설정 및 패턴 레퍼런스. Use when: 프로젝트 구조 잡기, 폴더 구조, 디렉토리 구조, 초기 세팅, 새 프로젝트 시작, 파일 분리, 파일이 너무 커, 폴더로 변환, 파일 비대, 모듈 분리, 패키지 분리, DI 패턴 선택, 의존성 주입, Depends vs Container vs Dishka, Ruff 설정, mypy 설정, 린터 세팅, 포맷터 세팅, pre-commit 설정, import-linter, App Factory, create_app, lifespan, pydantic-settings, 환경변수 설정, config 구조, 레이어 분리, controllers/service/repository 구조, 도메인 레이어 도입 기준. NOT for: 단순 FastAPI 문법 질문 (Claude가 이미 앎), 일반적인 Ruff/mypy 사용법.
confidence-check
by Nomik94
구현 전 신뢰도 평가. 구현 시작 전에 자동 실행. Use when: 구현, 만들어줘, 추가해줘, implement, create, add, 개발해줘, 코드 작성. NOT for: 단순 오타 수정, 주석 추가, 포맷팅.
docker
by Nomik94
FastAPI + Poetry Docker 설정 레퍼런스. Use when: Dockerfile 작성, Dockerfile 수정, docker-compose 설정, compose 세팅, 이미지 빌드, 멀티스테이지 빌드, 이미지 최적화, 이미지 크기 줄이기, 로컬 개발환경 구성, 개발환경 Docker로, DB/Redis 컨테이너, 배포 준비, 컨테이너화, healthcheck 설정, non-root 유저, .dockerignore, 레이어 캐싱, Poetry Docker 설치. NOT for: Kubernetes, 클라우드 배포 (그건 일반 지식).
debugging
by Nomik94
Python/FastAPI 디버깅 도구 및 기법 레퍼런스. Use when: 디버깅, 버그 찾기, 에러 추적, 왜 안 돼, 문제 해결, print 디버깅, pdb, breakpoint, 로그 추적, 쿼리 확인, 스택 트레이스, traceback, 에러 재현, 느린 원인, 메모리 누수, 프로파일링, 비동기 디버깅, async 에러. NOT for: 에러 핸들링 설계 (error-handling 참조), 성능 최적화 전략 (monitoring 참조).
cicd
by Nomik94
프로젝트 CI/CD 파이프라인 레퍼런스. Use when: GitHub Actions 작성, 워크플로우 만들기, CI 파이프라인 구성, 자동 배포 설정, PR 검증 자동화, 린트 자동화, 테스트 자동화, quality gate 설정, 커버리지 임계값, 품질 기준, Alembic CI 마이그레이션 검증, 마이그레이션 체크, pip-audit, 보안 스캔 CI, ruff CI, mypy CI, import-linter CI, vulture CI, deptry CI, Conventional Commits CI, Docker 빌드 CI, 이미지 푸시 자동화. NOT for: GitHub Actions 일반 문법 (그건 Claude가 이미 앎).
error-handling
by Nomik94
FastAPI 에러 핸들링 패턴 레퍼런스. Use when: 예외 처리, 에러 핸들러, exception handler, 에러 응답, 커스텀 예외, 도메인 예외를 HTTP로 매핑, 전역 에러 핸들링, ValidationError 처리, 404 Not Found, 비즈니스 예외, 에러 코드 체계, 에러 로깅, 예외 계층 설계, mappings.py, DOMAIN_EXCEPTION_MAPPINGS, ErrorBody, @transactional, @retry, @log_execution. NOT for: 보안 관련 예외 (security-audit 참조).
production-checklist
by Nomik94
프로덕션 배포 전 체크리스트. Use when: 배포, 프로덕션, production, deploy, 릴리즈, release, 라이브, 런칭, go-live, 배포 전 확인, 운영 환경. NOT for: 로컬 개발 환경 설정.
devops
by Nomik94
DevOps Architect 에이전트 스폰. Use when: /devops, CI/CD 구축해줘, 배포 설정, Docker 설계, 인프라 자동화, 무중단 배포, 모니터링 설정, GitHub Actions 설계. NOT for: 단순 Dockerfile 작성 (docker skill 참조), 기본 docker-compose.
code-review
by Nomik94
Code Reviewer 에이전트 스폰. Use when: /code-review, 코드 리뷰해줘, PR 리뷰, 리뷰해줘, 코드 품질 점검, 리팩토링 방향, 기술 부채 식별, 코드 스멜. NOT for: 단순 포맷팅, 오타 수정.
python-best-practices
by Nomik94
Python 코드 리뷰 및 베스트 프랙티스 검증. Use when: /python-best-practices, 코드 품질 분석, .py 파일 리뷰, 타입 힌트 검증, 린팅, 테스트 커버리지 분석, 의존성 점검. NOT for: 아키텍처 리뷰 (/code-review), 보안 전문 분석 (/security-audit).
verify
by Nomik94
구현 완료 후 품질 검증. 완료 선언 시 자동 실행. Use when: 완료, 끝, done, finished, PR, 커밋, 다 됐어, 마무리. NOT for: 중간 진행 상황 확인.
middleware
by Nomik94
FastAPI 미들웨어 및 cross-cutting decorator 패턴 레퍼런스. Use when: 미들웨어 추가/순서 설정, CORS 설정, 요청 로깅, rate limiting, X-Request-ID 주입, 요청 시간 측정, @transactional/@retry/@log_execution decorator 적용, sub-application별 미들웨어 분리. NOT for: 라우터 레벨 의존성 (Depends 사용), 예외 핸들러 등록.
domain-layer
by Nomik94
Domain Layer 설계 및 구현 가이드. Use when: Entity/Value Object/Aggregate Root 설계, 도메인 이벤트 구현, 비즈니스 로직 배치 판단, Repository Protocol 정의, Domain vs Application Service 구분, 상태 전이 로직, 도메인 예외 설계, 서비스 비대화 해결, 로직 분리. NOT for: 단순 CRUD (비즈니스 규칙 없으면 domain layer 불필요), SQLAlchemy 모델 작성, 단순 dataclass 문법.
engineer
by Nomik94
Engineer 에이전트 스폰. Use when: /engineer, 설계해줘, 구현해줘, API 설계, DB 스키마, 시스템 설계, 아키텍처, TDD로 만들어줘, SOLID 적용, 성능 최적화해줘, 보안 구현, 느려, 병목, N+1, 커버리지 분석, 프로덕션 코드, 확장성 설계. NOT for: 단순 1줄 수정, 오타 수정, 코드 리뷰 (/code-review), 버그 분석 (/root-cause).
root-cause
by Nomik94
Root Cause Analyst 에이전트 스폰. Use when: /root-cause, 버그 원인 찾아줘, 왜 안 돼, 이상 현상, 간헐적 에러, 재현 어려운 문제, 원인 분석, 디버깅 도와줘. NOT for: 단순 에러 메시지 해석, 기본적인 typo 수정.
note
by Nomik94
컴팩션에서 살아남는 영구 메모 시스템. 긴 세션에서 중요 컨텍스트 손실 방지.
pydantic-schema
by Nomik94
Pydantic v2 DTO/스키마 설계 패턴. Use when: 요청/응답 DTO, CamelModel, dto/ 폴더 구조, camelCase 변환, alias_generator, model_config, 검증 로직, field_validator, model_validator, partial update (apply_simple_fields), 페이지네이션 응답, 에러 응답 (ErrorBody), from_domain 팩토리, Pydantic BaseModel 설정, JSON 직렬화. NOT for: 도메인 엔티티 (domain-layer), DB 모델 (sqlalchemy).
security-audit
by Nomik94
프로젝트 보안 패턴, JWT 인증, RBAC, 예외 처리 레퍼런스. Use when: 로그인 구현, 인증 구현, JWT 토큰 발급, 액세스 토큰, 리프레시 토큰, Refresh Token Rotation, 토큰 블랙리스트, Redis 토큰 저장소, 권한 관리, RBAC 설정, 역할 기반 접근제어, require_roles, Role vs UserRole, 예외 처리 설계, UnauthorizedException, ForbiddenException, mappings.py, 패스워드 해싱, 비밀번호 암호화, bcrypt, HashedPassword, 보안 점검, 보안 체크리스트, 취약점 확인, OWASP, 코드 감사, CORS 설정, rate limiting, 에러 응답에 민감정보 노출. NOT for: 일반적인 HTTP 상태코드 의미, OAuth2 프로바이더 연동.
testing
by Nomik94
프로젝트 테스트 패턴 레퍼런스. Use when: 테스트 작성, 테스트 코드 짜기, 테스트 구조 잡기, 테스트 어떻게 써, conftest 설정, 픽스처 만들기, fixture 구성, db_session 픽스처, 도메인 유닛 테스트, 서비스 테스트, mock repository, AsyncMock, 통합 테스트, API 테스트, httpx AsyncClient, TestClient, testcontainers, 실제 PostgreSQL 테스트, 테스트 DB, 커버리지, coverage 설정, pytest 설정, asyncio_mode, 테스트 격리, 트랜잭션 롤백, 테스트별 독립. NOT for: pytest 기본 문법, assert 사용법.
sqlalchemy
by Nomik94
SQLAlchemy 2.0 async infrastructure pattern reference. Use when: DB model definition, Base model setup, table mapping, relationship config, session management, AsyncSession, sessionmaker, connection pool, query patterns (select, join, subquery, pagination), Mixin (Timestamp, SoftDelete), N+1 prevention (selectinload, joinedload), transaction management, nested transaction, savepoint, generic repository pattern, BaseRepository[ModelType]. NOT for: domain entity design (domain-layer skill), Alembic migrations.
alembic
by Nomik94
Alembic DB 마이그레이션 패턴 레퍼런스. Use when: 마이그레이션 생성, DB 스키마 변경, 테이블 추가, 컬럼 변경, alembic revision, autogenerate, downgrade, 롤백, 마이그레이션 이력, 데이터 마이그레이션, bulk data update, 인덱스 추가, 외래키 변경, alembic.ini 설정, env.py 설정, 마이그레이션 충돌 해결. NOT for: SQLAlchemy 모델 정의, ORM 쿼리 패턴.
background-tasks
by Nomik94
백그라운드 작업 패턴 레퍼런스. Use when: 백그라운드 작업, 비동기 작업, Celery, 이메일 발송, 무거운 작업, 큐, task queue, 작업 스케줄링, periodic task, BackgroundTasks, worker, 작업 재시도, retry, dead letter. NOT for: 단순 async/await (FastAPI 기본 비동기).
build-fix
by Nomik94
빌드/린트 에러 자동 수정. Use when: ruff error, mypy error, TypeError, ImportError, SyntaxError, Build failed, 빌드 실패, 린트 에러, 타입 에러, ModuleNotFoundError. NOT for: 런타임 로직 버그, 비즈니스 로직 에러.
checkpoint
by Nomik94
Use when: 리팩토링, 삭제, 마이그레이션, 대규모 변경, 위험한 작업, 파일 삭제, 코어 변경, 스키마 변경, 구조 변경. NOT for: 단순 수정, 새 파일 추가, 테스트 추가.
feature-planner
by Nomik94
Use when: 기능 구현 계획, 구현 전 설계, 스코프 정의, 작업 분해, 3개 이상 파일 변경, 기능 추가, feature planning, 구현 어떻게 할까, 큰 작업, 복잡한 기능, 어디부터 시작, 작업 순서. NOT for: 단순 버그 수정, 1-2 파일 변경, 오타 수정.
gap-analysis
by Nomik94
Use when: 설계 vs 구현 비교, 스펙 검증, 요구사항 충족 확인, gap analysis, 구현 빠진 거 없나, 설계대로 했나, match rate. NOT for: 코드 품질 리뷰 (code-reviewer 참조).
learn
by Nomik94
Use when: 문제 해결 후, 디버깅 성공, 패턴 발견, 기억해둘 것, 나중에 또 나올 수 있는, 해결했다, 찾았다, root cause 발견. NOT for: 일반 지식, 공식 문서에 있는 내용, 단순 오타.
monitoring
by Nomik94
Datadog 기반 모니터링, APM, 로깅, 캐싱, 스케줄링 패턴 레퍼런스. Use when: Datadog 설정, APM 트레이싱, ddtrace 설정, 트레이스 연결, 로그 설정, structlog 설정, JSON 로그, 로그 포맷, Datadog 로그 수집, 헬스체크 엔드포인트, /health 만들기, 상태 확인 API, 커스텀 메트릭, DogStatsD, 요청 추적, request ID, X-Request-ID, 요청 로깅 미들웨어, 응답 시간 측정, RequestLoggingMiddleware, 캐시 설정, 캐시 전략, cashews 캐시, redis 캐시, 캐시 무효화, TTL 설정, 스케줄링, 정기 작업, 크론잡, APScheduler, BackgroundTasks, Celery 워커. NOT for: Prometheus 설정, Grafana 대시보드, 일반 Redis 사용법.
environment
by Nomik94
환경 설정 및 pydantic-settings 패턴. Use when: 환경변수, .env 파일, 설정 관리, pydantic-settings, Settings 클래스, 환경별 설정, local/dev/staging/prod 분리, env_nested_delimiter, 시크릿 관리, 설정 검증. NOT for: Docker 환경변수 (docker skill 참조).
websocket
by Nomik94
FastAPI WebSocket í¨í´ ë í¼ë°ì¤. Use when: ì¹ìì¼, WebSocket, ì¤ìê°, ì±í , ì림, ì¤ìê° íµì , ws ì°ê²°, ìë°©í¥ íµì , ë¸ë¡ëìºì¤í¸, ìì¼, pub/sub. NOT for: HTTP API (fastapi skill 참조), SSE.