# go-expert

Скилл go-expert для Claude Code задаёт агенту правила идиоматичного Go: горутины, каналы, отмена через context и обёртка ошибок. Помогает править бэкенд и разбирать утечки.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 190 установок · ★ 45 у репозитория
- Автор: PCL Team
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/languages/go-expert/SKILL.md
- Обновлён: 2026-10-12
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/go-expert

## Что делает

Скилл даёт агенту роль эксперта по Go и набор соглашений, по которым он правит код. Короткие имена в локальной области, прямой доступ к полям вместо геттеров, интерфейс на входе функции и структура на выходе, ранние возвраты вместо вложенных `if`. Ошибки оборачиваются через `%w`, `defer` закрывает файлы, слайсы создаются с запасом по ёмкости.

Два шаблона разобраны кодом: синглтон на `sync.Once` и builder для SQL-запроса с цепочкой методов. В разделе антипаттернов — проигнорированная ошибка, горутина без условия выхода и `panic` вместо возврата ошибки; к каждому случаю дана исправленная версия. Дальше шпаргалка по командам: `go test -cover ./...`, `go vet ./...`, `go mod tidy`.

Инструменты у скилла ограничены: Read, Write, Edit, Glob, Grep и `Bash(go:*)`. Поэтому на машине нужен Go 1.21 или новее — без `go` в `PATH` агент не прогонит тесты и сборку. Примеры рассчитаны на возможности 1.22+, так что в проекте на более старой версии часть кода не соберётся.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill go-expert -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill go-expert -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill go-expert -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install personamanagmentlayer/pcl stdlib/languages/go-expert
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill go-expert -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/personamanagmentlayer/pcl --path stdlib/languages/go-expert
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill go-expert -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/languages/go-expert/SKILL.md

## Когда брать
- Найти горутину, которая не завершается и течёт
- Обернуть ошибку с контекстом через `%w`
- Отменить долгую операцию по таймауту через `context`
- Собрать HTTP-сервер с конфигом на функциональных опциях
- Прогнать `go vet` и тесты с покрытием перед коммитом

## Примеры запросов агенту
- Отрефактори этот пакет на идиоматичный Go: убери вложенность через ранние возвраты
- Почему эта горутина течёт? Найди причину и заверши её через `context`
- Собери HTTP-сервер с таймаутами чтения и записи, конфиг — через функциональные опции

## Похожие
- [golang-backend-development](https://affpapa.org/nevibecode/skills/golang-backend-development.md) — скилл · 1400 установок
- [golang-pro](https://affpapa.org/nevibecode/skills/httpsgithubcomjeffallan-golang-pro.md) — скилл · 19800 установок
- [golang](https://affpapa.org/nevibecode/skills/golang.md) — скилл · 535 установок
- [async-python-patterns](https://affpapa.org/nevibecode/skills/async-python-patterns.md) — скилл · 18055 установок
- [web-scripting](https://affpapa.org/nevibecode/plugins/web-scripting.md) — плагин · ★ 42780 у репозитория
- [python-development](https://affpapa.org/nevibecode/plugins/seth-hobson-python-development.md) — плагин · ★ 126 у репозитория

Из того же набора: [personamanagmentlayer/pcl](https://affpapa.org/nevibecode/by/personamanagmentlayer/pcl.md) — 104 карточки

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

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