Curso de prompt engineering para programadores: plantillas listas para depurar, testear y documentar código

Si lo que necesitas es un curso de prompt engineering para programadores que puedas aplicar mañana mismo, aquí va algo más útil que una charla genérica: plantillas que puedes copiar tal cual —depuración, tests, revisiones, documentación—. La programación asistida por inteligencia artificial ya forma parte del día a día en bastantes equipos; la clave no es pedirle “código mágico”, sino darle contexto con orden. Cuando usas la IA como tutor de programación y le dejas claro qué quieres, qué no quieres y cómo vas a comprobar el resultado, deja de marearte y empieza a ahorrarte tiempo.

Para situarte en el mapa de aprender a programar con IA, nuestra guía para aprender a programar con IA en 2025 ordena conceptos y herramientas; si prefieres ir directo al chat, la guía práctica de ChatGPT para programar encaja como complemento.

Ingeniería de prompts para código: qué cambia frente a un prompt de marketing

En ingeniería de software, el modelo no adivina tu stack, tus convenciones ni el error de verdad si solo sueltas un mensaje vago. Un prompt serio para desarrollo suele incluir: rol (por ejemplo, “actúa como revisor senior”), contexto mínimo (lenguaje, framework, versión si importa), algo observable (log, trozo de código, test en rojo), qué forma quieres la respuesta (formato, estilo, límites) y criterios de aceptación claros. Sin eso, lo normal es que invente o que te devuelva algo bonito e inútil.

Seis plantillas de prompt listas para copiar

Copia el bloque, cambia nombres de archivos y rellena lo que va entre corchetes. Son esqueletos: tú ajustas el tono a tu equipo.

1) Explicar un error (stack trace o test rojo)

Actúa como desarrollador senior en [LENGUAJE/FRAMEWORK].

CONTEXTO
- Objetivo del módulo: [1 frase]
- Entorno: [OS, versión runtime, dependencias relevantes]

ENTRADA
[Pega aquí el error completo / salida del test / stack trace]

TAREAS
1) Explica la causa más probable en 5 viñetas.
2) Propón 2 hipótesis alternativas y cómo descartarlas.
3) Da un plan de depuración ordenado (pasos 1..n).
4) Si falta información, lista exactamente qué dato adicional necesitas.

FORMATO
- Sin soluciones inventadas: si no hay certeza, dilo.

2) Generar tests unitarios

Eres QA engineer. Genera tests para esta función respetando [JEST/PYTEST/JUNIT…].

CÓDIGO
``` 
[Pega función o clase]
```

REQUISITOS
- Casos felices, borde y error.
- Mocks solo si son necesarios; justifica cada mock.
- Nombres de test descriptivos.
- Cobertura mínima: [lista de ramas/escenarios].

SALIDA
- Solo código de tests + breve nota de cómo ejecutarlos.

3) Revisar un pull request (diff)

Revisa este diff como revisor de equipo. Criterios: legibilidad, seguridad básica, rendimiento obvio, tests faltantes.

DIFF
```
[Pega diff]
```

ENTREGA
- Resumen en 3 bullets para el autor.
- Lista de “must fix” vs “nice to have”.
- Preguntas abiertas si la intención no está clara.
- Señala riesgos de romper compatibilidad.

4) Documentar una función (docstring / JSDoc)

Documenta esta función para otros devs. Estilo: [JSDoc/docstring PEP257/etc.].

CÓDIGO
```
[Pega código]
```

INCLUYE
- Qué hace y qué NO hace.
- Parámetros (tipo, unidades si aplica).
- Retornos y errores posibles.
- 1 ejemplo de uso realista.
- Complejidad aproximada solo si es relevante.

5) Traducir lógica a otro lenguaje

Traduce el siguiente algoritmo de [LENGUAJE_A] a [LENGUAJE_B] manteniendo el comportamiento observable.

CÓDIGO ORIGEN
```
[Pega código]
```

RESTRICCIONES
- Sin librerías externas salvo: [lista o “ninguna”].
- APIs idiomáticas de [LENGUAJE_B].
- Comenta líneas no triviales.
- Señala trampas comunes de semántica (tipos, null, async).

SALIDA
- Código completo + tabla breve de diferencias clave.

6) Checklist de seguridad básica (antes de merge)

Analiza este código buscando problemas de seguridad básicos OWASP-style (inyección, XSS, secretos hardcodeados, validación de entrada, permisos).

CÓDIGO / DIFF
```
[Pega aquí]
```

FORMATO
- Tabla: hallazgo | severidad (baja/media/alta) | evidencia | remedio concreto.
- Si no hay evidencia suficiente, lista qué archivo/función revisarías después.

Errores típicos al pedir código a la IA (y cómo corregirlos)

• Contexto insuficiente: sin archivos ni versión, el modelo inventa APIs. Qué hacer: pega el fichero o un diff acotado y menciona el framework y la versión si importa.
• Prompts vagos (“hazlo mejor”): sin criterio, cualquier respuesta vale. Qué hacer: pide cosas medibles: “reduce consultas N+1”, “haz pasar estos tests”, “respeta el linter X”.
• Pegar credenciales, tokens o datos personales: riesgo serio de filtrado y de líos legales. Qué hacer: anonimiza, usa variables de entorno y lee la política de tu empresa antes de usar chats en la nube.
• Quedarte con la primera respuesta: la IA no es un compilador con criterio humano. Qué hacer: pide alternativas, exige pruebas y ejecuta tú el código antes de darlo por bueno.

Programación asistida por inteligencia artificial: tú sigues al mando

La IA te saca borradores y te ayuda a explorar, pero el diseño, la seguridad y el mantenimiento siguen siendo cosa tuya. Un truco que funciona bien: ir en rondas —primero plan, luego implementación mínima, luego tests, luego refactor—. Así se nota menos la deuda técnica que a veces se cuela sin que te des cuenta.

De las plantillas a un plan de aprendizaje con feedback

Cuando quieras ordenar todo esto en un itinerario —con prácticas corregidas y ojo puesto en empleabilidad— echa un vistazo a lo que ofrece Elhackerriojano: academia para principiantes y gente en transición, contenido de programación con IA y acompañamiento de verdad (matrícula, comunidad, seguimiento). Tiene sentido cuando ya manejas el teclado y te falta sobre todo estructura.

Preguntas frecuentes

¿Un curso de prompt engineering para programadores sustituye saber algoritmos?

No. Los prompts alisan el trabajo, pero no reemplazan bases sólidas. Mezcla práctica de código, revisión humana y uso de la IA con límites claros.

¿Cómo usar ChatGPT para programar sin liarte con licencias raras?

Pide fuentes cuando puedas, revisa la licencia de lo que te sugiera y no pegues código de terceros sin atribución. Si dudas, reescribe con tus palabras y tus tests.

¿La IA como tutor de programación funciona en equipo?

Sí, si os ponéis de acuerdo en plantillas, en qué datos no se suben nunca al chat y en que todo pasa por PR. Documentar qué partes fueron asistidas ayuda en auditorías y cuando entra gente nueva.