Навык backend-fastapi-python
✓ ПровереноРазработка Python-бэкендов с использованием FastAPI, SQLModel и async SQLAlchemy с применением специфических паттернов для сервисов, аутентификации и обработки ошибок.
- Звёзды на GitHub
- 126
- Файлы
- 12
- Последний коммит
- 16 мая 2026 г.
- Лицензия
- MIT
- Разрешённые инструменты
- —
Что делает навык backend-fastapi-python?
Разработка Python-бэкендов с использованием FastAPI, SQLModel и async SQLAlchemy с применением специфических паттернов для сервисов, аутентификации и обработки ошибок.
Сводка сгенерирована из SKILL.md навыка.
О skill backend-fastapi-python
Основная задача этого SKILL — создание Python-бэкендов с использованием FastAPI, SQLModel и async SQLAlchemy. Разработчики используют его для построения эндпоинтов API, написания stateless-функций сервисов и определения схем Pydantic или SQLModel. Он специально предназначен для задач архитектуры бэкенда, включая настройку цепочек зависимостей для аутентификации (например, get_current_user и is_superuser), управление асинхронными сессиями SQLAlchemy и работу с миграциями Alembic.
Агенту следует загружать этот навык всякий раз, когда задача касается кода Python API, проектирования запросов/ответов или паттернов бэкенда в рамках данной кодовой базы. Он предоставляет рекомендации по специфическим соглашениям проекта, таким как использование обертки ApiResponse[T] и реализация AppException для кодов ошибок. Навык помогает учитывать технические ограничения, например, избегать проблемы N+1 запросов с помощью selectinload, управлять фоновыми задачами и обеспечивать корректное использование валидаторов Pydantic V2. Он не охватывает фронтенд-разработку, Docker, CI/CD или общую инфраструктуру.
Что агент может делать с ним
- 1Реализация защищенных эндпоинтов APIСоздание маршрутов FastAPI, использующих внедрение зависимостей (dependency injection) для контроля доступа на основе ролей.
- 2Управление схемами базы данных и миграциямиОпределение ORM-моделей и запуск миграций Alembic для обновления структуры базы данных.
- 3Разработка stateless-слоев сервисовНаписание сервисных функций, взаимодействующих с базой данных через асинхронную сессию.
- 4Отладка проблем с ответами APIПоиск причин отсутствия определенных полей в ответах API или возникновения ошибок 422.
Написано на основе skill SKILL.md. Каждый сценарий использования проверен по цитате из него.
Как установить навык backend-fastapi-python
Каждая команда копирует папку навыка в каталог навыков клиента. Перезапустите клиент или начните новую сессию, чтобы загрузить его.Установка навыка backend-fastapi-python в Claude Code
~/.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-pythonУстановка навыка backend-fastapi-python в 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-pythonУстановка навыка backend-fastapi-python в Codex
~/.agents/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.agents/skills/backend-fastapi-pythonУстановка навыка backend-fastapi-python в Gemini CLI
~/.gemini/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.gemini/skills/backend-fastapi-pythonУстановка навыка backend-fastapi-python в 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
Автоматические проверки
Запущено 16 нояб. 2026 г.Полный отчёт →Прошёл наши автоматические проверки. Это не аудит безопасности: прочитайте скрипты, прежде чем агент их запустит. Как работают проверки
- Связанный и доступный исходный репозиторийavibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python is public and reachablegithub.com/avibebuilder/claude-prime/tree/HEAD/.claude/start ↗Пройдено
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний год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 SkillsValid name and description; says when to use it; 47 linesgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Пройдено
SKILL.md
Открыть на 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 |
Файлы в этом навыке
12Вопросы о навыке backend-fastapi-python
Как установить навык backend-fastapi-python в Claude Code?
Выполните npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-python. Claude Code загружает навыки из ~/.claude/skills (все проекты) или .claude/skills (один проект) и использует навык, когда его описание соответствует задаче.
Какие клиенты могут использовать навык backend-fastapi-python?
Любой клиент, который читает формат Agent Skills: Claude Code, Codex, Gemini CLI и claude.ai (загрузить как ZIP). Скрипты в навыке выполняются только там, где клиент разрешает выполнение кода.
Как должны быть структурированы сервисные функции в этом проекте?
Сервисы следует реализовывать как функции без сохранения состояния (stateless), а не как классы; первым параметром функции всегда должен быть AsyncSession.
Что делать, если поля связей SQLModel отсутствуют в ответах API?
Поля SQLModel Relationship не включаются в ответ по умолчанию; их необходимо явно добавить в model_config или использовать отдельную схему ответа.
Как обрабатывать фоновые задачи, которые не должны завершаться незаметно?
Поскольку BackgroundTasks выполняются после отправки ответа, для критически важных задач, которые не могут завершаться незаметно, используйте полноценные очереди задач, такие как Celery или ARQ.
Как правильно загружать связанные объекты после выполнения AsyncSession.refresh()?
Так как refresh() не загружает связи, вам следует повторно запросить объект, используя .options(selectinload(...)), чтобы получить связанные данные.