SuperAPI AI 工具集

golang-error-handling

编程与开发

查看项目

更新于 10-16 08:44

技能介绍

用途:该技能指导在 Go 应用中编写健壮、符合惯例的错误处理代码,可作为编码、代码审查和大型代码库错误处理审计的指南。

主要能力:错误创建与消息规范(小写、无结尾标点);用 fmt.Errorf("{context}: %w", err) 包装错误,内部用 %w、系统边界用 %v 控制链暴露;用 errors.Is 做哨兵匹配,errors.As 或 Go 1.26+ 的 errors.AsType 做类型链检查;用 errors.Join(Go 1.20+)合并独立错误;区分哨兵错误与携带数据的自定义类型;遵循单一处理原则,错误只记录或只返回,绝不同时;panic 仅用于真正不可恢复状态;用 slog(Go 1.21+)做结构化日志;生产错误可借助 samber/oops 携带堆栈、租户上下文与结构化属性。

使用方式:技能提供三种模式——编码模式按最佳实践顺序编写新代码,可选后台子代理检查相邻代码;审查模式聚焦 PR 差异中的吞错、缺失包装上下文、记录后又返回、panic 误用;审计模式最多使用 5 个并行子代理,分别针对创建、包装、单一处理规则、panic/recover、结构化日志。在 Claude Code 中可用 ultracode 显式启用多代理编排。

适用场景:Go 项目错误处理规范落地、代码评审、较大代码库的批量审计,以及与可观测性、安全、命名、CI 等关联技能配合使用。

限制:所有规则以 Go 语言及其标准库版本为前提,如 errors.AsType 需 Go 1.26+、errors.Join 需 Go 1.20+、slog 需 Go 1.21+;具体平台、收费方式与安装命令资料未提供。