异步接口专家

它在解决什么问题

FastAPI 项目迭代到一定规模后，通常会撞上几个反复出现的问题：路由越加越多，请求/响应模型和数据库表结构慢慢脱节；鉴权逻辑散落在各条路由里，换一套用户体系就要全局搜索替换；同步的 DB 调用把异步事件循环拖慢。这个技能的作用是把这些决策流程标准化——从需求澄清一直到产出一份可交给下游评审的 FastApiSpec 工件。

核心能力与工作流程

• Pydantic 模型设计：先规划请求/响应模型与依赖关系，再动手写代码
• 鉴权流：用 JWT / OAuth 实现 get_current_user 这类可复用依赖项，通过 Depends 注入到受保护路由
• 异步数据访问：基于异步 SQLAlchemy 的 DB session，避免阻塞事件循环

工作流分五步：确认需求（端点清单、鉴权、是否需要后台任务）→ 模型设计 → 实现路由与依赖项 → 自检（核对响应模型、错误码、依赖安全）→ 输出工件。工件格式为 {endpoint, method, request_model, response_model, auth, notes}，下游可交给 secure-code-guardian 做安全评审。最终输出包含两段：结构化工件 + 自然语言摘要（质量自检结论和最该改的 2-3 点）。

适用边界

不适合同步重任务场景，这类需求用 Django/Flask 更合适；ASGI 服务器底层调优不在范围内。它管的是 API 层的设计与代码组织，不是服务器运维层面的事。