Ingeniería de prompts para desarrolladores
Ingeniería de prompts práctica para desarrolladores: delimita el trabajo de implementación, solicita evidencia, conserva las restricciones y valida los resultados.
La ingeniería de prompts para desarrolladores es la práctica de proporcionar a un asistente de IA para programación el contexto y las restricciones necesarios para tomar una decisión de ingeniería segura. El prompt útil no es el más elaborado. Es el que hace inequívocos el alcance, los criterios de aceptación y la validación.
Trata una solicitud a una IA como tratarías un buen ticket de implementación: debe explicar el problema, proteger el comportamiento importante e indicar cómo sabrá el equipo que el cambio funcionó.
El contrato de un prompt para desarrolladores
La mayoría de las tareas de programación pueden usar este contrato conciso:
Problema: ¿Qué está fallando o es difícil para un usuario o responsable de mantenimiento?
Alcance: ¿Qué funcionalidad, archivos o límite debe inspeccionar el asistente?
Resultado: ¿Qué comportamiento observable debe cambiar?
Restricciones: ¿Qué debe seguir siendo cierto?
Criterios de aceptación: ¿Qué demuestra que la implementación está completa?
Validación: ¿Qué pruebas, comprobaciones o pasos manuales deben ejecutarse?
Añade el código, los registros, la decisión de diseño o el fallo de prueba relevantes después del contrato. Eso le da al asistente hechos con los que trabajar, en vez de pedirle que infiera todo el sistema.
Prompts de implementación: especifica el punto de integración
Un prompt de implementación debe nombrar al propietario actual del comportamiento:
Añade un estado vacío al componente existente de resultados de búsqueda.
La ruta de la página controla la consulta y el componente de resultados recibe
una lista tipada. Mantén esa responsabilidad sin cambios. El estado vacío debe
explicar que no hubo resultados coincidentes, ofrecer la acción existente para
borrar la búsqueda y conservar el foco del teclado.
Añade una prueba del componente para el resultado vacío y confirma que los
resultados con contenido se renderizan sin cambios.
Nombrar el punto de integración evita que un asistente añada un estado de consulta paralelo o traslade la lógica de rutas a un componente de presentación.
Prompts de depuración: pide evidencia primero
Para un error similar a los de producción, organiza el prompt como evidencia, hipótesis, verificación, corrección y validación:
Evidencia: Las solicitudes después de actualizar un token devuelven 401 una vez
y después tienen éxito al reintentar. La interfaz aún muestra el banner de
sesión cerrada.
Esperado: El banner desaparece después de un reintento correcto.
Observado: Los datos se cargan, pero el banner permanece.
Inspecciona las transiciones del estado de autenticación. Enumera hipótesis
alternativas y la observación más pequeña necesaria para confirmar cada una. No
cambies código hasta reproducir la ruta de fallo. Después, propone una
corrección con una prueba de regresión.
Esto hace que el asistente muestre el límite de su razonamiento. Puedes revisar una hipótesis basada en evidencia antes de que aparezca en el diff una reescritura amplia de la gestión de estado.
Prompts de arquitectura: protege decisiones, no solo archivos
El trabajo de arquitectura necesita objetivos fuera de alcance claros:
Evalúa si las preferencias de notificaciones deben permanecer en el documento
de perfil del usuario o pasar a un modelo de configuración dedicado.
Restricciones: La aplicación se exporta estáticamente, las escrituras se
inician desde el cliente, los lectores de preferencias existentes deben seguir
siendo compatibles y ninguna migración debe descartar silenciosamente la
elección de un usuario.
Compara las opciones según los patrones de lectura, la autorización, el riesgo
de despliegue y la capacidad de prueba. Recomienda un enfoque con sus
contrapartidas antes de proponer código.
Pide análisis antes de implementar siempre que la tarea pueda cambiar la propiedad de los datos, los contratos públicos o el comportamiento de despliegue.
Prompts de revisión de código: solicita riesgos, no cumplidos
La revisión de IA es más útil cuando tiene un objetivo:
Revisa este cambio buscando regresiones de comportamiento, carencias de
accesibilidad, manejo de errores y pruebas que ya no demuestren el contrato de
cara al usuario.
Concéntrate en los archivos modificados y en los sitios de llamada a los que
afectan. Informa los hallazgos en orden de prioridad con la evidencia de cada
uno. No sugieras cambios solo de estilo a menos que oculten un defecto o hagan
que el contrato no esté claro.
Esto evita una revisión genérica que produce una larga lista de sugerencias de formato de poco valor.
Prompts de documentación: conserva la verdad operativa
La documentación debe cotejarse con el código:
Actualiza la guía de configuración para el nuevo comando del entorno local.
Explica los requisitos previos, la salida esperada, la recuperación ante fallos
y cómo verificar que el servicio está listo. Comprueba cada comando frente a
los scripts del paquete y no documentes variables de entorno que no se
consuman realmente.
La última oración es importante: un asistente puede escribir documentación pulida para un comando que nunca se ejecuta.
Prompts de pruebas: convierte los criterios de aceptación en escenarios
Cuando pidas pruebas, proporciona a cada escenario un resultado para el usuario o el sistema:
Añade cobertura de regresión para la corrección del filtro de búsqueda.
Verifica que cambiar un filtro actualiza la lista de resultados, borrar el
filtro restaura la lista completa y una solicitud anterior lenta no puede
sobrescribir un resultado más reciente. Usa las convenciones de prueba
existentes y evita aserciones exclusivas de la implementación.
Las pruebas son más claras cuando describen el comportamiento que una implementación debe conservar.
El hábito que hace más seguros los prompts
Antes de enviar un prompt de programación, pregúntate:
- ¿Otro desarrollador entendería por qué importa este cambio?
- ¿Podría identificar qué no debe romperse?
- ¿Sabe dónde mirar primero?
- ¿Podría demostrar el resultado con los criterios de aceptación?
Si la respuesta es no, el prompt necesita contexto, no más adjetivos.
Empieza con cómo escribir mejores prompts para IA para conocer el marco subyacente, usa las solicitudes concretas de cómo formular prompts a ChatGPT para programar y compara la redacción específica de cada tarea en ejemplos de ingeniería de prompts para ingenieros de software. Para evitar los patrones de fallo que hacen arriesgada la implementación, lee errores de los asistentes de programación con IA y cómo evitarlos. Cuando tu trabajo incluya scripts de shell, registros o salida de comandos, practica el flujo de trabajo de línea de comandos antes de automatizarlo o cambiarlo.
Referencias
Estos enlaces de documentación aportan detalles confiables sobre los comandos usados en este artículo.