用途:帮助开发者用 Go 与 Gin 构建生产级 REST API,覆盖日常开发中约八成常用模式,包括服务器搭建、路由、请求绑定、响应格式化与错误处理。
主要能力:提供分层项目结构建议(cmd/api/main.go 入口、internal/handler、internal/service、internal/repository、internal/domain、pkg/middleware);服务器搭建规则(使用 gin.New() 加显式 r.Use(...),设置 r.SetTrustedProxies(...) 与 ReadHeaderTimeout: 10s);处理器规则(绑定输入、调用服务、格式化响应,使用 ShouldBind* 系列,传递 c.Request.Context(),向 goroutine 传 *gin.Context 前调用 c.Copy());请求绑定(ShouldBindJSON、ShouldBindQuery、ShouldBindURI);日志使用 log/slog;错误响应不暴露原始 err.Error();输入清洗与文件上传路径处理;分页边界限制;后台 goroutine 使用 ticker 加 select 加 ctx.Done()。
使用方式:作为技能加载后,在创建 Go Web 服务器、添加 Gin 路由、编写处理器或询问中间件、绑定、错误处理时触发。可按需加载 references 下的参考文件,涵盖服务器与处理器、路由分组与版本、参数与通配符、校验器与限制、中间件核心与日志恢复、超时与自定义、错误处理、防御性模式、WebSocket、限流、文件上传、后台任务等主题。
适用场景:新建 Go REST API、为 Gin 应用添加路由与中间件、绑定校验 JSON/查询/URI 参数、组织分层项目结构、返回一致的 JSON 错误响应。
限制:不处理认证、数据库集成、部署、API 文档与测试,这些分别由 golang-gin-auth、golang-gin-database、golang-gin-deploy、golang-gin-swagger、golang-gin-testing 技能负责。具体安装命令与收费信息暂未提供。