Skills de Desenvolvimento

Estrutura práticas de fluxo de trabalho git. Use ao fazer qualquer alteração de código. Use ao commitar, criar branches, resolver conflitos ou quando precisar organizar o trabalho em múltiplos fluxos paralelos. Use ao cortar um release, escolher um incremento de versão semântica, criar tags ou escrever um changelog.

Use quando os usuários perguntarem como escrever, explicar, personalizar, migrar, proteger ou solucionar problemas de workflows do GitHub Actions, sintaxe de workflows, gatilhos, matrizes, runners, workflows reutilizáveis, artefatos, cache, segredos, OIDC, implantações, ações personalizadas ou Actions Runner Controller, especialmente quando precisarem de documentação oficial do GitHub, links exatos ou orientação sobre YAML baseada na documentação.

Converta notas brutas, logs de erro, ditados por voz ou capturas de tela em relatórios de issue nítidos em markdown no estilo GitHub. Use quando o usuário colar informações de bug, mensagens de erro ou descrições informais e quiser uma issue estruturada no GitHub. Suporta imagens/GIFs como evidência visual.

Benchmarking, profiling e medição de desempenho em Golang. Use ao escrever, executar ou comparar benchmarks em Go, fazer profiling de caminhos críticos com pprof, interpretar perfis de CPU/memória/trace, analisar resultados com benchstat, configurar detecção de regressão de benchmark em CI ou investigar desempenho em produção com métricas de runtime do Prometheus. Também use quando o desenvolvedor precisar de análise aprofundada sobre um indicador específico de desempenho — esta skill fornece a metodologia de medição, enquanto...

Golang CLI application development. Use when building, modifying, or reviewing a Go CLI tool — especially for command structure, flag handling, configuration layering, version embedding, exit codes, I/O patterns, signal handling, shell completion, argument validation, and CLI unit testing. Also triggers when code uses cobra, viper, or urfave/cli. For cobra-specific APIs → See `samber/cc-skills-golang@golang-spf13-cobra` skill; for viper configuration layering → See...

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).

Padrões de concorrência em Golang. Use ao escrever ou revisar código Go concorrente envolvendo goroutines, canais, select, locks, primitivas sync, errgroup, singleflight, pools de workers ou pipelines fan-out/fan-in. Também aciona quando você detecta vazamentos de goroutines, condições de corrida, problemas de propriedade de canais ou precisa escolher entre canais e mutexes.

Uso idiomático de context.Context em Golang — propagação através de limites de API, cancelamento, timeouts e deadlines, valores de escopo de requisição, context.WithoutCancel para trabalhos em segundo plano que sobrevivem às requisições. Aplicar ao projetar propagação de contexto entre camadas, depurar contextos vazados ou não expirados, escolher entre context.Background/TODO/WithoutCancel, ou armazenar valores no contexto. Não se aplica a código que apenas aceita ctx como primeiro parâmetro.

Configuração de pipeline CI/CD usando GitHub Actions para projetos Golang — testes, linting, SAST, varredura de segurança, cobertura de código, Dependabot, Renovate, GoReleaser, automação de revisão de código e pipelines de release. Use ao configurar ou melhorar a CI de projetos Go, configurar workflows do GitHub Actions, adicionar linters ou scanners de segurança, automatizar atualizações de dependências ou adicionar portões de qualidade.

Estruturas de dados em Golang — slices (internas, crescimento de capacidade, pré-alocação, pacote slices), maps (internas, buckets de hash, pacote maps), arrays, container/list/heap/ring, strings.Builder vs bytes.Buffer, coleções genéricas, ponteiros (unsafe.Pointer, weak.Pointer) e semântica de cópia. Use ao escolher ou otimizar estruturas de dados em Go, implementar contêineres genéricos, usar pacotes container/, ponteiros unsafe ou weak, ou questionar internas de slice/map.

