cc-skills-golang 项目搭建工具包项目结构、CI/CD流水线与go.mod依赖管理完全指南【免费下载链接】cc-skills-golang‍ A collection of Golang agentic skills that works项目地址: https://gitcode.com/gh_mirrors/cc/cc-skills-golangcc-skills-golang 是一套面向生产级 Go 项目的 AI 智能体技能集合它为 Claude Code、Codex、Gemini、Cursor、Copilot 等编程助手提供可复用的 Go 开发规范。这篇文章带你快速上手三大核心能力Go 项目结构规划、CI/CD 流水线搭建与go.mod 依赖管理让你用最少的时间搭建出结构清晰、持续集成完善的 Golang 工程。为什么需要这套 Golang 技能工具包新手搭 Go 项目最容易踩三个坑目录结构混乱src/、utils/满天飞、CI 只跑测试不跑安全扫描、依赖升级一拉稀全崩。cc-skills-golang 把资深工程师的项目约定沉淀成「按需加载」的技能文件——AI 助手只在相关话题出现时才读取对应技能不会撑爆上下文。仓库整体由三部分组成目录/文件作用skills/50 个技能每个技能是一个独立目录SKILL.mdreferences/深度文档 assets/模板资产rules/golang-always.mdc常驻加载的 Go 编码规则CLAUDE.md仓库级事实、规范与约束是开发技能文件时的「宪法」快速体验只需一条命令git clone https://gitcode.com/gh_mirrors/cc/cc-skills-golang.gitGo 项目结构cmd、internal、pkg 三层约定项目结构的核心技能位于 skills/golang-project-layout/SKILL.md它给出的黄金法则是结构要为问题规模定制——100 行的 CLI 工具不需要分层架构和依赖注入。通用目录布局大多数项目适用完整布局图见 directory-layouts.md核心约定如下cmd/— 所有main包必须放这里且main.go只保留最小逻辑解析参数、装配依赖、调用Run()。业务逻辑严禁写进cmd/internal/— 私有代码config、handler、model、serviceGo 编译器保证外部无法 importpkg/— 仅当代码确实对外部使用者有价值时才建这个目录配置文件— 根目录常备Makefile、.gitignore、.golangci.yml三件套多二进制项目一个 cmd 子目录一个程序当仓库同时包含 API 服务、CLI 客户端、后台 worker 时每个main包独立成子目录cmd/ ├── server/main.go # API 服务 ├── client/main.go # CLI 客户端 ├── worker/main.go # 后台任务 └── migrate/main.go # 数据库迁移工具一行go build ./cmd/...即可编译全部二进制。开箱即用的 Makefile 构建模板仓库自带一份功能齐全的 Makefile 模板包含build、test带-race和覆盖率、lint、benchmark、deps-update、watch-test等目标拷贝到项目根目录改个BINARY_NAME就能用。CI/CD 流水线从测试矩阵到自动发布CI 技能位于 skills/golang-continuous-integration/SKILL.md为每种流水线场景都配好了可直接套用的 YAML 资产assets/目录。测试流水线版本矩阵 竞态检测参考模板 test.yml四个关键实践缺一不可配置目的strategy.matrix多 Go 版本保证向后兼容fail-fast: false让单个版本失败不拖累其他版本go test -race捕获数据竞争——这在 Go 里是未定义行为-shuffleon随机化测试顺序揪出测试间隐藏依赖go mod tidygit diff --exit-code强制 go.mod/go.sum 与代码同步防止提交前漏跑 tidy质量与安全的流水线全家桶阶段工具模板文件静态检查golangci-lint go vetlint.yml安全扫描gosec、CodeQL、govulnchecksecurity.yml集成测试-count1禁用缓存integration.yml自动发版GoReleaser 交叉编译 校验和release.yml依赖自动更新Dependabot / Renovatedependabot.yml其中govulncheck值得单独强调它只报告你代码实际调用到的漏洞路径比通用 CVE 扫描器精准得多每个版本发布前都应跑一遍。仓库安全基线分支保护、权限最小化见 repo-security.md。进阶玩法是把 AI 智能体拉进 PR 评审——技能插件会为 AI 按评审领域自动应用对应的 Go 技能捕获 linter 看不到的架构漂移、逻辑缺陷和并发隐患完整说明见 GOLANG-AI-DRIVEN-REVIEW.md。go.mod 依赖管理版本、升级与安全审计依赖管理技能位于 skills/golang-dependency-management/SKILL.md核心立场是每个依赖都是长期维护承诺——先用标准库标准库不够才引入外部包。日常依赖工作流速查场景命令清理并补齐依赖go mod tidy每次改动依赖后必跑安全升级go get -upatch ./...只升 patch 版本风险最低校验校验和go mod verify防供应链篡改漏洞审计govulncheck ./...每次发版前必跑查依赖存在原因go mod why -m github.com/some/module离线/可复现构建go mod vendor三条铁律go.sum必须提交——它记录每个依赖版本的加密校验和是go mod verify检测中间人篡改的依据添加新依赖前先三问标准库能解决吗许可证兼容吗维护状态如何CLI 工具用tool指令固定Go 1.24——go get -tool ...把工具版本写进 go.mod团队成员跑go tool golangci-lint时版本完全一致告别「我这边能跑」版本冲突与多模块工作区遇到版本冲突时的replace/exclude/retract解法以及 MVS最小版本选择算法为什么让你「拉不到最新版」详见 versioning.md 与 conflicts.mdmonorepo 场景下用go.work工作区联合多个模块的完整指南在 workspaces.md。快速上手清单git clone https://gitcode.com/gh_mirrors/cc/cc-skills-golang.git获取技能库安装到你的 AI 助手技能目录各客户端安装方式见 README.md新建项目按cmd/internal/pkg/约定搭目录模块名与仓库 URL 一致、全小写、连字符分隔根目录放入 Makefile、.gitignore、.golangci.yml先跑通make build make test make lint把assets/里的 test.yml → lint.yml → security.yml → release.yml 依次接入 CI测试记得加-race -shuffleon依赖只升 patch、发版前govulncheck工具链版本写进 go.mod 的tool块小结cc-skills-golang 的价值不在「替代你的思考」而在把生产级 Go 工程的默认姿势标准化合理的目录结构让新人秒懂代码、完整的 CI 矩阵让每次提交都有质量兜底、严格的 go.mod 纪律让依赖升级不再提心吊胆。配合技能里的references/深度文档每个技能目录都自带这套工具包基本覆盖了从项目初始化到自动发布的全部搭建环节。【免费下载链接】cc-skills-golang‍ A collection of Golang agentic skills that works项目地址: https://gitcode.com/gh_mirrors/cc/cc-skills-golang创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考