golang-pro - Конкурентный Go с проверкой ошибок

Когда звать

• Когда Go-сервис зависает при отмене запроса или оставляет незавершённые goroutines.
• Когда нужны небольшие интерфейсы, табличные тесты и замер выделений памяти в Go.

Для чего нужен Golang Pro

Golang Pro направляет агента на конкурентный код, небольшие интерфейсы и явную обработку ошибок в Go. Автор указывает Go 1.21 и новее, gRPC, REST, инструменты командной строки и микросервисы. В прочитанном SKILL.md стоит версия 1.1.0.

Скилл уместен, когда сервис запускает несколько обработчиков, но неясно, кто завершает их работу и куда попадает ошибка. Ещё один сценарий - модуль с широким интерфейсом, который сложно заменить в тесте. Инструкция предлагает проектировать узкие контракты и собирать поведение через композицию.

Как устроен порядок работы

Первым шагом агент изучает модули, интерфейсы и используемые схемы конкурентности. Затем определяет контракты, пишет реализацию с передачей context.Context и проверяет её через go vet. Следом идут golangci-lint, профилирование pprof и тесты.

Для тестирования автор отдельно требует табличные наборы случаев с подтестами, запуск детектора гонок и fuzzing. Цель покрытия от 80% записана в инструкции как условие работы агента. Она ничего не сообщает о покрытии вашего репозитория до запуска настоящих проверок.

При оптимизации предлагается измерять распределение времени и выделения памяти. Поэтому запрос «ускорьте функцию» лучше дополнить требованием показать benchmark до и после изменения. Простая замена цикла на несколько goroutines ещё не подтверждает выигрыш.

Что читать в исходнике внимательно

Пример обработчика использует select для ожидания задания или отмены контекста. Ошибки оборачиваются через %w, а закрытие входного канала рассматривается отдельно от сбоя обработки. Эти детали помогают разбирать жизненный цикл задачи, но готовый фрагмент всё равно нужно проверить на нормальное завершение и поведение вызывающей стороны.

В требованиях запрещены goroutines без понятного срока жизни, пропуск отмены контекста и panic для обычных ошибок. Автор также не допускает молчаливое отбрасывание ошибки через _ без причины. Экспортируемые функции, типы и пакеты должны иметь документацию.

Справочники разделены на конкурентность, интерфейсы, generics, тестирование и структуру проекта. Они связаны из основного файла относительными путями. Перенос одного SKILL.md без папки references оставит эти ссылки без содержимого.

Пример задания агенту

Начните с ограниченного обработчика очереди: «Опишите владельца каждого канала, условие завершения worker и способ передачи ошибки вызывающему коду. Добавьте тесты закрытого канала и отменённого контекста. Покажите вывод детектора гонок». Для проверки используйте искусственные задания вместо рабочего сервиса.

На сдаче по инструкции должны быть интерфейсы, файлы реализации в пакетах, табличные тесты и пояснение конкурентной схемы. Если окружение не позволяет запустить race detector, это нужно отметить как непройденную проверку, а не скрывать за успешным обычным тестом.

QUICKSTART описывает установку всей коллекции в Claude Code. Мы прочитали источники и MIT-лицензию, но не выполняли установку или код скилла. Путь в Codex не проверен. Поиск уже возникшего сбоя можно дополнить Debugging Wizard.