Skills Разработка

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

Используйте, когда пользователи спрашивают, как писать, объяснять, настраивать, переносить, защищать или устранять неполадки в рабочих процессах GitHub Actions, синтаксисе рабочих процессов, триггерах, матрицах, раннерах, повторно используемых рабочих процессах, артефактах, кэшировании, секретах, OIDC, развертываниях, пользовательских действиях или контроллере раннеров Actions, особенно когда им нужна официальная документация GitHub, точные ссылки или основанные на документации рекомендации по YAML.

Преобразуйте сырые заметки, журналы ошибок, голосовой ввод или скриншоты в четкие отчеты о проблемах в формате GitHub-flavored markdown. Используйте, когда пользователь вставляет информацию об ошибке, сообщения об ошибках или неформальные описания и хочет структурированную проблему GitHub. Поддерживает изображения/GIF для визуальных доказательств.

Бенчмаркинг, профилирование и измерение производительности на Golang. Используется при написании, запуске или сравнении Go-бенчмарков, профилировании горячих путей с помощью pprof, интерпретации профилей CPU/памяти/трассировки, анализе результатов с benchstat, настройке обнаружения регрессий производительности в CI или исследовании продуктивности в production с помощью метрик времени выполнения Prometheus. Также применяется, когда разработчику требуется глубокий анализ конкретного показателя производительности — этот навык предоставляет методологию измерений, в то время как...

We need to translate the given text from English to Russian, preserving the name "golang-cli" and other technical terms. The instruction says: "Translate only the text inside <text>. Do not include the name unless it appears in the source text." The name "golang-cli" appears in the source text? Actually, the source text does not contain "golang-cli" explicitly; it's the directory item name. The instruction says "Do not include the name unless it appears in the source text." So we should not add it. The source text mentions "golang-cli" only in the context of the skill name? Wait, the source text says: "Name to preserve: golang-cli" but that's outside the <text>. Inside <text>, there is no "golang-cli". So we just translate the text inside <text>. Also preserve product names, protocol names, URLs, numbers, technical terms. So "cobra", "viper", "urfave/cli", "samber/cc-skills-golang@g

Golang code style conventions — line length and breaking, variable declarations, control flow clarity, when comments help vs hurt. Use when writing or reviewing Go code, asking about style or clarity, or establishing project coding standards. Not for naming conventions (→ See `samber/cc-skills-golang@golang-naming` skill), linter configuration (→ See `samber/cc-skills-golang@golang-lint` skill), or doc comments (→ See `samber/cc-skills-golang@golang-documentation` skill).

Паттерны конкурентности в Golang. Используется при написании или ревью конкурентного кода на Go, включающего горутины, каналы, select, блокировки, примитивы синхронизации, errgroup, singleflight, пулы воркеров или конвейеры fan-out/fan-in. Также срабатывает при обнаружении утечек горутин, состояний гонки, проблем с владением каналами или необходимости выбора между каналами и мьютексами.

Идиоматическое использование context.Context в Golang — передача через границы API, отмена, тайм-ауты и дедлайны, значения в рамках запроса, context.WithoutCancel для фоновой работы, переживающей запросы. Применяется при проектировании передачи контекста между слоями, отладке утекших или неистекших контекстов, выборе между context.Background/TODO/WithoutCancel или хранении значений в контексте. Не подходит для кода, который просто принимает ctx в качестве первого параметра.

Конфигурация пайплайна CI/CD с использованием GitHub Actions для проектов на Golang — тестирование, линтинг, SAST, сканирование безопасности, покрытие кода, Dependabot, Renovate, GoReleaser, автоматизация проверки кода и пайплайны релизов. Используется при настройке или улучшении CI для Go-проектов, конфигурации рабочих процессов GitHub Actions, добавлении линтеров или сканеров безопасности, автоматизации обновления зависимостей или добавлении шлюзов качества.

Структуры данных в Golang — срезы (внутреннее устройство, рост ёмкости, предварительное выделение, пакет slices), мапы (внутреннее устройство, хэш-корзины, пакет maps), массивы, container/list/heap/ring, strings.Builder vs bytes.Buffer, обобщённые коллекции, указатели (unsafe.Pointer, weak.Pointer) и семантика копирования. Используется при выборе или оптимизации структур данных Go, реализации обобщённых контейнеров, использовании пакетов container/, unsafe или weak-указателей, а также при вопросах о внутреннем устройстве срезов или мап.

