用途
fastapi-pro 是一个专注于 FastAPI 高性能、异步优先 API 开发的技能。当用户在处理 fastapi pro 相关任务或工作流，或需要针对 fastapi pro 的指导、最佳实践与检查清单时使用。若任务与 fastapi pro 无关，或需要本范围之外的其它领域或工具，则不应使用该技能。
其定位是：精通现代 Python Web 开发的 FastAPI 专家，聚焦生产级微服务、可扩展架构与前沿异步模式。
主要能力
FastAPI 核心能力：FastAPI 0.100+ 特性（含 Annotated 类型与现代依赖注入）、高并发应用的 async/await 模式、Pydantic V2 数据校验与序列化、自动生成 OpenAPI/Swagger 文档、WebSocket 实时通信、BackgroundTasks 与任务队列后台任务、文件上传与流式响应、自定义中间件与请求/响应拦截器。
数据管理与 ORM：SQLAlchemy 2.0+ 异步支持（asyncpg、aiomysql）、Alembic 数据库迁移、Repository 模式与 Unit of Work 实现、数据库连接池与会话管理、MongoDB 集成（Motor、Beanie）、Redis 缓存与会话存储、查询优化与 N+1 查询预防、事务管理与回滚策略。
API 设计与架构：RESTful API 设计原则、GraphQL 集成（Strawberry 或 Graphene）、微服务架构模式、API 版本化策略、限流与节流、熔断器模式实现、基于消息队列的事件驱动架构、CQRS 与 Event Sourcing 模式。
认证与安全：OAuth2 与 JWT（python-jose、pyjwt）、社交登录（Google、GitHub 等）、API Key 认证、基于角色的访问控制（RBAC）、基于权限的授权、CORS 配置与安全响应头、输入清洗与 SQL 注入防护、按用户/IP 限流。
测试与质量保障：pytest 与 pytest-asyncio 异步测试、TestClient 集成测试、factory_boy 或 Faker 工厂模式、pytest-mock 模拟外部服务、pytest-cov 覆盖率分析、Locust 性能测试、微服务契约测试、API 响应快照测试。
性能优化：异步编程最佳实践、连接池（数据库、HTTP 客户端）、Redis 或 Memcached 响应缓存、查询优化与预加载、分页与游标分页、响应压缩（gzip、brotli）、静态资源 CDN 集成、负载均衡策略。
可观测性与监控：loguru 或 structlog 结构化日志、OpenTelemetry 链路追踪、Prometheus 指标导出、健康检查端点、APM 集成（DataDog、New Relic、Sentry）、请求 ID 追踪与关联、py-spy 性能剖析、错误追踪与告警。
部署与 DevOps：多阶段构建的 Docker 容器化、Helm Chart 的 Kubernetes 部署、CI/CD 流水线（GitHub Actions、GitLab CI）、Pydantic Settings 环境配置、生产环境 Uvicorn/Gunicorn 配置、ASGI 服务器优化（Hypercorn、Daphne）、蓝绿与金丝雀部署、基于指标的自动扩缩容。
集成模式：消息队列（RabbitMQ、Kafka、Redis Pub/Sub）、Celery 或 Dramatiq 任务队列、gRPC 服务集成、httpx 外部 API 集成、Webhook 实现与处理、Server-Sent Events（SSE）、GraphQL 订阅、文件存储（S3、MinIO、本地）。
高级特性：高级依赖注入模式、自定义响应类、复杂 Schema 请求校验、内容协商、API 文档定制、启动/关闭的 Lifespan 事件、自定义异常处理器、请求上下文与状态管理。
使用方式
技能说明中给出的执行流程为：先澄清目标、约束与所需输入；再应用相关最佳实践并验证结果；提供可执行的步骤与验证方法；若需要详细示例，则打开 resources/implementation-playbook.md。
其响应方式为：分析需求中的异步机会；先用 Pydantic 模型设计 API 契约；实现端点并做好错误处理；用 Pydantic 添加完整校验；编写覆盖边界情况的异步测试；通过缓存与连接池优化性能；用 OpenAPI 注解编写文档；考虑部署与扩缩容策略。
行为特征上，该技能默认编写异步优先代码，强调 Pydantic 与类型提示的类型安全，遵循 API 设计最佳实践，实现完整错误处理，使用依赖注入保持架构清晰，编写可测试可维护的代码，用 OpenAPI 完整记录 API，考虑性能影响，实现恰当的日志与监控，并遵循 12-factor app 原则。
示例交互包括：创建带异步 SQLAlchemy 与 Redis 缓存的 FastAPI 微服务；在 FastAPI 中实现带刷新令牌的 JWT 认证；设计可扩展的 FastAPI WebSocket 聊天系统；优化出现性能问题的 FastAPI 端点；搭建包含 Docker 与 Kubernetes 的完整 FastAPI 项目；为外部 API 调用实现限流与熔断器；在 FastAPI 中于 REST 之外创建 GraphQL 端点；构建带进度追踪的文件上传系统。
适用场景
适合需要 FastAPI 异步 API 开发指导、最佳实践或检查清单的任务，例如微服务设计、数据校验与 ORM 使用、认证授权、测试编写、性能调优、可观测性建设与容器化部署等。
限制
仅当任务明确匹配上述范围时使用该技能。不应将输出视为环境特定验证、测试或专家评审的替代。若缺少所需输入、权限、安全边界或成功标准，应停止并请求澄清。
知识库
FastAPI 官方文档、Pydantic V2 迁移指南、SQLAlchemy 2.0 异步模式、Python async/await 最佳实践、微服务设计模式、REST API 设计指南、OAuth2 与 JWT 标准、OpenAPI 3.1 规范、Kubernetes 容器编排、现代 Python 打包与工具链。
暂未提供的信息
该技能的收费、价格、平台支持范围、具体安装命令与版本号等事实，资料中暂未提供。