用途:当任务涉及 FastAPI 高性能异步 API 开发、现代 Python Web 模式,或需要相关指导、最佳实践与检查清单时使用;与 FastAPI 无关的任务不适用。
主要能力:涵盖 FastAPI 0.100+ 特性(Annotated 类型、依赖注入)、async/await 高并发模式、Pydantic V2 校验与序列化、自动 OpenAPI/Swagger 文档、WebSocket、后台任务、文件上传与流式响应、自定义中间件;数据层支持 SQLAlchemy 2.0 异步(asyncpg、aiomysql)、Alembic 迁移、仓储与工作单元模式、连接池与会话管理、MongoDB(Motor、Beanie)、Redis 缓存;API 设计含 REST、GraphQL(Strawberry/Graphene)、微服务、版本管理、限流、熔断、事件驱动、CQRS;安全含 OAuth2 JWT、社交登录、API Key、RBAC、CORS 与安全头、SQL 注入防护;测试含 pytest-asyncio、TestClient、Faker、pytest-mock、覆盖率与 Locust 性能测试;此外涉及可观测性(结构化日志、OpenTelemetry、Prometheus、健康检查)、部署(Docker 多阶段构建、Kubernetes、CI/CD、Uvicorn/Gunicorn)以及消息队列与任务队列集成。
使用方式:先澄清目标、约束与所需输入,应用相关最佳实践并验证结果,给出可执行步骤与验证方法;如需详细示例,可打开 resources/implementation-playbook.md。
行为准则:默认编写异步优先代码,强调类型安全,先设计 Pydantic 模型契约,实现完整错误处理与依赖注入,编写异步测试,考虑性能与日志监控,遵循 12-factor。
限制:资料未提供具体安装命令、价格或平台支持信息;本技能定位为 FastAPI 开发指导,超出该范围的任务不适用。