SuperAPI AI 工具集

backend-engineering

编程与开发

查看项目

更新于 10-16 06:24

技能介绍

本技能是一套后端工程方法论,定位在架构设计(technical-architect)与质量审查(reviewer)之间的实现层。

用途:为服务端系统的实现提供模式与原则参考,涵盖 API、服务逻辑、数据访问、集成与错误处理。

明确归属:负责 API 实现(REST/gRPC/GraphQL 端点、请求校验、响应格式化、错误处理、中间件链)、服务逻辑(业务规则、工作流编排、状态管理、后台任务)、数据库访问模式(查询设计、连接管理、事务边界、N+1 检测、分页)、集成代码(第三方 API 客户端、Webhook 处理、消息队列消费者/生产者)、服务级可观测性埋点(结构化日志、指标、追踪钩子)以及服务级测试(业务逻辑单元测试、API 契约集成测试)。不负责 API 契约与服务边界设计、部署流水线与基础设施、模式设计与迁移、代码审查与质量门禁、可观测性基础设施、测试策略与自动化。

参考文件与加载时机:references/api-patterns.md 用于设计或实现 API 端点(资源建模、版本控制、分页、错误响应格式、请求校验);references/service-patterns.md 用于组织服务逻辑(整洁/六边形/分层架构、依赖注入、中间件组合、请求生命周期、后台任务);references/database-testing.md 用于数据库访问模式(连接池、查询优化、N+1 检测、分页策略、事务边界、读写分离、复制延迟)与服务级测试(单元测试业务逻辑、用 test containers/WireMock 做 API 契约集成测试、用 Pact 做契约测试、测试夹具、CI 集成);references/integration-patterns.md 用于集成外部系统(带退避的重试、断路器、幂等键、Webhook 校验、消息队列消费者);references/error-handling.md 用于系统性处理错误(客户端/服务端分类、结构化响应、异常处理模式、可观测性关联)。

核心原则:接口即契约,端点签名、请求 schema、响应格式与错误码都是对消费者的承诺,破坏性变更是协调问题而非版本号问题;业务逻辑是重心,应与框架、传输协议和基础设施细节隔离;在具备足够上下文处捕获错误;为失败而设计,幂等、重试与优雅降级是要求而非优化;在正确层级测试,业务逻辑用单元测试、API 契约用集成测试、服务边界用契约测试。

限制:资料未提供安装方式、具体代码示例、收费或平台信息。