Appearance
Everything Claude Code Go Reviewer Agent 是一款面向 Go 语言项目的专业代码审查代理，专注于惯用 Go 编程、并发模式、错误处理和性能优化。它能自动检测安全漏洞、并发缺陷、非惯用写法和性能隐患，确保你的 Go 代码符合生产级最佳实践。与通用 AI 助手相比，go-reviewer 具备更细致的 Go 专项规则和自动触发机制，是提升代码质量与团队协作效率的必备工具。
Everything Claude Code Go Reviewer Agent：惯用 Go、并发模式、错误处理与性能代码审查
Everything Claude Code Go Reviewer Agent（简称 go-reviewer）是 ECC 插件体系中专为 Go 项目设计的代码审查专职代理。它不仅能自动识别 Go 代码中的安全隐患、并发陷阱、错误处理疏漏和性能瓶颈，还能确保代码风格、接口设计和测试用例都符合生产级 Go 社区的最佳实践。
与直接向 Claude 或其他通用 AI 助手提问不同，go-reviewer 具备「领域专精、自动触发、结构化输出和高覆盖」等优势，能在团队协作和 CI/CD 流程中大幅提升代码质量和审查效率。
1. go-reviewer Agent 能解决什么问题？
在 Go 项目开发中，常见的痛点包括：
- 惯用法缺失：新手或跨栈开发者容易写出不符合 Go 社区习惯的代码，影响可维护性。
- 并发安全隐患：Goroutine 泄漏、数据竞争、通道死锁等并发问题难以及早发现。
- 错误处理不规范：错误被忽略、未包装上下文、错误类型判断不严谨，导致线上难以排查。
- 性能陷阱：循环内字符串拼接、slice 未预分配、N+1 查询等常见性能问题。
- 安全漏洞：SQL/命令注入、路径遍历、TLS 配置不当、硬编码密钥等高危漏洞。
go-reviewer 通过自动化审查和结构化报告，帮助团队在代码合并前发现并修复上述问题，极大提升代码质量和安全性。
2. go-reviewer Agent 的具体能力
go-reviewer 的能力覆盖以下方面：
- 安全审查：检测 SQL 注入、命令注入、路径遍历、数据竞争、硬编码密钥和 TLS 配置等安全风险。
- 并发模式检查：识别 goroutine 泄漏、通道死锁、WaitGroup/Mutex 误用等并发相关问题。
- 错误处理规范：检查错误是否被忽略、是否有上下文包装、是否正确使用
errors.Is/As等。 - 惯用 Go 检查：如早返回（early return）、包名规范、接口设计、全局变量滥用等。
- 性能优化建议：如循环内字符串拼接、slice 预分配、N+1 查询、热路径分配等。
- 测试用例模式：建议使用 table-driven 测试，检查测试覆盖和模式。
不能做的事情：
- 不会自动修复代码，只做审查和报告。
- 不会覆盖非 Go 代码（如 Python/JavaScript），需用对应 reviewer agent。
- 不做业务逻辑正确性判断，只关注代码质量和技术实现。
如需 Go 代码惯用法和反模式的详细清单，可参考 Golang Patterns Skill。
3. 触发方式：自动与手动
go-reviewer 支持两种触发方式：
- 自动激活：每当 Go 项目中的
.go文件被修改、保存或提交时，系统会自动调用 go-reviewer 进行代码审查。适合团队协作和 CI 流程，确保每次变更都被审查。 - 手动调用：开发者可在任何时候通过命令面板、Agent 列表或指定命令手动触发 go-reviewer，对指定文件或 diff 进行专项审查。适合个人开发、代码自查或历史代码复查。
自动触发的机制可与 Hooks 体系 集成，实现如 Pre-commit、Pre-PR、Post-Edit 等多阶段自动化审查。
4. 与其他 Agent 的协作模式
go-reviewer 通常与以下 Agent 组合使用，形成完整的 AI 编程工作流：
- go-build-resolver：定位并修复 Go 构建错误。适合先修复编译/静态检查问题，再用 go-reviewer 进行质量审查。
- security-reviewer：全栈安全漏洞扫描。对安全敏感代码，先用 go-reviewer 检查 Go 语言特有风险，再用 security-reviewer 做全局安全审计。
- tdd-guide：辅助测试驱动开发，确保测试覆盖率达到 80%+，与 go-reviewer 配合保障代码质量。
- code-reviewer：多语言项目可用 code-reviewer 做全局审查，go-reviewer 针对 Go 代码做更细致的专项检查。
通过 Everything Claude Code 完全指南 可了解更多 Agent 协作模式和最佳实践。
5. 实际使用示例
以下为一次完整的 go-reviewer 使用对话流程：
场景：开发者提交了一个包含并发处理和数据库操作的 Go 代码变更，准备合并。
自动触发流程：
- 检测到
.go文件变更，go-reviewer 自动激活。 - 执行诊断命令，如
git diff -- '*.go'、go vet ./...、staticcheck ./...，聚焦变更部分。 - 结构化输出审查报告，示例：
markdown
## Go Reviewer 审查报告
### CRITICAL
- [ ] SQL 注入风险：`userInput` 直接拼接到 SQL 查询，建议使用参数化语句。
- [ ] goroutine 泄漏：`go func() {...}` 内未绑定 context，建议传递 `ctx context.Context` 并支持取消。
- [ ] 错误未处理：`db.Exec` 调用结果未检查 error。
### HIGH
- [ ] 未使用 WaitGroup 协调 goroutine，可能导致主流程提前退出。
- [ ] 函数 `ProcessData` 超过 80 行，建议拆分。
### MEDIUM
- [ ] 循环内字符串拼接，建议用 `strings.Builder`。
- [ ] 测试未采用 table-driven 模式。
**结论**：发现 CRITICAL/HIGH 级问题，禁止合并。请先修复上述问题后重新提交。手动调用示例：
开发者在 VSCode/Cursor/CLI 中选择 go-reviewer，指定 service/user.go，收到类似结构化报告，快速定位问题。
6. 为什么要用专门的 go-reviewer Agent？
- 领域专精：内置 Go 语言安全、并发、性能和惯用法的专业规则，远超通用 AI 的细致度。
- 自动化保障：支持自动触发和结构化输出，适合团队协作和 CI 集成，减少人工疏漏。
- 高效协同：可与 build-resolver、security-reviewer 等多 Agent 并行协作，形成完整的 AI 编程流水线。
- 输出一致：所有审查报告结构统一，便于归档、追踪和自动化处理。
- 生产级标准：严格对齐 ECC 的「80%+ 测试覆盖率、安全优先、不可变性」等原则，保障上线质量。
相比直接问 Claude「帮我看看这段 Go 代码有啥问题」，go-reviewer 能自动聚焦变更、执行静态分析、输出分级报告，并严格按照生产级标准把控质量，是专业团队不可或缺的 AI 工具。
7. 常见问题和注意事项
Q: go-reviewer 会自动修复代码吗？
A: 不会。go-reviewer 只负责发现和报告问题，修复需开发者手动完成（可结合 Claude Code 生成修复建议）。Q: 审查报告能自定义输出格式吗？
A: 当前输出结构固定，便于自动化集成和归档。可通过后置脚本或自定义 Hook 进一步处理报告内容。Q: 只会审查变更部分，还是全量代码？
A: 默认聚焦于本次变更的.go文件（git diff），如需全量审查可手动指定范围。
通过 go-reviewer Agent，Go 项目的代码质量、并发安全和性能优化都能实现自动化、结构化和高标准保障。建议所有 Go 项目团队将其纳入开发与 CI 流程，结合 Golang Patterns Skill 和 Hooks 自动化 实现全流程 AI 赋能。