Полное руководство по работе с базами данных в Go — параметризованные запросы, сканирование структур, NULL-допустимые столбцы, транзакции, уровни изоляции, SELECT FOR UPDATE, пул соединений, пакетная обработка, передача контекста и инструменты миграции. Используйте при написании, ревью или отладке Golang-кода, взаимодействующего с PostgreSQL, MariaDB, MySQL или SQLite; для тестирования баз данных; или по вопросам, связанным с database/sql, sqlx или pgx. НЕ генерирует схемы баз данных или SQL-миграции.

Всеобъемлющее руководство по внедрению зависимостей (DI) в Golang. Охватывает важность DI (тестируемость, слабая связанность, разделение ответственности, управление жизненным циклом), ручное внедрение через конструктор и сравнение DI-библиотек (google/wire, uber-go/dig, uber-go/fx, samber/do). Используйте этот навык при проектировании сервисной архитектуры, настройке внедрения зависимостей, рефакторинге тесно связанного кода, управлении синглтонами или фабриками сервисов, а также когда пользователь спрашивает об инверсии управления, сервисах...

Стратегии управления зависимостями для проектов на Golang — управление go.mod, установка/обновление пакетов, Minimal Version Selection, сканирование уязвимостей, отслеживание устаревших зависимостей, анализ размера бинарных файлов, настройка Dependabot/Renovate, разрешение конфликтов и рабочие пространства go.work. Используется при добавлении, удалении или обновлении зависимостей Go, аудите уязвимостей, разрешении конфликтов версий или настройке автоматических обновлений зависимостей.

Идиоматические шаблоны проектирования Golang — функциональные опции, конструкторы, обработка ошибок и каскадирование, управление ресурсами и жизненным циклом, корректное завершение работы, отказоустойчивость, архитектура, внедрение зависимостей, работа с данными, стриминг и другое. Применяйте при осознанном выборе между архитектурными шаблонами, реализации функциональных опций, проектировании API конструкторов, настройке корректного завершения работы, применении шаблонов отказоустойчивости или при выборе идиоматического шаблона Go для конкретной задачи.

Всеобъемлющее руководство по документации для проектов на Golang, охватывающее godoc-комментарии, README, CONTRIBUTING, CHANGELOG, Go Playground, примеры тестов, документацию API и llms.txt. Используется при написании или рецензировании комментариев к документации, добавлении примеров кода, настройке сайтов документации или обсуждении лучших практик документирования. Срабатывает как для библиотек, так и для приложений/CLI.

We need to translate the given text from English to Russian, preserving the name "golang-error-handling" but only if it appears in the source text. The source text does not contain the name "golang-error-handling" explicitly; it only appears in the instruction as the directory item name. The instruction says: "Do not include the name unless it appears in the source text." So we should not add it. Also preserve product names, protocol names, URLs, numbers, technical terms. The text includes: "Golang", "%w", "errors.Is/As", "errors.Join", "panic/recover", "slog", "HTTP", "samber/oops", "samber/cc-skills-golang@golang-samber-oops". Also "3rd-party" should be preserved as is or translated? "3rd-party" is a term, but we can translate as "сторонних" but keep the number? Better to keep "3rd-party" as is? The instruction says "preserve ... numbers, technical terms". "3rd

We need to translate the given text from English to Russian, preserving the specified name "golang-google-wire" but only if it appears in the source text. The source text does not contain that name; it contains "google/wire" and "github.com/google/wire". So we don't include "golang-google-wire". We translate the entire text inside <text> tags, preserving technical terms like wire.NewSet, wire.Build, etc., URLs, numbers, and code snippets. No extra commentary, labels, or formatting. The text is a description of compile-time dependency injection in Golang using google/wire. We need to translate it naturally into Russian, keeping all technical terms and code references intact. Let's translate: "Compile-time dependency injection in Golang using google/wire — wire.NewSet, wire.Build, wire.Bind (interface→concrete), wire.Struct, wire.Value, wire.InterfaceValue, wire.FieldsOf, cleanup functions, //go:build wireinject injector files, and generated wire_gen.go

Implements GraphQL APIs in Golang using gqlgen or graphql-go. Apply when building GraphQL servers, designing schemas, writing resolvers, handling subscriptions, or integrating GraphQL with existing Go HTTP services. Also apply when the codebase imports `github.com/99designs/gqlgen` or `github.com/graph-gophers/graphql-go`.

Предоставляет рекомендации по использованию gRPC, организации protobuf и шаблоны для production-ready микросервисов на Golang. Используйте при реализации, ревью или отладке gRPC-серверов/клиентов, написании proto-файлов, настройке перехватчиков, обработке ошибок gRPC с кодами статуса, конфигурации TLS/mTLS, тестировании с bufconn или работе с потоковыми RPC.

