Mejores Prácticas para Habilidades de Agente
Un resumen condensado de las 25 mejores prácticas más importantes extraídas de cada página de esta sección.
//
Busca en todas las páginas de la documentación
Un resumen condensado de las 25 mejores prácticas más importantes extraídas de cada página de esta sección.
Las habilidades son manuales de operación, no tutoriales: Los archivos SKILL.md indican a los agentes cómo ejecutar - Conceptos Básicos de Habilidades de Agente define la estructura; Conceptos Básicos de net/http enseña conceptos.
Fija la pila en cada habilidad: Go 1.26.x, configuración del equipo golangci-lint, frameworks (chi, gin, gRPC-Go, controller-runtime, TinyGo, wazero) - las habilidades sin fijar alucinan APIs obsoletas.
Una habilidad por dominio de decisión: Revisión de concurrencia, auditoría de módulos, diseño de API, perfilado, pruebas, operadores, WASM - nunca una mega-habilidad.
Declara las entradas antes de actuar: go.mod, paquetes afectados, enlaces de ADR, comandos de CI - los agentes adivinan sin ellas.
Las salidas deben ser verificables: Comandos y listas de verificación, no resúmenes en prosa - rechaza ejecuciones de habilidades que omitan go test ./....
Las barreras de seguridad son la sección de mayor valor: Plazos de contexto, mapeo de errores, política de go get, RBAC de operador - ver Habilidad de Revisión de Diseño de API de Go.
Invoca habilidades en puntos de decisión: Revisión previa a la fusión, barrido de CVE, perfilado de incidentes - no para leer documentación introductoria.
La documentación humana sigue siendo la fuente de verdad: Las habilidades enlazan a Pruebas Basadas en Tablas, documentación de govulncheck, patrones de Reconciliador - no dupliques.
Ejecuta go test -race cuando se toque la concurrencia: Puerta obligatoria en la salida de Habilidad de Revisión de Concurrencia de Go.
Ejecuta govulncheck ./... antes de las fusiones de dependencias: Habilidad de Auditoría de Módulos y Seguridad de Go orquesta la misma puerta que la CI de seguridad.
No usar go get -u ./... ciegamente: Pines quirúrgicos con revisión del registro de cambios y aprobación humana.
Propaga r.Context() en los manejadores: La falta de plazos es un hallazgo bloqueante en la habilidad de revisión de API.
Mapea errores en una sola capa: Manejadores o paquete apierr - no ambos con códigos de estado conflictivos.
Perfilar antes de optimizar: Habilidad de Perfilado de Rendimiento de Go bloquea sync.Pool especulativo sin pprof.
Subpruebas basadas en tablas desde AC: Habilidad de Pruebas y Benchmarking de Go mapea cada viñeta a t.Run.
Fuzz solo parsers puros: Sin red/DB en objetivos de fuzzing sin una configuración de integración dedicada.
El Reconciliador del Operador debe ser idempotente: Sin pánicos; los finalizadores necesitan una ruta de eliminación - Habilidad de Revisión de Operador de Kubernetes de Go.
Mínimo privilegio de RBAC: Marca verbos * y marcadores de cluster-admin antes de la fusión.
WASI vs WASM del navegador: Nunca syscall/js en compilaciones wasip1 - Habilidad de Revisión de Compilación WASM y TinyGo.
Presupuesto de tamaño en artefactos WASM: Mide con wasm-objdump / ls -la antes de aprobar nuevas dependencias.
Alinea las habilidades con las ADR: Enlaza Escribir ADRs para Decisiones de Arquitectura de Go en la sección de Referencias.
Refleja los comandos de CI en las habilidades: Si la habilidad dice golangci-lint run, la CI debe ejecutarlo - los ingenieros ignoran las puertas de enlace que no coinciden.
Trata la salida de la habilidad como un PR junior: Revisión humana antes de la fusión; el mismo estándar que los borradores de código asistidos.
Versiona las habilidades en el repositorio: Confirma .cursor/skills/ o el registro con nota semver en el registro de cambios cuando cambien las barreras de seguridad.
Actualiza las habilidades después de los postmortems: Cada barrera de seguridad omitida se convierte en una nueva viñeta - vuelve a ejecutar los comandos de verificación al actualizar.
Repo del módulo .cursor/skills/ para convenciones específicas del proyecto; registro de la organización para auditorías compartidas y manuales de incidentes. Siempre fija la versión de Go.
La habilidad puede redactar comandos go get - el humano aprueba antes de la fusión. Las barreras de seguridad bloquean la fusión automática en PRs de dependencias.
Las habilidades hacen referencia al mismo conjunto de linters que la CI aplica. No sugieras //nolint sin una ruta de excepción de ADR.
No. Las habilidades aceleran las listas de verificación; los revisores humanos son responsables de la autoridad de fusión y el juicio arquitectónico.
Después de un cambio menor de Go, un cambio en la configuración del linter, una actualización de ADR del framework o un elemento de acción de postmortem. Vuelve a ejecutar go test y govulncheck en la sección de verificación al actualizar.
Versiones de la pila: Esta página fue escrita para Go 1.26.x (predeterminado Green Tea GC, modernizadores de go fix - verifica el parche en la compilación), chi (última - verifica en la compilación), gin (última - verifica en la compilación), echo (última - verifica en la compilación), google.golang.org/grpc (última - verifica en la compilación), sigs.k8s.io/controller-runtime (última - verifica en la compilación), kubebuilder (última - verifica en la compilación), tinygo (última - verifica los objetivos de la placa en la compilación), wazero (última - verifica en la compilación) y golangci-lint (última - verifica el conjunto de linters en la compilación).
Revisado por Chris St. John·Última actualización: 16 jul 2026