Skill backend-fastapi-python
✓ VerifiedKembangkan backend Python menggunakan FastAPI, SQLModel, dan async SQLAlchemy dengan pola khusus untuk service, autentikasi, dan error handling.
- Bintang GitHub
- 126
- File
- 12
- Commit terakhir
- 16 Mei 2026
- Lisensi
- MIT
- Tool yang diizinkan
- —
Apa fungsi skill backend-fastapi-python?
Kembangkan backend Python menggunakan FastAPI, SQLModel, dan async SQLAlchemy dengan pola khusus untuk service, autentikasi, dan error handling.
Ringkasan dibuat dari SKILL.md skill ini.
Tentang skill backend-fastapi-python
Membangun backend Python menggunakan FastAPI, SQLModel, dan async SQLAlchemy adalah fungsi utama dari SKILL ini. Developer menggunakannya untuk menyusun endpoint API, menulis fungsi service yang stateless, serta mendefinisikan schema Pydantic atau SQLModel. SKILL ini dirancang khusus untuk tugas arsitektur backend, termasuk menyiapkan dependency chain autentikasi seperti get_current_user dan is_superuser, mengelola async SQLAlchemy session, dan menangani migrasi Alembic.
Agent harus memuat skill ini setiap kali ada tugas yang melibatkan kode Python API, desain request/response, atau pola backend di dalam codebase ini. Skill ini memberikan panduan mengenai konvensi proyek yang spesifik, seperti penggunaan wrapper ApiResponse[T] dan implementasi AppException untuk error codes. Skill ini membantu menavigasi batasan teknis seperti menghindari N+1 queries dengan selectinload, mengelola background tasks, dan memastikan penggunaan validator Pydantic V2 yang benar. Skill ini tidak mencakup pengembangan frontend, Docker, CI/CD, atau infrastruktur umum.
Apa yang bisa dilakukan agent dengannya
- 1Implementasi endpoint API yang amanBuat route FastAPI yang menggunakan dependency injection untuk role-based access control.
- 2Mengelola database schema dan migrasiDefinisikan model ORM dan jalankan migrasi Alembic untuk memperbarui struktur database.
- 3Mengembangkan stateless service layerTulis fungsi service yang berinteraksi dengan database menggunakan async session.
- 4Debug masalah respons APITroubleshoot mengapa field tertentu hilang dari respons API atau mengapa terjadi error 422.
Ditulis dari SKILL.md milik skill tersebut. Setiap use case diverifikasi dengan kutipan darinya.
Cara install skill backend-fastapi-python
Setiap perintah menyalin folder skill ke direktori skills client. Restart client atau mulai sesi baru untuk memuatnya.Install skill backend-fastapi-python di Claude Code
~/.claude/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-pythonInstall skill backend-fastapi-python di 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-pythonInstall skill backend-fastapi-python di Codex
~/.agents/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.agents/skills/backend-fastapi-pythonInstall skill backend-fastapi-python di Gemini CLI
~/.gemini/skills/backend-fastapi-python/SKILL.md
$ npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.gemini/skills/backend-fastapi-pythonInstall skill backend-fastapi-python di 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
Pengecekan otomatis
Berjalan 16 Nov 2026Laporan lengkap →Lolos cek otomatis kami. Ini bukan audit keamanan: baca skripnya sebelum membiarkan agent menjalankannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauavibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python is public and reachablegithub.com/avibebuilder/claude-prime/tree/HEAD/.claude/start ↗Lolos
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit 2026-05-16github.com/avibebuilder/claude-prime/commits ↗Lolos
- Skrip tanpa unduh-lalu-jalankan atau pencurian kredensialNo scripts in the skill folderLolos
- Tidak ada instruksi tersembunyi di SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Lolos
- Tool yang diizinkan otomatis dibatasiNo pre-approved tools; the agent asks before using onegithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Lolos
- SKILL.md mengikuti format Agent SkillsValid name and description; says when to use it; 47 linesgithub.com/avibebuilder/claude-prime/blob/HEAD/.claude/start ↗Lolos
SKILL.md
Lihat di 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 |
Berkas dalam skill ini
12Pertanyaan seputar skill backend-fastapi-python
Bagaimana cara install skill backend-fastapi-python di Claude Code?
Jalankan npx degit avibebuilder/claude-prime/.claude/starter-skills/backend-fastapi-python ~/.claude/skills/backend-fastapi-python. Claude Code memuat skill dari ~/.claude/skills (semua proyek) atau .claude/skills (satu proyek) dan menggunakan skill saat deskripsinya cocok dengan tugas.
Client mana saja yang bisa menggunakan skill backend-fastapi-python?
Client apa pun yang membaca format Agent Skills: Claude Code, Codex, Gemini CLI, dan claude.ai (unggah sebagai ZIP). Script dalam skill hanya berjalan di client yang mengizinkan eksekusi kode.
Bagaimana struktur fungsi service yang benar dalam proyek ini?
Service harus diimplementasikan sebagai fungsi stateless, bukan class, di mana parameter pertamanya selalu berupa AsyncSession.
Apa yang harus saya lakukan jika field relationship SQLModel tidak muncul di respons API?
Field SQLModel Relationship tidak disertakan secara default; Anda harus menambahkannya secara eksplisit ke dalam model_config atau menggunakan schema respons yang terpisah.
Bagaimana cara menangani background tasks agar tidak gagal secara diam-diam?
Karena BackgroundTasks berjalan setelah respons dikirim, gunakan task queue yang tepat seperti Celery atau ARQ untuk tugas-tugas kritis yang tidak boleh gagal tanpa peringatan.
Bagaimana cara yang benar untuk memuat objek terkait setelah melakukan AsyncSession.refresh()?
Karena refresh() tidak memuat relationship, Anda harus melakukan query ulang pada objek tersebut menggunakan .options(selectinload(...)) untuk mengambil data terkait.