kscz0000 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- 包管理
操作
- 设置Python环境（uv/poetry）
- 创建项目结构
- 配置FastAPI应用
- 设置日志
- 配置环境变量
复制粘贴提示
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模型
操作
- 设计数据库Schema
- 设置SQLAlchemy模型
- 创建数据库连接
- 配置迁移（Alembic）
- 设置会话管理
复制粘贴提示
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模式
操作
- 设计API端点
- 创建API路由器
- 实现CRUD操作
- 添加请求验证
- 配置响应模型
复制粘贴提示
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安全
操作
- 选择认证策略（JWT、OAuth2）
- 实现用户注册
- 设置登录端点
- 创建认证中间件
- 添加密码哈希
复制粘贴提示
Use @auth-implementation-patterns to implement JWT authentication
阶段5：错误处理
调用技能
fastapi-pro- FastAPI模式error-handling-patterns- 错误处理
操作
- 创建自定义异常
- 设置异常处理器
- 实现错误响应
- 添加请求日志
- 配置错误跟踪
复制粘贴提示
Use @fastapi-pro to implement comprehensive error handling
阶段6：测试
调用技能
python-testing-patterns- pytest测试api-testing-observability-api-mock- API测试
操作
- 设置pytest
- 创建测试夹具
- 编写单元测试
- 实现集成测试
- 配置测试数据库
复制粘贴提示
Use @python-testing-patterns to write pytest tests for FastAPI
阶段7：文档
调用技能
api-documenter- API文档openapi-spec-generation- OpenAPI规范
操作
- 配置OpenAPI Schema
- 添加端点文档
- 创建使用示例
- 设置API版本控制
- 生成API文档
复制粘贴提示
Use @api-documenter to generate comprehensive API documentation
阶段8：部署
调用技能
deployment-engineer- 部署docker-expert- 容器化
操作
- 创建Dockerfile
- 设置docker-compose
- 配置生产环境设置
- 设置反向代理
- 部署到云
复制粘贴提示
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模式
限制
- 仅在任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家评审的替代品。
- 如果缺少所需输入、权限、安全边界或成功标准，请停止并请求澄清。