# go-error-handling

Скилл задаёт агенту правила работы с ошибками в Go: обёртка через %w, sentinel-ошибки, свои типы и errors.Is/errors.As.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 83
- Автор: eduardo-sl
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/eduardo-sl/go-agent-skills/tree/HEAD/skills/(code-quality)/go-error-handling/SKILL.md
- Обновлён: 2026-10-15
- HTML: https://affpapa.org/nevibecode/skills/eduardo-sl-go-error-handling

## Что делает

Скилл описывает, как в Go создавать, оборачивать и проверять ошибки. Внутри — дерево решений: простая ошибка через `errors.New`, добавление контекста через `fmt.Errorf` с `%w`, sentinel-ошибки уровня пакета для случаев, когда вызывающий код должен распознать сбой, и свои типы, если ошибка несёт структурированные данные.

Отдельные разделы — про `Unwrap` у типа-обёртки, про правило обрабатывать ошибку ровно один раз (логировать или возвращать, но не то и другое), про именование (`Err` для sentinel, суффикс `Error` для типов, сообщения строчными без точки) и про границы модуля: что публиковать через `%w`, а что прятать за `%v`. Есть и правила паники — только для сломанной инициализации и нарушенных инвариантов.

Скилл рассчитан на работу в проекте на Go, поэтому нужен тулчейн Go: без него команды `go` и `gofmt` из списка разрешённых инструментов ничего не сделают. Часть материала вынесена в `references/patterns-and-boundaries.md` и подгружается по необходимости. Если в проекте есть своё правило про обработку ошибок, оно перекрывает этот скилл.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add eduardo-sl/go-agent-skills --skill go-error-handling -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/go-error-handling/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/go-error-handling/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add eduardo-sl/go-agent-skills --skill go-error-handling -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/go-error-handling/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add eduardo-sl/go-agent-skills --skill go-error-handling -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/go-error-handling/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install eduardo-sl/go-agent-skills go-error-handling
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/go-error-handling/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add eduardo-sl/go-agent-skills --skill go-error-handling -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/eduardo-sl/go-agent-skills --path 'skills/(code-quality)/go-error-handling'
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/go-error-handling/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add eduardo-sl/go-agent-skills --skill go-error-handling -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/eduardo-sl/go-agent-skills/tree/HEAD/skills/(code-quality)/go-error-handling/SKILL.md

## Когда брать
- обернуть ошибку из базы так, чтобы вызывающий код мог её распознать
- завести sentinel-ошибку для «не найдено» и проверять её через `errors.Is`
- сделать свой тип ошибки с полями и не порвать цепочку `Unwrap`
- убрать двойную обработку, когда ошибка и логируется, и возвращается
- решить, отдавать ли внутреннюю ошибку наружу или спрятать за `%v`

## Примеры запросов агенту
- Оберни ошибки в `getUser` через `%w` и добавь контекст с id
- Заведи sentinel-ошибки для «не найдено» и «нет доступа» и проверяй их через `errors.Is`
- Сделай тип `ValidationError` с полем `Field` и доставай его через `errors.As`

## Похожие
- [golang-error-handling](https://affpapa.org/nevibecode/skills/golang-error-handling.md) — скилл · 43400 установок
- [error-handling](https://affpapa.org/nevibecode/skills/error-handling.md) — скилл · 4800 установок
- [error-handling-patterns](https://affpapa.org/nevibecode/skills/error-handling-patterns.md) — скилл · 22957 установок
- [m06-error-handling](https://affpapa.org/nevibecode/skills/m06-error-handling.md) — скилл · 3500 установок
- [python-error-handling](https://affpapa.org/nevibecode/skills/python-error-handling.md) — скилл · 14116 установок
- [Error Handling taste](https://affpapa.org/nevibecode/prompts/error-handling-taste.md) — промпт · ★ 174676

## Другие версии с тем же именем
- [go-error-handling · cxuu](https://affpapa.org/nevibecode/skills/go-error-handling.md) — 1300 установок

Из того же набора: [eduardo-sl/go-agent-skills](https://affpapa.org/nevibecode/by/eduardo-sl/go-agent-skills.md) — 11 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md