Skill backend-fastapi-python
✓ VerificadoDesenvolva backends Python utilizando FastAPI, SQLModel e SQLAlchemy assíncrono com padrões específicos para serviços, autenticação e tratamento de erros.
- Estrelas no GitHub
- 126
- Arquivos
- 12
- Último commit
- 16 de mai. de 2026
- Licença
- MIT
- Ferramentas permitidas
- —
O que a skill backend-fastapi-python faz?
Desenvolva backends Python utilizando FastAPI, SQLModel e SQLAlchemy assíncrono com padrões específicos para serviços, autenticação e tratamento de erros.
Resumo gerado a partir do SKILL.md da skill.
Sobre a skill backend-fastapi-python
A função principal desta SKILL é construir backends Python utilizando FastAPI, SQLModel e SQLAlchemy assíncrono. Desenvolvedores a utilizam para construir endpoints de API, escrever funções de serviço stateless e definir schemas Pydantic ou SQLModel. Ela foi projetada especificamente para tarefas de arquitetura de backend, incluindo a configuração de cadeias de dependência de autenticação como get_current_user e is_superuser, gerenciamento de sessões SQLAlchemy assíncronas e manipulação de migrações com Alembic.
Um agente deve carregar esta SKILL sempre que uma tarefa envolver código de API Python, design de request/response ou padrões de backend dentro deste codebase. Ela fornece orientação sobre convenções específicas do projeto, como o uso do wrapper ApiResponse[T] e a implementação de AppException para códigos de erro. A SKILL ajuda a navegar por restrições técnicas, como evitar consultas N+1 com selectinload, gerenciar tarefas em segundo plano e garantir o uso correto de validadores do Pydantic V2. Ela não cobre desenvolvimento frontend, Docker, CI/CD ou infraestrutura geral.
O que um agente pode fazer com ela
- 1Implementar endpoints de API segurosCriar rotas FastAPI que utilizam injeção de dependência para controle de acesso baseado em funções.
- 2Gerenciar schemas de banco de dados e migraçõesDefinir modelos ORM e executar migrações Alembic para atualizar a estrutura do banco de dados.
- 3Desenvolver camadas de serviço statelessEscrever funções de serviço que interagem com o banco de dados usando uma sessão assíncrona.
- 4Depurar problemas de resposta da APIIdentificar por que certos campos estão faltando nas respostas da API ou por que ocorrem erros 422.
Escrito a partir do SKILL.md da skill. Cada caso de uso é verificado com uma citação dele.
Como instalar a skill backend-fastapi-python
Cada comando copia a pasta da skill para o diretório de skills do cliente. Reinicie o cliente ou inicie uma nova sessão para carregá-la.Instalar a skill backend-fastapi-python no Claude Code
~/.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-pythonInstalar a skill backend-fastapi-python no 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-pythonInstalar a skill backend-fastapi-python no Codex
~/.agents/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.agents/skills/backend-fastapi-pythonInstalar a skill backend-fastapi-python no Gemini CLI
~/.gemini/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.gemini/skills/backend-fastapi-pythonInstalar a skill backend-fastapi-python no 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
Verificações automatizadas
Executado em 16 de nov. de 2026Relatório completo →Passou nas nossas verificações automáticas. Não é uma auditoria de segurança: leia os scripts antes de deixar um agente executá-los. Como as verificações funcionam
- Repositório de origem vinculado e acessívelavibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python is public and reachablegithub.com/avibebuilder/claude-prime/tree/HEAD/.claude/start ↗Passou
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit 2026-05-16github.com/avibebuilder/claude-prime/commits ↗Passou
- Sem baixar e executar nem roubo de credenciais nos scriptsNo scripts in the skill folderPassou
- Sem instruções ocultas no SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Passou
- Ferramentas pré-aprovadas são restritasNo pre-approved tools; the agent asks before using onegithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Passou
- O SKILL.md segue o formato Agent SkillsValid name and description; says when to use it; 47 linesgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Passou
SKILL.md
Ver no 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 |
Arquivos desta skill
12Perguntas sobre a skill backend-fastapi-python
Como instalo a skill backend-fastapi-python no Claude Code?
Execute npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-python. O Claude Code carrega skills de ~/.claude/skills (todos os projetos) ou .claude/skills (um projeto) e usa uma skill quando a descrição dela corresponde à tarefa.
Quais clientes podem usar a skill backend-fastapi-python?
Qualquer cliente que leia o formato Agent Skills: Claude Code, Codex, Gemini CLI e claude.ai (envie como ZIP). Scripts da skill são executados apenas onde o cliente permite execução de código.
Como as funções de serviço devem ser estruturadas neste projeto?
Os serviços devem ser implementados como funções stateless em vez de classes, onde o primeiro parâmetro é sempre um AsyncSession.
O que devo fazer se os campos de relacionamento do SQLModel não aparecerem nas respostas da API?
Campos de relacionamento do SQLModel não são incluídos por padrão; você deve adicioná-los explicitamente ao model_config ou usar um schema de resposta separado.
Como lidar com tarefas em segundo plano que não podem falhar silenciosamente?
Como as BackgroundTasks rodam após o envio da resposta, utilize filas de tarefas adequadas como Celery ou ARQ para tarefas críticas que não podem falhar silenciosamente.
Qual é a maneira correta de carregar objetos relacionados após um AsyncSession.refresh()?
Como o refresh() não carrega relacionamentos, você deve consultar o objeto novamente usando .options(selectinload(...)) para recuperar os dados relacionados.