backend-fastapi-python Skill
✓ VerifiziertEntwickle Python-Backends mit FastAPI, SQLModel und async SQLAlchemy unter Verwendung spezifischer Patterns für Services, Authentifizierung und Error Handling.
- GitHub Stars
- 126
- Dateien
- 12
- Letzter Commit
- 16. Mai 2026
- Lizenz
- MIT
- Erlaubte Tools
- —
Was macht der backend-fastapi-python Skill?
Entwickle Python-Backends mit FastAPI, SQLModel und async SQLAlchemy unter Verwendung spezifischer Patterns für Services, Authentifizierung und Error Handling.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den backend-fastapi-python skill
Das Erstellen von Python-Backends mit FastAPI, SQLModel und async SQLAlchemy ist die Hauptfunktion dieses Skills. Entwickler nutzen ihn, um API-Endpoints zu bauen, stateless Service-Funktionen zu schreiben und Pydantic- oder SQLModel-Schemas zu definieren. Er ist speziell für Backend-Architekturaufgaben konzipiert, einschließlich des Aufbaus von Authentifizierungs-Dependency-Chains wie get_current_user und is_superuser, dem Management von async SQLAlchemy Sessions und der Handhabung von Alembic-Migrationen.
Ein Agent sollte diesen Skill laden, sobald eine Aufgabe Python-API-Code, Request/Response-Design oder Backend-Patterns innerhalb dieser Codebase betrifft. Er bietet Anleitung zu spezifischen Projektkonventionen, wie der Verwendung des ApiResponse[T] Wrappers und der Implementierung von AppException für Error-Codes. Der Skill hilft dabei, technische Einschränkungen zu meistern, wie etwa das Vermeiden von N+1 Queries durch selectinload, das Management von Background Tasks und die korrekte Nutzung von Pydantic V2 Validatoren. Er deckt keine Frontend-Entwicklung, Docker, CI/CD oder allgemeine Infrastruktur ab.
Was ein agent damit machen kann
- 1Sichere API-Endpoints implementierenErstelle FastAPI-Routes, die Dependency Injection für die rollenbasierte Zugriffskontrolle nutzen.
- 2Datenbank-Schemas und Migrationen verwaltenDefiniere ORM-Models und führe Alembic-Migrationen aus, um die Datenbankstruktur zu aktualisieren.
- 3Stateless Service-Layers entwickelnSchreibe Service-Funktionen, die über eine async Session mit der Datenbank interagieren.
- 4API-Response-Probleme debuggenFehlersuche, warum bestimmte Felder in API-Responses fehlen oder warum 422-Errors auftreten.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den backend-fastapi-python Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den backend-fastapi-python Skill in Claude Code installieren
~/.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-pythonDen backend-fastapi-python Skill in Claude Code (project) installieren
.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python .claude/skills/backend-fastapi-pythonDen backend-fastapi-python Skill in Codex installieren
~/.agents/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.agents/skills/backend-fastapi-pythonDen backend-fastapi-python Skill in Gemini CLI installieren
~/.gemini/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.gemini/skills/backend-fastapi-pythonDen backend-fastapi-python Skill in Claude.ai installieren
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
Automatisierte Checks
Geluften am 16. Nov. 2026Vollständiger Bericht →Hat unsere automatischen Prüfungen bestanden. Das ist kein Sicherheitsaudit: Lesen Sie die Skripte, bevor ein Agent sie ausführt. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbaravibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python is public and reachablegithub.com/avibebuilder/claude-prime/tree/HEAD/.claude/start ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit 2026-05-16github.com/avibebuilder/claude-prime/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Bestanden
- SKILL.md folgt dem Agent-Skills-FormatValid name and description; says when to use it; 47 linesgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Bestanden
SKILL.md
Auf GitHub ansehenBackend 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 |
Dateien in diesem Skill
12backend-fastapi-python Skill-Fragen
Wie installiere ich den backend-fastapi-python Skill in Claude Code?
Führe npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-python aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den backend-fastapi-python Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Wie sollten Service-Funktionen in diesem Projekt strukturiert sein?
Services sollten als stateless Funktionen statt als Klassen implementiert werden, wobei der erste Parameter immer eine AsyncSession sein muss.
Was soll ich tun, wenn SQLModel Relationship-Felder in den API-Responses fehlen?
SQLModel Relationship-Felder werden standardmäßig nicht inkludiert; du musst sie explizit in der model_config hinzufügen oder ein separates Response-Schema verwenden.
Wie gehe ich mit Background Tasks um, die nicht lautlos fehlschlagen dürfen?
Da BackgroundTasks erst nach dem Senden der Response laufen, solltest du für kritische Aufgaben, die nicht lautlos fehlschlagen dürfen, richtige Task-Queues wie Celery oder ARQ nutzen.
Was ist der richtige Weg, um verwandte Objekte nach einem AsyncSession.refresh() zu laden?
Da refresh() keine Relationships lädt, solltest du das Objekt erneut mit .options(selectinload(...)) abfragen, um die verknüpften Daten abzurufen.