Mejores Prácticas para Habilidades de Agente

Q: ¿Habilidades en Cursor vs Claude Code vs Copilot?

Mantener SKILL.md como markdown portable en el repositorio. Las rutas específicas de la herramienta enlazan al mismo contenido. La fijación de pila es universal.

Reglas que mantienen las Habilidades de Agente de Postgres precisas, seguras y alineadas con la política de producción de PostgreSQL 18.4.

Cómo Usar Esta Lista

Aplica al crear o actualizar cualquier SKILL.md bajo .cursor/skills/.
Revisa después de una actualización menor de Postgres o un cambio importante en el ejecutor de migraciones.
Haz cumplir mediante la revisión de PRs en los archivos de habilidades, igual que el código de aplicación.
Verifica los elementos al incorporar ingenieros a flujos de trabajo de DBA asistidos por IA.

A - Estructura y Fijación

Bloque de fijación de pila en cada habilidad. Versiones de PostgreSQL 18.4, cliente psql, Patroni/pgBackRest según ADR (Conceptos Básicos de Habilidades de Agente).
Secciones obligatorias: Qué, Cuándo, Entradas, Salidas, Guardarraíles, Fijación de pila, Ejemplos de prompts.
Una habilidad por dominio de decisión. No mezclar mega-habilidades de incidentes + migraciones + backups.
Versionar habilidades cuando cambian los guardarraíles. Semver en README o etiqueta git en la carpeta de la habilidad.
Enlazar documentación autoritativa humana. EXPLAIN y los manuales de migración siguen siendo la fuente de verdad.

B - Seguridad y Gobernanza

No DDL de producción desde el agente sin ticket. El humano fusiona el PR de migración después de la prueba en staging.
No pg_terminate_backend sin evidencia de bloqueo. La habilidad de incidentes genera el PID; el humano ejecuta.
No DROP SLOT / DROP DATABASE sin aprobador nombrado. Documentar en los guardarraíles.
Staging por defecto para EXPLAIN (ANALYZE). EXPLAIN en producción solo con política de incidentes de solo lectura.
SQL de reversión requerido en las salidas de la habilidad de migración. Los equipos de solo avance aún documentan el descenso manual.
Las viñetas de postmortem se convierten en guardarraíles en 5 días. Se cierra el ciclo de aprendizaje SEV1.

C - Salidas y Verificación

Terminar cada salida de habilidad con un bloque de comandos. psql, flyway migrate, patronictl list, códigos de salida.
Rechazar "hecho" solo con texto. El agente debe mostrar la plantilla de resultados de la consulta de verificación.
Adjuntar consultas de escala de tabla para habilidades de migración/explicación. Recuentos de filas de pg_class.reltuples.
La habilidad INCIDENT preserva los comandos del paquete de logs. df, pg_locks, vistas de replicación en un solo script.
La habilidad FAILOVER registra las marcas de tiempo de RTO. Minutos desde el disparador hasta la escritura exitosa.

D - Proceso del Equipo

Nombrar explícitamente la habilidad en el prompt. "Usar Habilidad de Seguridad de Migración en V12__..."
Registro de habilidades con propietarios. El DBA de plataforma mantiene docs/skills/README.md.
Calendario trimestral de revisión de habilidades. Después del escaneo de las notas de lanzamiento menores de Postgres 18.x.
Nunca fusionar automáticamente PRs del agente. Misma barra de revisión que el SQL escrito por humanos.
Registrar fallos de habilidades en #database. Mejorar la lista de entradas cuando los agentes adivinan mal.
Pareja para usuarios de habilidades por primera vez. Parejas en PRs de Consultas para la habilidad EXPLAIN.

E - Límites de Alcance

Las habilidades orquestan; la documentación enseña. Las páginas de fundamentos no son reemplazadas por habilidades.
No duplicar pganalyze. El escepticismo del asesor permanece en la documentación de herramientas esenciales.
Ramas gestionadas vs autoalojadas. Los pasos de failover de RDS difieren de Patroni; documentar ambos o dividir habilidades.
Los sitios air-gapped omiten los pasos SaaS. Las habilidades funcionan sin conexión solo con herramientas de código abierto.

Preguntas Frecuentes

¿Cuántas habilidades necesita un equipo?

Mínimo cuatro: revisión de EXPLAIN, seguridad de migración, simulacro de failover, triaje de incidentes. Añadir habilidad de actualización cuando los saltos de múltiples versiones mayores son frecuentes.

¿Habilidades en Cursor vs Claude Code vs Copilot?

Mantener SKILL.md como markdown portable en el repositorio. Las rutas específicas de la herramienta enlazan al mismo contenido. La fijación de pila es universal.

¿Deberían los juniors invocar la habilidad de incidentes?

Sí, con un compañero de guardia. La habilidad estructura el pensamiento; el humano ejecuta acciones destructivas.

Relacionados

Conceptos Básicos de Habilidades de Agente - estructura e invocación
Habilidad de Revisión de EXPLAIN - PRs de consultas
Habilidad de Seguridad de Migración - puntuación de DDL
Habilidad de Simulacro de Failover - simulacros de HA
Habilidad de Triaje de Incidentes - árbol SEV1

