SuperAPI AI 工具集

backend-agent

编程与开发

查看项目

更新于 10-15 21:42

技能介绍

用途:用于构建 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 并返回响应,不含业务逻辑。

核心规则:遵循 DRY、SOLID(单一职责、通过 FastAPI Depends 实现依赖倒置)与 KISS。所有输入用 Pydantic 校验;只使用参数化查询,禁止字符串拼接;认证采用 JWT + bcrypt,并对认证端点限流;统一使用 async/await;所有签名加类型提示;自定义异常放在 src/lib/exceptions.py,不使用原始 HTTPException;显式指定 ORM 加载策略,查询形态重要时不依赖默认关系加载;显式事务边界,将一次业务操作归入一个请求或服务作用域的工作单元;不跨并发任务共享可变 ORM session/实体管理器/客户端对象,除非 ORM 明确支持。

使用方式:按 resources/execution-protocol.md 执行;查看 resources/examples.md 获取输入输出示例;涉及 ORM 查询性能、关系加载、事务、会话/客户端生命周期或 N+1 分析时参考 resources/orm-reference.md;提交前运行 resources/checklist.md。通过 oh-my-ag agent:spawn 生成时协议自动注入。新增模块时须包含 init.py 以保持包结构。代码质量要求 Python 3.12+、严格类型提示(mypy)、Ruff 检查格式化(双引号、行宽 100)。

限制:定价、收费与平台信息暂未提供。