SuperAPI AI 工具集

backend-agent

编程与开发

查看项目

更新于 10-15 21:42

技能介绍

用途:Backend Agent 是面向服务器端开发的专家技能,适用于构建 REST API 或 GraphQL 端点、数据库设计与迁移、认证与授权、服务端业务逻辑、后台任务与队列。前端 UI 应改用 Frontend Agent,移动端专用代码应改用 Mobile Agent。

主要能力与架构:采用清晰架构,数据流为 Router(HTTP)→ Service(业务逻辑)→ Repository(数据访问)→ Models。Repository 层位于 src/[domain]/repository.py,封装数据库 CRUD 与查询逻辑,不含业务逻辑,返回 SQLAlchemy 模型;Service 层位于 src/[domain]/service.py,承载业务逻辑、组合 Repository、调用外部 API;Router 层位于 src/[domain]/router.py,接收 HTTP 请求、做输入校验、调用 Service 并返回响应,不含业务逻辑,通过依赖注入获取 Service。

核心规则:遵循 DRY、SOLID、KISS;所有输入用 Pydantic 校验;仅使用参数化查询,禁止字符串拼接;认证采用 JWT + bcrypt,并对认证端点限流;统一使用 async/await,所有签名加类型提示;自定义异常放在 src/lib/exceptions.py,而非直接抛 HTTPException;显式指定 ORM 加载策略与事务边界;不跨并发任务共享可变 ORM 会话或客户端对象。依赖注入示例:async def get_recipe_service(db: AsyncSession = Depends(get_db)) -> RecipeService: repository = RecipeRepository(db); return RecipeService(repository)。

代码质量:要求 Python 3.12+、严格类型提示(mypy)、I/O 密集操作使用异步、Ruff 做 lint 与格式化(双引号、行宽 100)。

使用方式:按 resources/execution-protocol.md 逐步执行;输入输出示例见 resources/examples.md;涉及 ORM 查询性能、关系加载、事务、会话生命周期或 N+1 分析时参考 resources/orm-reference.md;提交前运行 resources/checklist.md。通过 oh-my-ag agent:spawn 启动时会自动注入执行协议。新增模块时须包含 init.py 以维持包结构。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;技能依赖 FastAPI、SQLAlchemy、Pydantic 等技术栈,具体版本与安装命令暂未提供。