Skill backend-fastapi-python
✓ VérifiéDéveloppez des backends Python en utilisant FastAPI, SQLModel et SQLAlchemy async avec des patterns spécifiques pour les services, l'authentification et la gestion des erreurs.
- Étoiles GitHub
- 126
- Fichiers
- 12
- Dernier commit
- 16 mai 2026
- Licence
- MIT
- Outils autorisés
- —
Que fait la skill backend-fastapi-python ?
Développez des backends Python en utilisant FastAPI, SQLModel et SQLAlchemy async avec des patterns spécifiques pour les services, l'authentification et la gestion des erreurs.
Résumé généré à partir du SKILL.md de la skill.
À propos du skill backend-fastapi-python
La fonction principale de ce SKILL est la construction de backends Python utilisant FastAPI, SQLModel et SQLAlchemy async. Les développeurs l'utilisent pour construire des endpoints d'API, écrire des fonctions de service stateless et définir des schémas Pydantic ou SQLModel. Il est spécifiquement conçu pour les tâches d'architecture backend, notamment la mise en place de chaînes de dépendances d'authentification comme get_current_user et is_superuser, la gestion des sessions SQLAlchemy async et la gestion des migrations Alembic.
Un agent doit charger ce SKILL dès qu'une tâche implique du code d'API Python, la conception de requêtes/réponses ou des patterns backend au sein de cette base de code. Il fournit des directives sur les conventions spécifiques du projet, comme l'utilisation du wrapper ApiResponse[T] et l'implémentation d'AppException pour les codes d'erreur. Le SKILL aide à naviguer entre les contraintes techniques, telles que l'évitement des requêtes N+1 avec selectinload, la gestion des tâches de fond et l'utilisation correcte des validateurs Pydantic V2. Il ne couvre pas le développement frontend, Docker, la CI/CD ou l'infrastructure générale.
Ce qu'un agent peut faire avec
- 1Implémenter des endpoints API sécurisésCréer des routes FastAPI utilisant l'injection de dépendances pour le contrôle d'accès basé sur les rôles.
- 2Gérer les schémas de base de données et les migrationsDéfinir des modèles ORM et exécuter des migrations Alembic pour mettre à jour la structure de la base de données.
- 3Développer des couches de service statelessÉcrire des fonctions de service qui interagissent avec la base de données via une session async.
- 4Déboguer des problèmes de réponse APIRésoudre les problèmes de champs manquants dans les réponses API ou les erreurs 422.
Rédigé à partir du SKILL.md du skill. Chaque cas d'utilisation est vérifié par rapport à une citation de celui-ci.
Comment installer la skill backend-fastapi-python
Chaque commande copie le dossier de la skill dans le répertoire des skills du client. Redémarrez le client ou démarrez une nouvelle session pour la charger.Installer la skill backend-fastapi-python dans Claude Code
~/.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-pythonInstaller la skill backend-fastapi-python dans Claude Code (project)
.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python .claude/skills/backend-fastapi-pythonInstaller la skill backend-fastapi-python dans Codex
~/.agents/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.agents/skills/backend-fastapi-pythonInstaller la skill backend-fastapi-python dans Gemini CLI
~/.gemini/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.gemini/skills/backend-fastapi-pythonInstaller la skill backend-fastapi-python dans Claude.ai
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
Vérifications automatisées
Exécuté le 16 nov. 2026Rapport complet →A réussi nos vérifications automatiques. Ce n'est pas un audit de sécurité : lisez les scripts avant de laisser un agent les exécuter. Fonctionnement des vérifications
- Dépôt source lié et accessibleavibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python is public and reachablegithub.com/avibebuilder/claude-prime/tree/HEAD/.claude/start ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit 2026-05-16github.com/avibebuilder/claude-prime/commits ↗Réussi
- Aucun téléchargement-exécution ni vol d'identifiants dans les scriptsNo scripts in the skill folderRéussi
- Aucune instruction cachée dans SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Réussi
- Les outils préautorisés sont limitésNo pre-approved tools; the agent asks before using onegithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Réussi
- SKILL.md respecte le format Agent SkillsValid name and description; says when to use it; 47 linesgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Réussi
SKILL.md
Voir sur GitHubBackend 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 |
Fichiers de cette skill
12Questions sur la skill backend-fastapi-python
Comment installer la skill backend-fastapi-python dans Claude Code ?
Exécutez npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-python. Claude Code charge les skills depuis ~/.claude/skills (tous les projets) ou .claude/skills (un seul projet) et utilise une skill lorsque sa description correspond à la tâche.
Quels clients peuvent utiliser la skill backend-fastapi-python ?
Tout client qui lit le format Agent Skills : Claude Code, Codex, Gemini CLI et claude.ai (envoi sous forme de ZIP). Les scripts de la skill ne s'exécutent que si le client autorise l'exécution de code.
Comment les fonctions de service doivent-elles être structurées dans ce projet ?
Les services doivent être implémentés sous forme de fonctions stateless plutôt que de classes, où le premier paramètre est systématiquement un AsyncSession.
Que faire si les champs de relation SQLModel sont absents des réponses API ?
Les champs de relation SQLModel ne sont pas inclus par défaut ; vous devez les ajouter explicitement au model_config ou utiliser un schéma de réponse distinct.
Comment gérer les tâches de fond qui ne doivent pas échouer silencieusement ?
Comme les BackgroundTasks s'exécutent après l'envoi de la réponse, utilisez des files d'attente de tâches appropriées comme Celery ou ARQ pour les tâches critiques qui ne peuvent pas échouer silencieusement.
Quelle est la bonne méthode pour charger des objets liés après un AsyncSession.refresh() ?
Comme refresh() ne charge pas les relations, vous devez requêter à nouveau l'objet en utilisant .options(selectinload(...)) pour récupérer les données liées.