Cómo escribir un buen prompt

Un buen prompt incluye el tema (qué explicar), la audiencia (quién está aprendiendo y qué sabe de antemano) y los tipos de diapositiva (cómo debería mostrar las cosas la lección). La profundidad depende sobre todo del profesor que elijas, aunque el prompt puede intensificarla.

Tú no diseñas la lección. Explain decide la estructura y el diseño, así que el prompt solo se ocupa de qué va a entrar en ella. Las tres partes caben en una sola oración:

›¿por qué una clausura sigue viendo una variable después de que la función terminó? sé Python pero no JS, muéstrame un diagrama

Tema puede ser una sola palabra. ›clausuras te da una lección general sobre el concepto, lo cual está bien si eso es lo que quieres. Si ya sabes qué es lo que te confunde, di esa parte en su lugar, como en la pregunta de arriba.

Audiencia es la oración que la mayoría de la gente deja fuera. Di lo que ya sabes, no solo lo que no sabes:

›...entiendo la sintaxis, lo que me falta es el "por qué"

Tipos de diapositiva son el control que tienes sobre el diseño: diagramas para estructura, animaciones para procesos, diffs para cambios, un quiz para ponerte a prueba. Y puedes ser específico sobre qué debe hacer una diapositiva, no solo de qué tipo es:

›...usa referencias con punteros bastante seguido al explicar el código›...anima un gráfico con flechas que señalen los puntos de inflexión

Tú eliges qué va en la diapositiva. Explain decide cómo se organiza.

Así también es como puedes llevar la profundidad más allá de lo que da el profesor. El estilo de enseñanza marca el punto de partida, pero el prompt puede exigir más:

›...usa el puntero para resaltar cada línea de código y explica cada una en detalle, no te saltes ninguna

Estilo de imagen

Los explainers con diapositivas de imagen eligen un solo estilo artístico para toda la lección, y puedes indicarlo en el prompt. Pide algo dibujado a mano y la lección se ve como un cuaderno de bocetos; pide algo fotorrealista y se ve como un documental:

›...ilustraciones dibujadas a mano, como un cuaderno de bocetos

docs.scrimba.com

›...imágenes fotorrealistas, como un documental

docs.scrimba.com

El estilo que indiques (acuarela, pixel art, plano técnico) se aplica a todas las imágenes de la lección.

Contexto

La otra mitad de un buen prompt es lo que le das para que enseñe a partir de eso. Por defecto, Explain enseña con su propio conocimiento; mientras más contexto le entregues, más se centra la lección en tu tema específico en lugar del tema general. Pega código directamente en el prompt, adjunta documentos como una especificación, un artículo o tus apuntes, o usa un agente de código, que tiene todo tu repositorio como contexto.

Y un tema desnudo sigue siendo un buen prompt. Mira la lección, fíjate en qué falta, y haz que el segundo prompt sea el preciso.