SuperAPI AI 工具集

fullstack-dev

编程与开发

查看项目

更新于 10-15 17:26

技能介绍

该技能面向全栈应用开发,触发时机包括搭建全栈应用、创建带前端的 REST API、脚手架新后端服务、设计服务层与模块边界、实现数据库访问/缓存/后台任务、编写错误处理与日志、审查后端架构、生产加固,以及设置 API 客户端、认证、文件上传或实时功能。不适用于纯前端/UI、脱离后端语境的数据库模式设计。

它规定了一套强制工作流:Step 0 收集需求(技术栈、服务类型、数据库、集成方式 REST/GraphQL/tRPC/gRPC、是否实时与认证方式),Step 1 做架构决策(项目结构、API 客户端、认证策略、实时方式、错误处理),Step 2 按清单脚手架,Step 3 按文档模式实现,Step 4 测试验证,Step 5 交接总结。验证命令示例:在 server 与 client 分别执行 npm run build,再启动服务后 curl http://localhost:3000/health 与 /api/<resource>,并检查 CORS、API base URL、认证流及实时同步。

核心原则为七条:按功能而非技术层组织;控制器不含业务逻辑;服务层不导入 HTTP 请求/响应类型;所有配置来自环境变量并在启动时校验、快速失败;每个错误都有类型、被记录并返回一致格式;边界处校验所有输入;使用带请求 ID 的结构化 JSON 日志。

主要能力覆盖:特性优先的三层架构(Controller → Service → Repository)与依赖注入示例;集中式类型化配置与必需环境变量校验;类型化错误层级、全局错误处理器、瞬态失败重试;数据库迁移、N+1 预防、事务、连接池;四种 API 客户端方案(类型化 fetch 封装、React Query、tRPC、OpenAPI 生成);认证与中间件顺序(RequestID、Logging、CORS、RateLimit、BodyParse、Auth、Authz、Validation、Handler、ErrorHandler);日志与可观测性;后台任务;缓存;文件上传;SSE/WebSocket 实时模式;跨边界错误处理;生产加固。

限制:资料未提供具体收费、价格、平台支持范围或效果数据,暂未提供。使用时应遵循文档中给出的清单与规则,不跳过检查项。