Versiones de pila: Esta página fue escrita para PostgreSQL 18.4, Flyway 10+, Patroni 4.x, y pgBackRest 2.55+.

Mejores Prácticas para Habilidades de Agente

Reglas que mantienen las Habilidades de Agente de Postgres precisas, seguras y alineadas con la política de producción de PostgreSQL 18.4.

Cómo Usar Esta Lista

Aplica al crear o actualizar cualquier SKILL.md bajo .cursor/skills/.
Revisa después de una actualización menor de Postgres o un cambio importante en el ejecutor de migraciones.
Haz cumplir mediante la revisión de PRs en los archivos de habilidades, igual que el código de aplicación.
Verifica los elementos al incorporar ingenieros a flujos de trabajo de DBA asistidos por IA.

A - Estructura y Fijación

Bloque de fijación de pila en cada habilidad. Versiones de PostgreSQL 18.4, cliente psql, Patroni/pgBackRest según ADR (Conceptos Básicos de Habilidades de Agente).
Secciones obligatorias: Qué, Cuándo, Entradas, Salidas, Guardarraíles, Fijación de pila, Ejemplos de prompts.
Una habilidad por dominio de decisión. No mezclar mega-habilidades de incidentes + migraciones + backups.
Versionar habilidades cuando cambian los guardarraíles. Semver en README o etiqueta git en la carpeta de la habilidad.
Enlazar documentación autoritativa humana. EXPLAIN y los manuales de migración siguen siendo la fuente de verdad.

B - Seguridad y Gobernanza

No DDL de producción desde el agente sin ticket. El humano fusiona el PR de migración después de la prueba en staging.
No pg_terminate_backend sin evidencia de bloqueo. La habilidad de incidentes genera el PID; el humano ejecuta.
No DROP SLOT / DROP DATABASE sin aprobador nombrado. Documentar en los guardarraíles.
Staging por defecto para EXPLAIN (ANALYZE). EXPLAIN en producción solo con política de incidentes de solo lectura.
SQL de reversión requerido en las salidas de la habilidad de migración. Los equipos de solo avance aún documentan el descenso manual.
Las viñetas de postmortem se convierten en guardarraíles en 5 días. Se cierra el ciclo de aprendizaje SEV1.

C - Salidas y Verificación

Terminar cada salida de habilidad con un bloque de comandos. psql, flyway migrate, patronictl list, códigos de salida.
Rechazar "hecho" solo con texto. El agente debe mostrar la plantilla de resultados de la consulta de verificación.
Adjuntar consultas de escala de tabla para habilidades de migración/explicación. Recuentos de filas de pg_class.reltuples.
La habilidad INCIDENT preserva los comandos del paquete de logs. df, pg_locks, vistas de replicación en un solo script.
La habilidad FAILOVER registra las marcas de tiempo de RTO. Minutos desde el disparador hasta la escritura exitosa.

D - Proceso del Equipo

Nombrar explícitamente la habilidad en el prompt. "Usar Habilidad de Seguridad de Migración en V12__..."
Registro de habilidades con propietarios. El DBA de plataforma mantiene docs/skills/README.md.
Calendario trimestral de revisión de habilidades. Después del escaneo de las notas de lanzamiento menores de Postgres 18.x.
Nunca fusionar automáticamente PRs del agente. Misma barra de revisión que el SQL escrito por humanos.
Registrar fallos de habilidades en #database. Mejorar la lista de entradas cuando los agentes adivinan mal.
Pareja para usuarios de habilidades por primera vez. Parejas en PRs de Consultas para la habilidad EXPLAIN.

E - Límites de Alcance

Las habilidades orquestan; la documentación enseña. Las páginas de fundamentos no son reemplazadas por habilidades.
No duplicar pganalyze. El escepticismo del asesor permanece en la documentación de herramientas esenciales.
Ramas gestionadas vs autoalojadas. Los pasos de failover de RDS difieren de Patroni; documentar ambos o dividir habilidades.
Los sitios air-gapped omiten los pasos SaaS. Las habilidades funcionan sin conexión solo con herramientas de código abierto.

Preguntas Frecuentes

¿Cuántas habilidades necesita un equipo?

¿Habilidades en Cursor vs Claude Code vs Copilot?

Mantener SKILL.md como markdown portable en el repositorio. Las rutas específicas de la herramienta enlazan al mismo contenido. La fijación de pila es universal.

¿Deberían los juniors invocar la habilidad de incidentes?

Sí, con un compañero de guardia. La habilidad estructura el pensamiento; el humano ejecuta acciones destructivas.

Relacionados

Conceptos Básicos de Habilidades de Agente - estructura e invocación
Habilidad de Revisión de EXPLAIN - PRs de consultas
Habilidad de Seguridad de Migración - puntuación de DDL
Habilidad de Simulacro de Failover - simulacros de HA
Habilidad de Triaje de Incidentes - árbol SEV1

Versiones de pila: Esta página fue escrita para PostgreSQL 18.4, Flyway 10+, Patroni 4.x, y pgBackRest 2.55+.

Mejores Prácticas para Habilidades de Agente

Buscar en la documentación

Mejores Prácticas para Habilidades de Agente