# go-code-review

Скилл go-code-review проверяет Go-код на идиоматичность, обработку ошибок и гонки: сначала читает go.mod, потом разбирает функции целиком.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 206 установок · ★ 89 у репозитория
- Автор: existential-birds
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/existential-birds/beagle/tree/HEAD/plugins/beagle-go/skills/go-code-review/SKILL.md
- Обновлён: 2026-09-15
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/existential-birds-go-code-review

## Что делает

Ревью идёт по фиксированной последовательности. Первым делом скилл открывает `go.mod` и запоминает значение директивы `go`, потому что от него зависит, какие советы уместны: захват переменной цикла важен только до 1.22, `slog` появляется в 1.21, `errors.Join` в 1.20. Дальше читает целые функции, куда попали правки, а не отдельный хунк диффа.

Потом выбирает блоки чек-листа под конкретное изменение: обработка ошибок, конкурентность, интерфейсы и типы, ресурсы, нейминг. К каждому блоку есть справочник в `references/` — `error-handling.md`, `concurrency.md`, `interfaces.md`, `common-mistakes.md`. Замечания выдаются в формате `[FILE:LINE] ISSUE_TITLE` с уровнем Critical, Major, Minor или Informational.

Четвёртый шаг загружает соседний скилл `review-verification-protocol` по пути `../review-verification-protocol/SKILL.md`. Без него проверка перед отчётом не пройдёт, и часть работы останется не сделанной. Внутри есть список валидных паттернов (`_ = err` с комментарием, `//nolint` с причиной, `sync.Pool` в горячем пути), чтобы не сыпать ложными замечаниями.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add existential-birds/beagle --skill go-code-review -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add existential-birds/beagle --skill go-code-review -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add existential-birds/beagle --skill go-code-review -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install existential-birds/beagle plugins/beagle-go/skills/go-code-review
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add existential-birds/beagle --skill go-code-review -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/existential-birds/beagle --path plugins/beagle-go/skills/go-code-review
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add existential-birds/beagle --skill go-code-review -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/existential-birds/beagle/tree/HEAD/plugins/beagle-go/skills/go-code-review/SKILL.md

## Когда брать
- поймать непроверенную ошибку на сетевом вызове
- найти горутину без пути завершения
- проверить захват переменной цикла в коде до Go 1.22
- разложить замечания по серьёзности перед мержем
- отсеять идиоматичные паттерны, которые только кажутся ошибкой

## Примеры запросов агенту
- Отревьюй `internal/queue/worker.go`: сначала посмотри `go.mod`, потом читай функции целиком.
- Проверь горутины и каналы в этом диффе и разложи замечания по severity.
- Прогони чек-лист по интерфейсам и generics в пакете `storage`.

## Похожие
- [go-concurrency-review](https://affpapa.org/nevibecode/skills/go-concurrency-review.md) — скилл · ★ 90 у репозитория
- [go](https://affpapa.org/nevibecode/rules/patrickjs-go.md) — правило · ★ 41178 у репозитория
- [golang-patterns](https://affpapa.org/nevibecode/skills/golang-patterns.md) — скилл · 7200 установок
- [golang](https://affpapa.org/nevibecode/skills/golang.md) — скилл · 535 установок
- [go-context](https://affpapa.org/nevibecode/skills/eduardo-sl-go-context.md) — скилл · ★ 90 у репозитория
- [java-code-review](https://affpapa.org/nevibecode/skills/java-code-review.md) — скилл · 1200 установок

## Другие версии с тем же именем
- [go-code-review · cxuu](https://affpapa.org/nevibecode/skills/go-code-review.md) — 1800 установок
- [go-code-review · eduardo-sl](https://affpapa.org/nevibecode/skills/eduardo-sl-go-code-review.md) — ★ 90 у репозитория

Из того же набора: [existential-birds/beagle](https://affpapa.org/nevibecode/by/existential-birds/beagle.md) — 68 карточек

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

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