python-fastapi-development

Python/FastAPI 開発ワークフロー

概要

FastAPI を使用して本番環境に対応した Python バックエンドを構築するための専門ワークフローです。非同期パターン、SQLAlchemy ORM、Pydantic バリデーション、そして包括的な API パターンを特徴としています。

このワークフローを使用する場面

以下の場合にこのワークフローを使用してください：

• FastAPI で新しい REST API を構築する場合
• 非同期 Python バックエンドを作成する場合
• SQLAlchemy によるデータベース統合を実装する場合
• API 認証を設定する場合
• マイクロサービスを開発する場合

ワークフローのフェーズ

フェーズ 1: プロジェクトのセットアップ

呼び出すスキル

• app-builder - アプリケーションのスキャフォールディング
• python-development-python-scaffold - Python のスキャフォールディング
• fastapi-templates - FastAPI テンプレート
• uv-package-manager - パッケージ管理

アクション

1. Python 環境をセットアップする（uv/poetry）
2. プロジェクト構造を作成する
3. FastAPI アプリを設定する
4. ログを設定する
5. 環境変数を設定する

コピー＆ペースト用プロンプト

Use @fastapi-templates to scaffold a new FastAPI project

Use @python-development-python-scaffold to set up Python project structure

フェーズ 2: データベースのセットアップ

呼び出すスキル

• prisma-expert - Prisma ORM（代替）
• database-design - スキーマ設計
• postgresql - PostgreSQL のセットアップ
• pydantic-models-py - Pydantic モデル

アクション

1. データベーススキーマを設計する
2. SQLAlchemy モデルをセットアップする
3. データベース接続を作成する
4. マイグレーションを設定する（Alembic）
5. セッション管理をセットアップする

コピー＆ペースト用プロンプト

Use @database-design to design PostgreSQL schema

Use @pydantic-models-py to create Pydantic models for API

フェーズ 3: API ルート

呼び出すスキル

• fastapi-router-py - FastAPI ルーター
• api-design-principles - API 設計
• api-patterns - API パターン

アクション

1. API エンドポイントを設計する
2. API ルーターを作成する
3. CRUD 操作を実装する
4. リクエストバリデーションを追加する
5. レスポンスモデルを設定する

コピー＆ペースト用プロンプト

Use @fastapi-router-py to create API endpoints with CRUD operations

Use @api-design-principles to design RESTful API

フェーズ 4: 認証

呼び出すスキル

• auth-implementation-patterns - 認証
• api-security-best-practices - API セキュリティ

アクション

1. 認証戦略を選択する（JWT、OAuth2）
2. ユーザー登録を実装する
3. ログインエンドポイントをセットアップする
4. 認証ミドルウェアを作成する
5. パスワードハッシュを追加する

コピー＆ペースト用プロンプト

Use @auth-implementation-patterns to implement JWT authentication

フェーズ 5: エラー処理

呼び出すスキル

• fastapi-pro - FastAPI パターン
• error-handling-patterns - エラー処理

アクション

1. カスタム例外を作成する
2. 例外ハンドラーをセットアップする
3. エラーレスポンスを実装する
4. リクエストログを追加する
5. エラートラッキングを設定する

コピー＆ペースト用プロンプト

Use @fastapi-pro to implement comprehensive error handling

フェーズ 6: テスト

呼び出すスキル

• python-testing-patterns - pytest テスト
• api-testing-observability-api-mock - API テスト

アクション

1. pytest をセットアップする
2. テストフィクスチャを作成する
3. 単体テストを書く
4. 統合テストを実装する
5. テストデータベースを設定する

コピー＆ペースト用プロンプト

Use @python-testing-patterns to write pytest tests for FastAPI

フェーズ 7: ドキュメント

呼び出すスキル

• api-documenter - API ドキュメント
• openapi-spec-generation - OpenAPI 仕様

アクション

1. OpenAPI スキーマを設定する
2. エンドポイントのドキュメントを追加する
3. 使用例を作成する
4. API バージョニングをセットアップする
5. API ドキュメントを生成する

コピー＆ペースト用プロンプト

Use @api-documenter to generate comprehensive API documentation

フェーズ 8: デプロイ

呼び出すスキル

• deployment-engineer - デプロイ
• docker-expert - コンテナ化

アクション

1. Dockerfile を作成する
2. docker-compose をセットアップする
3. 本番環境設定を構成する
4. リバースプロキシをセットアップする
5. クラウドにデプロイする

コピー＆ペースト用プロンプト

Use @docker-expert to containerize FastAPI application

テクノロジースタック

カテゴリ	テクノロジー
フレームワーク	FastAPI
言語	Python 3.11+
ORM	SQLAlchemy 2.0
バリデーション	Pydantic v2
データベース	PostgreSQL
マイグレーション	Alembic
認証	JWT、OAuth2
テスト	pytest

品質ゲート

• すべてのテストが成功している（カバレッジ 80% 超）
• 型チェックが成功している（mypy）
• リンティングがクリーンである（ruff、black）
• API ドキュメントが完成している
• セキュリティスキャンに合格している
• パフォーマンスベンチマークを満たしている

関連ワークフローバンドル

• development - 一般的な開発
• database - データベース操作
• security-audit - セキュリティテスト
• api-development - API パターン

制限事項

• このスキルは、タスクが上記のスコープに明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、成功基準が欠けている場合は、作業を中断して確認を求めてください。