SuperAPI AI 工具集

fba

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能面向 FastAPI Best Architecture(fba)项目的开发工作,帮助在 fba 项目中设计、实现、审查或记录 API、Schema、Service、CRUD、Model 以及插件代码,遵循 fba 的架构与插件约定。官方文档见 https://fastapi-practices.github.io/fastapi_best_architecture_docs/。

主要能力与架构:项目采用以 API、Service、CRUD 为核心的分层后端架构,Schema 与 Model 作为显式数据契约。API 负责路由处理、参数校验与响应返回;Schema 定义请求/响应数据结构;Service 承载业务逻辑、数据处理与异常处理;CRUD 负责数据库操作(继承 CRUDPlus);Model 为 ORM 模型(继承 Base)。

使用方式:先加载必需的编码基线,再按任务加载额外参考。所有后端 Python 实现、修复、重构或代码审查,在动手前需阅读 references/coding-style.md 与 references/naming.md;跨层功能、目录变更或 SDK 集成还需先读 references/development.md 再确定模块边界。按任务选择参考:功能/模块开发流程、Service/CRUD 放置、分页、缓存、Celery、i18n、代码生成读 references/development.md;API 路由、依赖、响应模式、认证、权限读 references/api.md;Pydantic DTO 读 references/schema.md;SQLAlchemy 模型与迁移读 references/model.md;命名读 references/naming.md;插件开发与 README 读 references/plugin.md;插件分享、公共仓库、市场 PR、子模块、更新读 references/plugin-sharing.md;全局设置读 references/config.md。开发流程为:定义数据库模型、定义数据校验模型、定义路由、编写业务逻辑、编写数据库操作。CLI 可执行 fba -h 查看详情。

限制与注意:需保持请求范围,插件全面审查覆盖该插件所有维护模块及受影响测试,普通功能或修复不授权无关的全仓库清理;仅文档工作加载相关文档参考,无需 Python 基线。完成前应用 coding-style.md 中的审查检查,仅 Ruff 通过不足以验证函数设计、测试驱动辅助提取或层边界。文档与实现不一致时,以 fastapi-best-architecture 源码行为为准。除非用户明确要求,不执行 git add、commit、push 或 PR 操作。