golang-architecture
为 Go 后端项目提供目录结构、分层、依赖方向与基础设施解耦的决策指南。
为什么有这个 skill
把渐进式架构演进、依赖倒置和基础设施边界沉淀成可复用的 Agent 决策上下文。
解决什么问题
Go 项目在 handler、service、domain、infra 等目录之间容易形成高耦合，新增代码难以判断归属。
复制即可安装：安装 golang-architecture
自动探测本机已安装的 Agent；命令中的站点地址会根据当前页面自动生成。
正在生成安装命令…人类说明
golang-architecture
解决什么问题
Go 后端项目经常会遇到这些判断：一个 handler、service、repository、model、Redis 客户端或 MQ consumer 应该放在哪里；业务逻辑是否被数据库、HTTP 框架或第三方 SDK 绑死；项目什么时候应该从技术分层演进为按业务领域垂直切分。
如果这些决策只靠个人经验，项目容易逐渐变成高耦合的“意大利面”，测试困难，团队协作时也更容易产生文件和依赖冲突。
为什么有这个 skill
这个 skill 把 Go 项目从小型单体到微服务的渐进式演进经验整理成 Agent 可以复用的决策标准。它的重点不是强行套用某一种架构，而是根据项目规模、团队协作和业务边界，判断当前最合适的目录位置与依赖方向。
适用范围
适用于：
- Go / Golang 项目目录规划、重构和架构评审；
- handler、service、repository、domain、infra、port 等目录的归属判断；
- Redis、MQ、Cron、第三方 SDK 等基础设施与业务逻辑的解耦；
- DTO、Domain entity、PO 的边界设计；
- 单体项目向业务垂直切分或微服务演进。
不适用于 Python、Node.js、Java 等其他语言的项目架构问题。
内容结构
SKILL.md：Agent 入口和最常用的决策规则；references/architecture-evolution.md：从极简 API 到微服务的阶段演进；references/decoupling.md：依赖倒置和 DTO/Domain/PO 防腐转换；references/components.md：Redis、MQ、Cron 等分布式组件的归属；references/production-patterns.md：优雅停机和全局错误码等生产实践；schema.html：面向人类阅读的完整白皮书。
安装
从仓库根目录执行：
bash scripts/install.sh --skill golang-architecture --yes默认会探测本机已安装的 Agent，只安装到探测到的目录。只安装到某个 Agent 时，添加例如 --target codex-cli；也可以使用仓库根目录安装器的 --dest 参数，将完整 skill 目录复制到指定位置。