用途:规划或审计 Go 项目的模块、仓库布局、包边界、命令结构、迁移策略与实现计划。
主要能力:构建工作流会先检查 go.mod、go.work、cmd/、internal/、包名、现有构建脚本与测试,再提出布局变更;优先采用满足当前仓库的最小模块/包结构,默认不引入架构目录;包围绕行为与导入边界保持内聚,仅在降低耦合、明确归属或形成真正可复用包时才拆分;多个命令或大量支撑代码时把二进制放在 cmd/<name>,单个小命令可放模块根;非公开实现包放 internal/,仅当预期外部复用时才用普通可导入包;命名保持简短、小写、在调用处有意义,避免 user.UserService 这类重复。
使用方式:规划时产出包含验证命令的计划,通常为 go test ./...、go vet ./...、格式化/导入排序以及项目特定的 lint/build 命令。审计时先检查 go.mod、go.work、包树、命令布局、导入边界与测试位置,再判断;仅当确实造成耦合或困惑时才标记不必要的模块、架构目录、公开包、pkg/ 用法或命令位置;检查包名是否内聚、简短、小写且在调用处清晰;报告需给出具体的边界或布局后果,避免表面化重构建议;做完整发现优先的评审时可与 golang-code-audit 搭配。
适用场景:涉及模块布局、包边界、命令放置或工作区设置时,阅读 references/repo-layout.md;涉及服务边界、依赖方向、端口/适配器或领域分层时,搭配 golang-architecture-patterns;计划需包含测试策略时,搭配 golang-testing。
限制:资料未提供具体收费、平台支持范围或效果保证;实际命令与项目特定 lint/build 需按仓库现状确定。