Traducido del prompt en inglés. La versión en inglés es la que probamos.
El prompt
Copia el prompt, pégalo en tu chatbot y sustituye los textos entre corchetes por tu material. El asistente responderá en español.
Escribe toda tu respuesta en español. Mantén en su idioma original cualquier texto citado de las fuentes.
Escribe el texto del pull request a partir del diff de abajo. Usa solo lo que muestran el diff y mis notas.
Por qué este cambio (si lo sabes): [motivo, enlace al ticket o "no estoy seguro"]
Pruebas que ejecuté (si hay): [o "ninguna todavía"]
Diff: [pega aquí]
Resultado, listo para pegar:
- Título: menos de 70 caracteres, en imperativo.
- Resumen: de 2 a 4 frases, qué y por qué. Si el motivo no está en mis notas, escribe "Por qué: no indicado" en vez de adivinar.
- Cambios: viñetas agrupadas por propósito, con los nombres de los archivos. Separa los cambios de comportamiento de las refactorizaciones, los cambios de nombre, el formato y los archivos generados.
- Riesgo y foco de la revisión: dónde mirar con atención y por qué. Señala cambios que rompen compatibilidad, migraciones, variables de entorno nuevas, cambios de dependencias, código de autenticación tocado, código eliminado y lógica cambiada sin pruebas.
- Cómo se probó: solo lo que te dije o lo que muestra el diff. Nunca afirmes que las pruebas pasaron. Si no se sabe, escribe "No indicado" y da un plan de pruebas sugerido.
- Despliegue y reversión: solo si hay una migración, un flag, una configuración o un paso de despliegue.
- Preguntas que probablemente haga quien revise: hasta 5, ligadas a un fragmento concreto del diff, con tu mejor respuesta o "Necesita respuesta del autor".
- Necesito tu aporte: los datos que no pudiste sacar del diff.
Reglas: no inventes una motivación, un número de ticket, una medición de rendimiento ni un resultado de pruebas. No describas cambios que no viste. Frases cortas y sencillas, sin palabras grandilocuentes, sin emojis, sin rayas largas.Un ejemplo real (en inglés)
El ejemplo se queda en inglés porque es el resultado de la prueba original. El prompt traducido responde en español.
Before: A commit-list dump: "fix res.send / bump qs / bump proxy-addr / bump morgan"
After (skill output, from a real test run): Test run on four real commits from a public web framework. Output, unedited: "Title: Preserve ETag with Transfer-Encoding in res.send; bump deps". It grouped the fix and the three dependency bumps separately, noted which bumps were runtime vs dev, said the diff showed no lockfile change, wrote "Why: not stated in the diff", and caught that the branch it was asked to diff against was behind another branch.
Límites
- Solo conoce el diff y los mensajes de commit. El motivo del cambio lo pones tú.
- No ejecuta pruebas. "Cómo se probó" dice "No indicado" salvo que se lo cuentes.
- No abre el PR. Tú pegas el texto.
- Diffs muy grandes: lee primero el resumen estadístico y luego los archivos clave, y dice qué omitió.