SuperAPI AI 工具集

go-code-review

测试与质量

查看项目

更新于 10-15 21:37

技能介绍

用途:为 Go 项目提供结构化代码审查流程,强调审查应建设性、具体,并为每条发现引用对应原则。

主要能力:按严重程度分级——🔴 BLOCKER(合并前必须修复,涉及正确性、数据丢失、安全)、🟡 WARNING(应修复,涉及可维护性、惯用 Go、清晰度)、🟢 SUGGESTION(可改进,涉及风格、命名、文档)。审查维度包括:正确性与安全(错误检查与包装、errors.Is/As、panic 使用、nil 安全、并发与 goroutine 泄漏、context 传播)、API 设计(导出项文档注释、接口与具体类型、函数式选项、context 首参、error 末返回值)、惯用 Go(:= 与 var、提前返回、defer 清理、range、结构体字段名、接口定义位置)、包结构(命名、循环依赖、internal/、cmd/)、测试(TestXxx、表驱动、t.Helper、TestMain、边界用例、t.Parallel)、文档、依赖(go.mod、未使用依赖、来源可靠性)。

使用方式:先选择模式——差异审查(默认,仅看改动行及必要上下文,用于 PR 和工作区改动)、文件/包审查(完整审查指定文件或包及其测试)、全库审计(按“审计大型代码库”策略汇总为一份报告)。随后按顺序执行:先运行工具链,命令为 go build ./...、go vet ./...、golangci-lint run、go test -race ./...(未安装的工具跳过并在报告中注明);go vet 失败自动视为 🔴 BLOCKER。再按第 1 至 7 节逐项人工审查。范围超过约 20 个文件时,用 go list ./... 枚举包并按层分组,每个关注点单独一轮审查,环境支持时可并行委派子代理,否则顺序执行;每条发现需标注 file.go:line 与严重级别,最后合并、去重、按严重度排序。输出格式为 Code Review Summary,含审查文件、总体结论(APPROVE / REQUEST CHANGES / COMMENT)、分级发现(文件、问题、依据原则、具体修复建议)以及至少一条真实的正向观察。

适用场景:Go 项目的 PR 审查、工作区改动检查、指定文件或包审查,以及大型代码库的整体审计。

限制:资料未提供该技能的安装方式、收费、价格、支持平台或实际效果等信息;工具链命令需本地已安装对应工具,未安装者应跳过并注明。