SuperAPI AI 工具集

go-architecture

编程与开发

查看项目

更新于 10-16 09:56

技能介绍

Go Architecture 提供 2026 年当前的结构化 Go 后端服务指导,偏向标准库与小型可组合库,而非重型框架。

适用场景:搭建新 Go 模块或服务(目录结构、cmd/、internal/);选择 HTTP 路由(标准库 net/http.ServeMux、chi、echo/gin/fiber);选择数据库层(sqlc + pgx、GORM)或组织查询;依赖注入与装配(构造函数、不用框架的 DI);审查既有 Go 服务的结构或架构问题。

不适用场景:测试、基准、模糊测试、覆盖率(改用 go-testing-quality);SOLID 行数限制与接口放置(改用 fuse-solid:solid-go);非 Go 后端(Laravel、Next.js、Rust);前端与 UI 工作。

决策映射:文件与包放置参考 project-layout.md;HTTP 路由参考 http-routing.md;数据库访问参考 database-access.md;依赖注入参考 dependency-injection.md;完整可运行示例参考 templates/rest-service.md。

核心原则:标准库优先——Go 1.22 起 net/http.ServeMux 支持方法匹配与路径通配符(GET /posts/{id},req.PathValue("id")),多数服务无需路由框架;internal/ 是服务逻辑默认位置,二进制放在 cmd/;默认使用构造函数注入,不引入 DI 框架;类型安全 SQL 是当前默认,sqlc 从原始 SQL 生成惯用 Go,配合 pgx 驱动用于 PostgreSQL,GORM 仍可用但新服务中相对减少。

工作流:先探查既有目录树,不预设布局;从决策映射加载相关参考;对版本敏感断言(路由、sqlc/pgx)在写代码前核对来源 URL;新项目可用 templates/rest-service.md 脚手架;保持文件小、接口分离;改动后用 go-testing-quality 与 sniper 验证。

边界:社区技能集 github.com/samber/cc-skills-golang 覆盖重叠领域;本技能仅限架构、结构、路由与数据库接线,测试交给 go-testing-quality。具体命令与模板内容资料未完整提供。