用途:本技能面向全栈开发,提供创建生产级 FastAPI 项目的最佳实践与模式指导,适合从零开始搭建 FastAPI 应用、实现异步 REST API、构建高性能 Web 服务与微服务,以及配合 PostgreSQL、MongoDB 的异步应用和带测试的 API 项目结构。
主要能力:给出推荐的项目目录结构,按 api(含 v1/endpoints 与 router)、core(config、security、database)、models、schemas、services、repositories、main.py 分层组织;讲解基于 Depends 的依赖注入,用于数据库会话管理、认证授权、共享业务逻辑与配置注入;说明异步模式,包括异步路由处理、异步数据库操作、异步后台任务与异步中间件。
使用方式:技能以指导与模式说明为主,详细实现示例位于 references/details.md,导航摘要不足时可查阅该文件。测试部分给出 pytest 与 httpx 的异步测试写法,使用 sqlite+aiosqlite:///:memory: 作为测试数据库,通过 app.dependency_overrides 覆盖 get_db 依赖,并用 AsyncClient 发起请求断言状态码与返回数据。
适用场景:新建 FastAPI 项目、异步 API 开发、微服务与高性能服务搭建、需要规范结构与测试的后端工程。
限制:需要用户提供具体项目上下文与技术栈信息;仅提供架构与实现指导,不直接产出具体代码实现;不涉及非技术领域的业务决策。注意事项包括避免过度设计、重视性能与安全、保证测试覆盖(尤其边界情况)、保持文档与代码同步。内容源自 wshobson/agents,遵循 MIT 许可,使用、修改与再分发须保留版权声明。