Guia abrangente para acesso a banco de dados em Go — consultas parametrizadas, escaneamento de structs, colunas anuláveis, transações, níveis de isolamento, SELECT FOR UPDATE, pool de conexões, processamento em lote, propagação de contexto e ferramentas de migração. Use ao escrever, revisar ou depurar código Golang que interage com PostgreSQL, MariaDB, MySQL ou SQLite; para testes de banco de dados; ou para dúvidas sobre database/sql, sqlx ou pgx. NÃO gera esquemas de banco de dados ou SQL de migração.

Guia completo para injeção de dependência (DI) em Golang. Aborda por que DI é importante (testabilidade, baixo acoplamento, separação de responsabilidades, gerenciamento de ciclo de vida), injeção manual por construtor e comparação de bibliotecas DI (google/wire, uber-go/dig, uber-go/fx, samber/do). Use esta habilidade ao projetar arquitetura de serviços, configurar injeção de dependência, refatorar código fortemente acoplado, gerenciar singletons ou fábricas de serviços, ou quando o usuário perguntar sobre inversão de controle, serviço...

Estratégias de gerenciamento de dependências para projetos Golang — gerenciamento de go.mod, instalação/atualização de pacotes, Seleção de Versão Mínima, varredura de vulnerabilidades, rastreamento de dependências desatualizadas, análise de tamanho binário, configuração de Dependabot/Renovate, resolução de conflitos e workspaces go.work. Use ao adicionar, remover ou atualizar dependências Go, auditar vulnerabilidades, resolver conflitos de versão ou configurar atualizações automáticas de dependências.

Padrões de design idiomáticos em Golang — opções funcionais, construtores, fluxo e cascata de erros, gerenciamento e ciclo de vida de recursos, desligamento gracioso, resiliência, arquitetura, injeção de dependência, manipulação de dados, streaming e mais. Aplicar ao escolher explicitamente entre padrões arquiteturais, implementar opções funcionais, projetar APIs de construtores, configurar desligamento gracioso, aplicar padrões de resiliência ou perguntar qual padrão idiomático Go se adequa a um problema específico.

Guia abrangente de documentação para projetos Golang, cobrindo comentários godoc, README, CONTRIBUTING, CHANGELOG, Go Playground, testes de exemplo, documentação de API e llms.txt. Use ao escrever ou revisar comentários de documentação, documentação, adicionar exemplos de código, configurar sites de documentação ou discutir melhores práticas de documentação. Aciona tanto para bibliotecas quanto para aplicações/CLIs.

