Cómo evitar que las redes neuronales escriban código Go deficiente

Cualquiera que haya intentado generar código Go a través de Cursor, Claude Code o Copilot probablemente ha encontrado sus particularidades específicas. Las redes neuronales persisten en intentar arrastrar patrones de Java a Go, olvidan envolver errores con %w, ignoran condiciones de carrera en goroutines y generan estructuras monstruosas donde una simple función sería suficiente.

Corregir manualmente el modelo cada vez es un placer dudoso. Quieres darle al asistente un conjunto adecuado de reglas una sola vez y olvidarte de las correcciones constantes en la revisión de código. Exactamente por eso el desarrollador francés Samuel Berthe (autor de la popular biblioteca samber/lo) creó el proyecto cc-skills-golang.

¿Qué son los Agent Skills y por qué los necesitas

El concepto de Agent Skills surgió de un problema simple: el prompt del sistema de una red neuronal no es infinito. Si cargas una guía de estilo detallada, reglas de seguridad, especificidades de operaciones de base de datos y características del framework en el contexto, simplemente no quedará espacio para tu código real. Las respuestas se volverán más lentas y la calidad de generación disminuirá.

Los Skills resuelven esto mediante carga diferida. El proyecto es una colección de pequeños archivos Markdown. Al inicio de una sesión, solo se carga un resumen breve de cada módulo (aproximadamente 100 tokens por skill) en la memoria del LLM. Tan pronto como le pides al asistente que "escriba un benchmark para esta función" o "agregue manejo de errores al handler de gRPC", el modelo ve el disparador coincidente y carga el documento detallado con instrucciones específicas para esa tarea.

Sin basura de IA

El detalle principal en el README del repositorio es la advertencia honesta del autor: "Sin basura de IA aquí".

Hoy en día, GitHub está inundado de bases de conocimiento generadas automáticamente que hacen más daño que bien. Samuel hizo las cosas de manera diferente. Sí usó Claude para la destilación inicial de reglas de sus commits en proyectos Go reales, pero luego reescribió, editó y probó manualmente cada instrucción.

El autor incluso realizó mediciones de precisión en un conjunto de pruebas:

• Sin skills conectables, el modelo de lenguaje completó correctamente las tareas de prueba el 56% de las veces.
• Con el conjunto de reglas habilitado, la puntuación aumentó al 98%.

Se vieron mejoras especialmente fuertes en precisión en temas específicos: modernizar código antiguo para nuevas características de Go (range-over-int, iteradores), escribir benchmarks y manejo de errores.

Qué hay dentro del repositorio

Todas las instrucciones se dividen en dos categorías principales: reglas generales del lenguaje y trabajo con bibliotecas específicas.

Reglas generales del lenguaje y arquitectura

Los módulos cubren casi todo el ciclo de desarrollo en Go:

• Calidad y estilo del código: convenciones de nomenclatura, operaciones seguras con nil y slices, prevención de fugas de memoria, documentación adecuada y configuración de golangci-lint.
• Arquitectura y patrones: manejo de contexto, concurrencia sin fugas de goroutines, diseño de estructuras e interfaces, patrones de refactorización a través de gopls.
• Pruebas y depuración: pruebas basadas en tablas, detección de condiciones de carrera, perfilado a través de pprof, configuración de OpenTelemetry y recolección de métricas.
• Configuración del proyecto: estructura de directorios idiomática (cmd/internal/pkg), pipelines de CI/CD y gestión de módulos.

Soporte de bibliotecas populares

Más allá de los estándares del lenguaje en sí, el repositorio incluye reglas para trabajar con herramientas comunes:

• CLI y configuraciones: spf13/cobra y spf13/viper.
• Inyección de dependencias: google/wire, uber/dig, uber/fx y su propio contenedor samber/do.
• Protocolos de red: gRPC, GraphQL (gqlgen) y OpenAPI/Swagger.
• Ecosistema samber: helpers funcionales samber/lo, mónadas samber/mo, logging samber/slog y encadenamiento de errores samber/oops.

Un punto interesante: los skills están diseñados para no duplicarse entre sí. Si una regla de manejo de errores afecta al logging, se describe en el módulo golang-error-handling, y el módulo golang-observability simplemente lo referencia. Esto ahorra tokens.

Cómo instalar

El proyecto es compatible con casi todas las herramientas populares que trabajan con el estándar Agent Skills.

La forma más universal es la utilidad skills:

npx skills add https://github.com/samber/cc-skills-golang --all

Si trabajas en Cursor, simplemente clona el repositorio en la carpeta de skills:

git clone https://github.com/samber/cc-skills-golang.git ~/.cursor/skills/cc-skills-golang

Para Claude Code, la instalación se realiza con el comando estándar del plugin:

/plugin marketplace add samber/cc
/plugin install cc-skills-golang@samber

Copilot, Gemini CLI, OpenCode y Codex de OpenAI son compatibles de la misma manera.

Uso en CI para auto-revisión

Un caso de uso interesante descrito por el autor es ejecutar agentes de IA como revisores en GitHub Actions.

Los linters regulares son geniales para detectar problemas de formato o variables no utilizadas. Sin embargo, son inútiles si una red neuronal rompe silenciosamente la cohesión arquitectónica durante una refactorización u olvida cancelar el contexto al salir de una función. Un agente conectado al PR con este conjunto de skills revisa específicamente el código para cumplimiento idiomático en Go y señala problemas arquitectónicos antes de que el PR llegue a tus colegas.

¿Vale la pena probar?

Si usas activamente redes neuronales en desarrollo Go y estás cansado de corregir errores triviales por ellas, definitivamente vale la pena instalar este conjunto. No convertirá a la IA en un arquitecto senior, pero reducirá significativamente el número de errores tipográficos tontos y código no idiomático.

Es especialmente agradable que el proyecto no intente sobrecargar el contexto y deje la posibilidad de sobrescribir cualquier skill con las reglas de tu empresa. Simplemente crea tu propio módulo interno y especifica que tiene prioridad sobre el estándar.