SuperAPI AI 工具集

sota-golang

编程与开发

查看项目

更新于 10-16 00:06

技能介绍

用途:这是一套面向 Go 1.25+(2026 基线)的工程规则集,供 Claude 在生成新 Go 代码(BUILD 模式)或审计既有代码(AUDIT 模式)时遵循,强调每条规则都说明理由,并以 grep/vet/lint 审计清单收尾。

主要能力:规则按文件组织,包括 01 错误处理(%w 包装、errors.Is/As、panic 策略)、02 设计(接口位置与大小、包布局、context 纪律)、03 并发(goroutine 生命周期、泄漏、errgroup、channel 与 mutex 取舍)、04 HTTP 服务(服务端与客户端超时、连接复用、优雅关闭、slog)、05 安全(SQL 参数化、os/exec、路径遍历与 os.Root、整数溢出、TLS、govulncheck、供应链)、06 性能(pprof、b.Loop、分配优化、sync.Pool、GOGC/GOMEMLIMIT、PGO)、07 工具链与 CI(golangci-lint、staticcheck、表驱动测试、t.Parallel、fuzzing、go.mod 卫生)。

使用方式:BUILD 模式先读与任务相关的规则文件,无条件应用十条不可协商项,新模块用 go mod init 并配置 golangci-lint 与 CI(go vet、golangci-lint run、go test -race ./...、govulncheck ./...);因正当理由偏离规则时留 // NOTE(sota): 注释。AUDIT 模式逐条执行审计清单命令,人工确认命中后按 CRITICAL/HIGH/MEDIUM/LOW/INFO 分级,用固定 finding 格式报告,并按严重度分组、给出计数与最高杠杆修复项。

适用场景:编写或审查生产 Go 服务、并发代码、HTTP 服务、安全边界输入处理、性能优化与 CI 配置。

限制:基线为 Go 1.25+,部分特性(如 errors.AsType、Green Tea GC)属 1.26;测试策略细节由 sota-testing 负责,本技能只覆盖 Go 运行器机制。具体安装与调用方式资料未提供。