backend-fastapi-python skill
✓ DoğrulandıFastAPI, SQLModel ve async SQLAlchemy kullanarak; servisler, kimlik doğrulama ve hata yönetimi için belirli desenlere sahip Python backend'leri geliştirin.
- GitHub yıldızları
- 126
- Dosyalar
- 12
- Son commit
- 16 May 2026
- Lisans
- MIT
- İzin verilen araçlar
- —
backend-fastapi-python skill ne işe yarar?
FastAPI, SQLModel ve async SQLAlchemy kullanarak; servisler, kimlik doğrulama ve hata yönetimi için belirli desenlere sahip Python backend'leri geliştirin.
Özet, skill'in SKILL.md dosyasından oluşturuldu.
backend-fastapi-python skilli hakkında
FastAPI, SQLModel ve async SQLAlchemy kullanarak Python backend'leri oluşturmak bu SKILL'in temel işlevidir. Geliştiriciler bunu API uç noktaları oluşturmak, stateless servis fonksiyonları yazmak ve Pydantic veya SQLModel şemaları tanımlamak için kullanır. Özellikle get_current_user ve is_superuser gibi kimlik doğrulama bağımlılık zincirlerini kurmak, async SQLAlchemy oturumlarını yönetmek ve Alembic migrasyonlarını yürütmek gibi backend mimarisi görevleri için tasarlanmıştır.
Bir agent, Python API kodu, istek/yanıt tasarımı veya bu kod tabanı içindeki backend desenlerini içeren bir görevle karşılaştığında bu SKILL'i yüklemelidir. ApiResponse[T] sarmalayıcısını kullanmak ve hata kodları için AppException uygulamak gibi projeye özgü kurallar hakkında rehberlik sağlar. SKILL; selectinload ile N+1 sorgularından kaçınmak, arka plan görevlerini yönetmek ve doğru Pydantic V2 validator kullanımı sağlamak gibi teknik kısıtlamaların aşılmasına yardımcı olur. Frontend geliştirme, Docker, CI/CD veya genel altyapı konularını kapsamaz.
Bir agent bununla neler yapabilir
- 1Güvenli API uç noktaları uygulayınRol tabanlı erişim kontrolü için bağımlılık enjeksiyonu (dependency injection) kullanan FastAPI rotaları oluşturun.
- 2Veritabanı şemalarını ve migrasyonlarını yönetinORM modellerini tanımlayın ve veritabanı yapısını güncellemek için Alembic migrasyonlarını çalıştırın.
- 3Stateless servis katmanları geliştirinAsync bir oturum kullanarak veritabanıyla etkileşime giren servis fonksiyonları yazın.
- 4API yanıt sorunlarını hata ayıklayınBelirli alanların API yanıtlarında neden eksik olduğunu veya neden 422 hatalarının oluştuğunu araştırın.
Skill'in SKILL.md dosyasından yazılmıştır. Her kullanım durumu oradaki bir alıntı ile kontrol edilir.
backend-fastapi-python skill nasıl kurulur
Her komut, skill klasörünü istemcinin skills dizinine kopyalar. Yüklemek için istemciyi yeniden başlatın veya yeni bir oturum başlatın.backend-fastapi-python skill'ini Claude Code uygulamasına kur
~/.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-pythonbackend-fastapi-python skill'ini Claude Code (project) uygulamasına kur
.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python .claude/skills/backend-fastapi-pythonbackend-fastapi-python skill'ini Codex uygulamasına kur
~/.agents/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.agents/skills/backend-fastapi-pythonbackend-fastapi-python skill'ini Gemini CLI uygulamasına kur
~/.gemini/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.gemini/skills/backend-fastapi-pythonbackend-fastapi-python skill'ini Claude.ai uygulamasına kur
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
Otomatik kontroller
Çalıştırıldı 16 Kas 2026Tam rapor →Otomatik kontrollerimizi geçti. Bu bir güvenlik denetimi değil: bir ajanın çalıştırmasına izin vermeden önce betikleri okuyun. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebiliravibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python is public and reachablegithub.com/avibebuilder/claude-prime/tree/HEAD/.claude/start ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit 2026-05-16github.com/avibebuilder/claude-prime/commits ↗Geçti
- Betiklerde indir-çalıştır veya kimlik bilgisi hırsızlığı yokNo scripts in the skill folderGeçti
- SKILL.md içinde gizli talimat yokNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Geçti
- Önceden izin verilen araçlar sınırlıNo pre-approved tools; the agent asks before using onegithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Geçti
- SKILL.md, Agent Skills biçimine uyuyorValid name and description; says when to use it; 47 linesgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Geçti
SKILL.md
GitHub'da görüntüleBackend 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 |
Bu becerideki dosyalar
12backend-fastapi-python skill soruları
backend-fastapi-python skill'ini Claude Code uygulamasına nasıl kurarım?
npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-python komutunu çalıştırın. Claude Code, skill'leri ~/.claude/skills (tüm projeler) veya .claude/skills (tek proje) konumundan yükler ve açıklaması görevle eşleştiğinde skill'i kullanır.
backend-fastapi-python skill'ini hangi istemciler kullanabilir?
Agent Skills biçimini okuyan her istemci: Claude Code, Codex, Gemini CLI ve claude.ai (ZIP olarak yükleyin). Skill içindeki betikler yalnızca istemcinin kod çalıştırmaya izin verdiği yerlerde çalışır.
Bu projede servis fonksiyonları nasıl yapılandırılmalıdır?
Servisler sınıf yerine stateless (durumsuz) fonksiyonlar olarak uygulanmalıdır ve ilk parametre her zaman bir AsyncSession olmalıdır.
SQLModel ilişki alanları API yanıtlarında eksikse ne yapmalıyım?
SQLModel Relationship alanları varsayılan olarak dahil edilmez; bunları model_config kısmına açıkça eklemeli veya ayrı bir response şeması kullanmalısınız.
Sessizce hata vermemesi gereken arka plan görevlerini nasıl yönetirim?
BackgroundTasks, yanıt gönderildikten sonra çalıştığı için, sessizce hata vermemesi gereken kritik görevlerde Celery veya ARQ gibi uygun görev kuyruklarını kullanın.
AsyncSession.refresh() işleminden sonra ilişkili nesneleri yüklemenin doğru yolu nedir?
refresh() ilişkileri yüklemediği için, ilişkili verileri geri getirmek amacıyla nesneyi .options(selectinload(...)) kullanarak yeniden sorgulamalısınız.