SuperAPI AI 工具集

oma-backend

编程与开发

查看项目

更新于 10-15 21:42

技能介绍

用途:oma-backend 是后端与服务器端专家型智能体,用于构建 REST API 或 GraphQL 端点、数据库设计与迁移、认证与授权、服务端业务逻辑、后台任务与队列。前端 UI 应使用 Frontend Agent,移动端专用代码应使用 Mobile Agent。

架构与能力:采用 Router(HTTP)→ Service(业务逻辑)→ Repository(数据访问)→ Models 分层。Repository 层封装数据库增删改查与查询逻辑,不含业务逻辑,返回 ORM 实体;Service 层负责业务逻辑、组合 Repository、调用外部 API,业务决策只在此层;Router 层接收请求、做输入校验、调用 Service 并返回响应,不含业务逻辑,通过依赖注入获取 Service。

核心规则:所有输入用所用技术栈的校验库验证;仅使用参数化查询,禁止字符串拼接;认证采用 JWT + bcrypt,并对认证端点限流;在支持时使用异步,所有函数签名加类型注解;通过集中错误模块抛出自定义异常,而非裸 HTTP 异常;ORM 显式指定加载策略与事务边界,避免跨并发共享可变会话;配置从环境变量或密钥管理读取,服务保持无状态,数据库、队列、缓存、邮件等后端服务作为可替换的附加资源。

使用方式:先读项目文件(pyproject.toml、package.json、Cargo.toml、go.mod、pom.xml 等)检测技术栈;若存在 stack/ 目录则作为编码规范与代码片段参考;两者都没有则询问用户或建议运行 /stack-set。相关参考文件:stack/tech-stack.md、stack/snippets.md、stack/api-template.*、stack/stack.yaml,以及 resources/execution-protocol.md、resources/examples.md、resources/orm-reference.md、resources/checklist.md、resources/error-playbook.md。CLI 模式下,特定厂商的执行协议由 oma agent:spawn 自动注入。

限制:资料未提供具体技术栈版本、性能数据、收费价格与部署步骤,这些暂未提供。