BAIZE AI RESOURCE

Go 错误处理规范 Skill

Golang-error-handling

Golang-error-handling 是面向 Go 项目的 AI Skill，指导编写和审查错误处理代码。它覆盖错误创建、包装、检查与日志记录，帮助开发者减少遗漏错误、重复日志和缺少上下文的问题。

获取资源
Golang-error-handling

资源介绍

Golang-error-handling 是供 Claude Code、Codex 等兼容工具使用的 Go 错误处理 Skill，适合正在编写 Go 代码、审查代码变更或检查现有项目的开发者。它提供错误创建、包装和检查的实践规则，例如用上下文包装错误、检查返回的错误，以及根据需要使用 errors.Is、errors.As 和 errors.Join。它也关注错误应记录还是向上返回、何时不该使用 panic，以及如何用结构化日志保留排查所需的信息。使用时可让 AI 助手围绕 Go 文件编写错误处理代码、审查 PR 差异，或按不同问题类别检查较大的代码库，减少静默失败、重复记录和难以定位的错误。

Skill 能力

规范错误创建与包装

指导使用清晰的错误消息、哨兵错误和自定义错误类型，并通过 %w 为向上返回的错误补充上下文。

检查错误链

指导使用 errors.Is 和 errors.As 检查错误链，并在适用时用 errors.Join 合并独立错误。

审查错误处理遗漏

在代码审查或项目检查中识别被忽略的返回错误、缺少包装上下文，以及同一错误既记录日志又向上返回的问题。

改进错误日志

指导使用 slog 记录结构化错误信息，并保持日志消息模板稳定，便于按类别汇总和排查。

资源配置

适用平台

Claude CodeCodex通用 Agent

调用方式

手动调用Agent调用

安装与调用

  1. 阅读资源包中的中文说明和上游官方文档。

  2. 核对版本、运行环境与依赖条件后完成配置。

  3. 先在隔离环境验证主要功能，再用于实际场景。

使用案例

审查 Go 代码变更

使用场景开发者提交了涉及错误处理的 PR。

让助手重点检查变更中是否忽略了返回错误、缺少包装上下文，或出现记录日志后又返回同一错误的情况。

检查现有项目的错误处理

使用场景维护者需要梳理较大 Go 代码库中的常见错误处理问题。

让助手分别检查错误创建、包装、单次处理原则、panic/recover 和结构化日志，并汇总发现的问题。

包含内容

golang-error-handling-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
SHA256.txt

常见问题

Golang-error-handling 适用于哪些工具和项目？
SKILL.md 标明它面向 Claude Code、Codex 或类似的 Skill 运行工具，以及使用 Go 的项目；其适用文件路径为 **/*.go。
它会如何检查被包装的错误？
它指导使用 errors.Is 匹配哨兵错误、使用 errors.As 检查错误类型；对于 Go 1.26 及以上版本，适用时还建议使用 errors.AsType。
它如何避免同一错误产生重复日志？
它采用“记录日志或向上返回，二选一”的处理原则，并将同时记录和返回同一错误列为审查问题。