Idiomatic Golang error handling — creation, wrapping with %w, errors.Is/As, errors.Join, custom error types, sentinel errors, panic/recover, the single handling rule, structured logging with slog, HTTP request logging middleware, and samber/oops for production errors. Built to make logs usable at scale with log aggregation 3rd-party tools. Apply when creating, wrapping, inspecting, or logging errors in Go code. For samber/oops specifics → See `samber/cc-skills-golang@golang-samber-oops`...

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. Apply when using or adopting google/wire, when the codebase imports `github.com/google/wire`, or when wiring an application graph at compile time via `wire.Build`. For runtime DI with reflection, see...

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`.

Fornece diretrizes de uso do gRPC, organização de protobuf e padrões prontos para produção em microsserviços Golang. Use ao implementar, revisar ou depurar servidores/clientes gRPC, escrever arquivos proto, configurar interceptadores, tratar erros gRPC com códigos de status, configurar TLS/mTLS, testar com bufconn ou trabalhar com RPCs de streaming.

Orquestrador de habilidades Golang — sempre ativo em qualquer tarefa de codificação, revisão, depuração ou configuração em Golang. Lê o contexto da tarefa e carrega as habilidades mais relevantes do samber/cc-skills-golang, frequentemente várias de uma vez: escrever um serviço gRPC carrega golang-grpc + golang-testing + golang-error-handling; depurar um panic carrega golang-troubleshooting + golang-safety; auditar segurança carrega golang-security + golang-lint + golang-safety. Também: desambigua clusters concorrentes quando duas habilidades parecem se sobrepor...

Melhores práticas de linting e configuração do golangci-lint para projetos Golang — execução de linters, configuração do .golangci.yml, supressão de avisos com diretivas nolint, interpretação da saída de lint e seleção de linters. Use ao configurar o golangci-lint, ao perguntar sobre avisos de lint ou supressões nolint, ao configurar ferramentas de qualidade de código ou ao escolher linters. Use também quando o usuário mencionar golangci-lint, go vet, staticcheck ou revive.

golang-linter — uma skill instalável para agentes de IA.

Modernize código Golang para usar recursos recentes da linguagem, melhorias na biblioteca padrão e padrões idiomáticos. Acione proativamente ao escrever ou revisar código Go e detectar padrões antigos, ou ao encontrar um aviso de depreciação. Use também quando o usuário solicitar explicitamente modernização, atualização de versão do Go ou renovação de CI/ferramentas.

Convenções de nomenclatura em Go (Golang) — abrange pacotes, construtores, structs, interfaces, constantes, enums, erros, booleanos, receivers, getters/setters, opções funcionais, acrônimos, funções de teste e nomes de subtestes. Use esta habilidade ao escrever novo código Go, revisar ou refatorar, escolher entre alternativas de nomenclatura (New vs NewTypeName, isConnected vs connected, ErrNotFound vs NotFoundError, StatusReady vs StatusUnknown no iota 0), debater nomes de pacotes Go (anti-padrões utils/helpers), ou...

Observabilidade diária em Golang — os sinais sempre ativos em produção. Abrange logging estruturado com slog, métricas do Prometheus, rastreamento distribuído com OpenTelemetry, profiling contínuo com pprof/Pyroscope, rastreamento de eventos RUM no lado do servidor, alertas e dashboards do Grafana. Aplicável ao instrumentar serviços Go para monitoramento em produção, configurar métricas ou alertas, adicionar rastreamento OpenTelemetry, correlacionar logs com traces, migrar loggers legados (zap/logrus/zerolog) para slog, adicionar...

Padrões e metodologia de otimização de desempenho em Golang - se gargalo X, então aplique Y. Abrange redução de alocação, eficiência de CPU, layout de memória, ajuste de GC, pooling, caching e otimização de hot-path. Use quando profiling ou benchmarks identificaram um gargalo e você precisa do padrão de otimização correto para corrigi-lo. Use também ao realizar revisão de código de desempenho para sugerir melhorias ou benchmarks que possam ajudar a identificar ganhos rápidos de desempenho. Não é para metodologia de medição (→...

Recomenda bibliotecas e frameworks Golang prontos para produção. Aplique quando o usuário pedir explicitamente sugestões de bibliotecas, quiser comparar alternativas, precisar escolher uma biblioteca para uma tarefa específica ou quando uma nova dependência estiver sendo adicionada ao projeto.

Fornece um guia para configurar layouts e workspaces de projetos Golang. Use ao iniciar um novo projeto Go, organizar uma base de código existente, configurar um monorepo com múltiplos pacotes, criar ferramentas CLI com múltiplos pacotes principais, decidir entre convenções de diretório cmd/internal/pkg, ou discutir reestruturação de pacotes, divisões de pacotes ou divisões de módulos.

Codificação defensiva em Golang para prevenir panics, corrupção silenciosa de dados e bugs sutis em tempo de execução. Use ao encontrar panics por nil, aliasing em append, acesso concorrente a mapas, armadilhas de comparação de floats ou questões de design de valor zero. Use também ao revisar código para segurança contra nil, estouro em conversão numérica, problemas de ciclo de vida de recursos (defer em loops) ou cópia defensiva de slices e maps.

Injeção de dependência em Golang usando samber/do — contêineres de serviço, gerenciamento de ciclo de vida, escopos, verificações de saúde, desligamento gracioso e organização de módulos. Aplique ao usar ou adotar samber/do, quando o código importar github.com/samber/do ou github.com/samber/do/v2, ou ao refatorar injeção manual de construtores para um contêiner de DI.