Оркестратор навыков Golang — всегда активен при любой задаче по написанию, ревью, отладке или настройке кода на Golang. Читает контекст задачи и загружает наиболее релевантные навыки из samber/cc-skills-golang, часто сразу несколько: написание gRPC-сервиса загружает golang-grpc + golang-testing + golang-error-handling; отладка паники загружает golang-troubleshooting + golang-safety; аудит безопасности загружает golang-security + golang-lint + golang-safety. Также: устраняет неоднозначность конкурирующих кластеров, когда два навыка кажутся пересекающимися...

Лучшие практики линтинга и настройка golangci-lint для проектов на Golang — запуск линтеров, настройка .golangci.yml, подавление предупреждений с помощью директив nolint, интерпретация вывода линтера и выбор линтеров. Используйте при настройке golangci-lint, вопросах о предупреждениях линтера или подавлении nolint, настройке инструментов качества кода или выборе линтеров. Также используйте, когда пользователь упоминает golangci-lint, go vet, staticcheck или revive.

golang-linter — устанавливаемый навык для ИИ-агентов.

Модернизация Golang-кода с использованием новых возможностей языка, улучшений стандартной библиотеки и идиоматических паттернов. Запускать проактивно при написании или ревью Go-кода, когда обнаружены устаревшие паттерны, или при появлении предупреждений об устаревании. Также использовать, когда пользователь явно запрашивает модернизацию, обновление версии Go или обновление CI/инструментов.

Соглашения об именовании в Go (Golang) — охватывают пакеты, конструкторы, структуры, интерфейсы, константы, перечисления, ошибки, булевы значения, получатели, геттеры/сеттеры, функциональные опции, аббревиатуры, тестовые функции и имена подтестов. Используйте этот навык при написании нового кода на Go, ревью или рефакторинге, выборе между альтернативами именования (New vs NewTypeName, isConnected vs connected, ErrNotFound vs NotFoundError, StatusReady vs StatusUnknown в iota 0), обсуждении имен пакетов Go (антипаттерны utils/helpers) или...

Ежедневная наблюдаемость Golang — постоянно включенные сигналы в продакшене. Охватывает структурированное логирование с slog, метрики Prometheus, распределенную трассировку OpenTelemetry, непрерывное профилирование с pprof/Pyroscope, отслеживание событий RUM на стороне сервера, оповещение и дашборды Grafana. Применяется при инструментировании Go-сервисов для мониторинга в продакшене, настройке метрик или оповещения, добавлении трассировки OpenTelemetry, корреляции логов с трейсами, миграции устаревших логгеров (zap/logrus/zerolog) на slog, добавлении...

Шаблоны и методология оптимизации производительности Golang — если узкое место X, примени Y. Охватывает снижение аллокаций, эффективность CPU, компоновку памяти, настройку GC, пулинг, кэширование и оптимизацию горячих путей. Используйте, когда профилирование или бенчмарки выявили узкое место и вам нужен правильный шаблон оптимизации для его устранения. Также используйте при проведении код-ревью производительности, чтобы предложить улучшения или бенчмарки, которые помогут выявить быстрые выигрыши в производительности. Не для методологии измерений (→...

Рекомендует готовые к использованию в продакшене библиотеки и фреймворки на Golang. Применяется, когда пользователь явно запрашивает предложения по библиотекам, хочет сравнить альтернативы, нуждается в выборе библиотеки для конкретной задачи или когда в проект добавляется новая зависимость.

Предоставляет руководство по настройке структур проектов и рабочих пространств Golang. Используйте при запуске нового Go-проекта, организации существующей кодовой базы, настройке монорепозитория с несколькими пакетами, создании CLI-инструментов с несколькими основными пакетами, выборе между соглашениями о каталогах cmd/internal/pkg, а также при обсуждении реструктуризации пакетов, разделения пакетов или разделения модулей.

Защитное программирование на Golang для предотвращения паник, скрытого повреждения данных и трудноуловимых ошибок времени выполнения. Используйте при обнаружении паник из-за nil, проблем с алиасингом при append, конкурентного доступа к map, подводных камней сравнения чисел с плавающей запятой или вопросов проектирования нулевых значений. Также используйте при проверке кода на nil-безопасность, переполнение при преобразовании числовых типов, проблемы жизненного цикла ресурсов (defer в циклах) или защитное копирование срезов и map.

Внедрение зависимостей в Golang с использованием samber/do — контейнеры сервисов, управление жизненным циклом, области видимости, проверки работоспособности, корректное завершение работы и организация модулей. Применяется при использовании или внедрении samber/do, когда кодовая база импортирует github.com/samber/do или github.com/samber/do/v2, или при рефакторинге ручного внедрения конструкторов в DI-контейнер.