backend-fastapi-python skill
✓ 인증됨FastAPI, SQLModel, async SQLAlchemy를 사용하여 서비스, 인증 및 에러 핸들링 패턴이 적용된 Python 백엔드를 개발합니다.
- GitHub 스타
- 126
- 파일
- 12
- 마지막 커밋
- 2026년 5월 16일
- 라이선스
- MIT
- 허용된 도구
- —
backend-fastapi-python skill은 무엇을 하나요?
FastAPI, SQLModel, async SQLAlchemy를 사용하여 서비스, 인증 및 에러 핸들링 패턴이 적용된 Python 백엔드를 개발합니다.
skill의 SKILL.md에서 생성된 요약입니다.
backend-fastapi-python skill 정보
FastAPI, SQLModel, async SQLAlchemy를 사용하여 Python 백엔드를 구축하는 것이 이 SKILL의 주요 기능입니다. 개발자는 이를 사용하여 API 엔드포인트를 구축하고, stateless 서비스 함수를 작성하며, Pydantic 또는 SQLModel 스키마를 정의합니다. 특히 get_current_user 및 is_superuser와 같은 인증 의존성 체인 설정, async SQLAlchemy 세션 관리, Alembic 마이그레이션 처리 등 백엔드 아키텍처 작업에 최적화되어 있습니다.
에이전트는 Python API 코드, 요청/응답 설계 또는 이 코드베이스 내의 백엔드 패턴과 관련된 작업을 수행할 때 이 SKILL을 로드해야 합니다. ApiResponse[T] 래퍼 사용 및 에러 코드를 위한 AppException 구현과 같은 특정 프로젝트 컨벤션에 대한 가이드를 제공합니다. 또한 selectinload를 통한 N+1 쿼리 방지, 백그라운드 작업 관리, 올바른 Pydantic V2 validator 사용 등 기술적 제약 사항을 해결하는 데 도움을 줍니다. 프론트엔드 개발, Docker, CI/CD 또는 일반 인프라에 대해서는 다루지 않습니다.
agent가 수행할 수 있는 작업
- 1보안 API 엔드포인트 구현역할 기반 액세스 제어를 위해 의존성 주입을 사용하는 FastAPI 라우트를 생성합니다.
- 2데이터베이스 스키마 및 마이그레이션 관리ORM 모델을 정의하고 Alembic 마이그레이션을 실행하여 데이터베이스 구조를 업데이트합니다.
- 3Stateless 서비스 레이어 개발async 세션을 사용하여 데이터베이스와 상호작용하는 서비스 함수를 작성합니다.
- 4API 응답 문제 디버깅API 응답에서 특정 필드가 누락되거나 422 에러가 발생하는 원인을 파악하고 해결합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
backend-fastapi-python skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.Claude Code에 backend-fastapi-python skill 설치
~/.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-pythonClaude Code (project)에 backend-fastapi-python skill 설치
.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python .claude/skills/backend-fastapi-pythonCodex에 backend-fastapi-python skill 설치
~/.agents/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.agents/skills/backend-fastapi-pythonGemini CLI에 backend-fastapi-python skill 설치
~/.gemini/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.gemini/skills/backend-fastapi-pythonClaude.ai에 backend-fastapi-python skill 설치
npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python backend-fastapi-python && zip -r backend-fastapi-python.zip backend-fastapi-python # claude.ai → Customize → Skills → + → Create skill → Upload a skill → backend-fastapi-python.zip
자동 검사
2026년 11월 16일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식
- 소스 저장소 연결 및 접근 가능avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python is public and reachablegithub.com/avibebuilder/claude-prime/tree/HEAD/.claude/start ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit 2026-05-16github.com/avibebuilder/claude-prime/commits ↗통과
- 스크립트에 다운로드 후 실행이나 자격 증명 탈취가 없음No scripts in the skill folder통과
- SKILL.md에 숨겨진 지침 없음No override phrases, safeguard switches, credential requests or hidden charactersgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗통과
- 사전 허용 도구가 제한됨No pre-approved tools; the agent asks before using onegithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗통과
- SKILL.md가 Agent Skills 형식을 따름Valid name and description; says when to use it; 47 linesgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗통과
SKILL.md
GitHub에서 보기Backend FastAPI Python
Project-specific conventions for FastAPI with SQLModel, pydantic-settings, and async SQLAlchemy.
Architecture Decisions
- Services are stateless functions — Not classes. First param is
db: AsyncSession. - Generic response wrapper — Always use
ApiResponse[T]for consistency. - Dependencies chain —
get_current_user->require_auth->require_admin. - Module-scoped config — Each module can have its own
{module}_config.py. - Error codes for frontend —
AppException(status, message, error_code).
Gotchas
- SQLModel
Relationship()fields are NOT included in API responses by default. You must explicitly add them tomodel_configor use a separate response schema with those fields. AsyncSession.refresh()does not load relationships. After commit, re-query with.options(selectinload(...))if you need related objects.- Pydantic V2 uses
model_validatornotvalidator. The@validatordecorator is V1 and will break silently or raise deprecation warnings. Depends()in FastAPI creates a NEW instance per request — don't store state in dependency return values expecting it to persist.- Background tasks (
BackgroundTasks) run AFTER the response is sent. If they fail, the client already got a 200. Use proper task queues (Celery, ARQ) for anything that must not silently fail. - Alembic
--autogeneratemisses: table renames (generates drop+create), index changes on existing columns, andEnumtype modifications in PostgreSQL. Always review generated migrations. async defendpoints block the event loop if you call sync I/O inside them. Userun_in_executorfor sync libraries or define the endpoint asdef(FastAPI runs sync endpoints in a threadpool).HTTPExceptionfrom FastAPI andHTTPExceptionfrom Starlette are different classes. Importing the wrong one causes middleware to miss exception handlers.- SQLAlchemy's
lazy="selectin"on relationships causes N+1 queries in async sessions. Use explicitselectinload()in queries instead. Optional[str] = Nonein query params makes the field optional.str = Nonealso works but loses type information — prefer the explicitOptionalform.- When using
response_model, FastAPI filters OUT any fields not in the model. If your response is missing data, check that the response model includes all fields, not just the ORM model.
References
| When you need... | Read |
|---|---|
| Directory layout | file-structure.md |
| Settings and env vars | configuration.md |
| Database sessions and connections | database.md |
| ORM models | models.md |
| Request/response schemas | schemas.md |
| Router and endpoint patterns | routing.md |
| Service layer patterns | services.md |
| Dependency injection | dependencies.md |
| Middleware setup | middleware.md |
| Error handling | error-handling.md |
| Auth flow example | auth.md |
이 스킬의 파일
12backend-fastapi-python skill 질문
Claude Code에 backend-fastapi-python skill을 어떻게 설치하나요?
npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-python를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
backend-fastapi-python skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
이 프로젝트에서 서비스 함수는 어떻게 구조화해야 하나요?
서비스는 클래스가 아닌 상태가 없는(stateless) 함수로 구현해야 하며, 첫 번째 파라미터는 항상 AsyncSession이어야 합니다.
API 응답에서 SQLModel 관계 필드가 누락된 경우 어떻게 해야 하나요?
SQLModel Relationship 필드는 기본적으로 포함되지 않습니다. model_config에 명시적으로 추가하거나 별도의 응답 스키마를 사용해야 합니다.
실패 시 조치가 필요한 백그라운드 작업은 어떻게 처리하나요?
BackgroundTasks는 응답이 전송된 후에 실행되므로, 조용히 실패하면 안 되는 중요한 작업은 Celery나 ARQ와 같은 적절한 작업 큐를 사용해야 합니다.
AsyncSession.refresh() 이후에 연관된 객체를 로드하는 올바른 방법은 무엇인가요?
refresh()는 관계를 로드하지 않으므로, 연관 데이터를 가져오려면 .options(selectinload(...))를 사용하여 객체를 다시 쿼리해야 합니다.