用途:为新建 Go(Golang)项目与服务提供标准化脚手架,确保生成整洁、符合 Go 惯用法的项目结构。
主要能力与约定:仅采用官方 Go 项目布局(cmd/、internal/);明确禁止创建 pkg/ 目录,视为非惯用反模式;默认扁平结构,仅当需要多个二进制或私有包时才引入 cmd/ 与 internal/;要求 go.mod 指定最新稳定 Go 版本(目前 1.24+)。
使用方式:先判断项目范围(简单工具、库还是多服务仓库);然后必须读取并使用 assets/ 目录下的模板,模板内置优雅关闭、run 函数模式与包分离等惯用写法。可用模板包括:assets/cli-simple(扁平结构简单 CLI)、assets/cli-cobra(复杂 CLI)、assets/library(根包 + internal/ 隐藏逻辑)、assets/webservice(cmd/app-name/main.go 入口 + internal/ 私有逻辑)、assets/mcp-server、assets/game(基于 Ebitengine)。初始化步骤:mkdir my-app;go mod init github.com/user/my-app;可选创建 .golangci.yml 进行严格风格约束;复制并按需调整所选模板文件,更新模块名;最后运行 go mod tidy 与 go build ./... 验证。
适用场景:新 Go 命令行工具、库、Web 服务、MCP 服务器及游戏项目初始化。
限制与缺失:参考资料未提供各模板的具体代码内容、支持的 Go 最低版本之外的兼容性说明、收费或授权信息,也未提供实测效果数据。