DescargableESMD23 oct
Checklist para revisar código generado por IA
Una veintena de comprobaciones ordenadas de la más barata a la más profunda, de «¿existe el paquete?» a «¿lo explicaría yo?».
checklist-revisar-codigo-ia.md
MD · Tamaño 2,5 KB
Qué incluye
- Existencia, alcance, seguridad, corrección, pruebas y mantenimiento
- Tres preguntas finales antes de fusionar
- Formato de casillas, listo para pegar en una PR o en tu gestor de tareas
Vista previa
# Checklist para revisar código generado por IA > Una veintena de comprobaciones, ordenadas de la más barata a la más profunda. > Si una falla, no sigas: arréglala y vuelve a empezar la lista. > Recurso de acastell.dev — https://acastell.dev/recursos --- ## 1. ¿Existe todo lo que usa? - [ ] Cada paquete importado existe en el repositorio oficial, tiene mantenedores y no es de ayer. - [ ] Cada función, método y opción que llama existe en la versión que tienes instalada (abre la documentación; no te fíes de la memoria del modelo). - [ ] No hay URLs, rutas ni variables de entorno inventadas. ## 2. ¿Hace lo que pedí? ¿Y solo eso? - [ ] Resuelve exactamente la petición, sin reescribir cosas que no pedí. - [ ] No ha tocado archivos fuera del alcance (mira la lista de archivos del diff antes de leer una línea). - [ ] No ha eliminado comprobaciones, tests o comentarios «para simplificar». ## 3. Seguridad - [ ] No hay secretos, tokens ni claves en el código, en los logs ni en los ejemplos. - [ ] Toda entrada externa (formularios, parámetros, ficheros, respuestas de APIs) se valida antes de usarse. - [ ] Las consultas a base de datos están parametrizadas; no se construyen concatenando texto. - [ ] Lo que se muestra al usuario está escapado; nada de HTML sin sanear. - [ ] Los permisos son los mínimos necesarios (no `*`, no «admin» por comodidad). ## 4. Corrección - [ ] Casos límite: vacío, nulo, un solo elemento, muchos elementos, texto muy largo, caracteres raros, fechas y zonas horarias. - [ ] Los errores se gestionan y se comunican; no hay `catch` vacíos que se los tragan. - [ ] Las operaciones que pueden fallar a medias (red, disco, base de datos) no dejan datos a medias. - [ ] Nada depende de que algo ocurra «siempre en este orden». ## 5. Pruebas - [ ] Hay tests nuevos que fallarían si el código estuviera mal (cámbialo a propósito y mira si fallan). - [ ] Los tests existentes siguen pasando y no se han debilitado para que pasen. - [ ] Lo has ejecutado tú; no basta con que el asistente diga que funciona. ## 6. Mantenimiento - [ ] Alguien que no ha visto el chat entiende el porqué leyendo el código. - [ ] No hay código duplicado de algo que ya existía en el proyecto. - [ ] No añade dependencias grandes para una tarea pequeña. --- ## Antes de fusionar, tres preguntas 1. ¿Qué es lo peor que pasaría si esto falla en producción? 2. ¿Qué parte NO he podido comprobar? 3. ¿Me atrevería a explicar este código en una reunión, línea a línea? Si la respuesta a la tercera es «no», todavía no es tu código.
¿Te ha servido?
Cada día un Short nuevo y, cuando toca, un tutorial a fondo. Suscríbete y no te pierdas el siguiente.
Sigue con
- ArtículoES · 6 min de lecturaTherac-25: ejecuta sus dos bugs en el navegadorReconstrucción didáctica de los dos fallos de software documentados del Therac-25: el de los 8 segundos y el del byte. Y el mismo fallo con y sin enclavamiento físico.Leer artículo
- ArtículoES · 6 min de lecturaPor qué la IA se inventa cosas (y cómo cazarlo)Un modelo de lenguaje genera texto plausible, no consulta una base de hechos. Dónde falla y cinco defensas que funcionan.Leer artículo
- PromptESRevisor de código adversarialUna revisión que busca por qué un cambio NO debería fusionarse, con severidad, línea y arreglo. Sin inventar problemas.Usar prompt