python-fastapi-development

Python/FastAPI 开发工作流

概述

用于构建生产级 Python FastAPI 后端的专用工作流，包含异步模式、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 - Schema 设计
• postgresql - PostgreSQL 设置
• pydantic-models-py - Pydantic 模型

操作

1. 设计数据库 schema
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 schema
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）
• Lint 检查无问题（ruff、black）
• API 文档完整
• 安全扫描通过
• 性能基准达标

相关工作流包

• development - 通用开发
• database - 数据库操作
• security-audit - 安全测试
• api-development - API 模式

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为特定环境验证、测试或专家评审的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。