Protección del code review contra la verborragia de la IA: cómo ocultar descripciones de PR generadas tras etiquetas detailsNota · digest del 10 de noviembre
Interfaz limpia de Pull Request con tarjeta concisa de cambios y sección plegable details prolija para ocultar reportes de IA
Nota2 secciones≈ 5 min

Protección del code review contra la verborragia de la IA: cómo ocultar descripciones de PR generadas tras etiquetas details

«No es necesariamente neuroslop, ¡pero se lee exactamente como neuroslop!», así describió Simon Willison, cocreador de Django y creador de Datasette, en una nota reciente el efecto secundario de los agentes de programación. Casi todos los cambios en sus proyectos los abren Claude Code y Codex, presentándolos en pull requests (PR —solicitud para integrar código en la rama común). Los modelos redactan explicaciones ejemplarmente precisas, pero la primera reacción de una persona real es siempre la misma: «No voy a leer todo eso».

Willison se sorprende a sí mismo sintiendo esa irritación incluso cuando él mismo lanzó al agente dos minutos antes: leer el ensayo de la máquina lleva más tiempo que asignar la tarea, y la revisión en equipo se traba. ¿Cómo conservar la bitácora detallada de la red neuronal para el historial, devolviendo al desarrollo el respeto por la atención ajena?

La trampa del reporte perfecto: por qué la precisión se vuelve ruido blanco

No se trata de alucinaciones: los agentes son demasiado cumplidos. En la solicitud n.º 3042 para Datasette, el agente reestructuró la carga del script edit-tools.js (~220 KB): antes el archivo se descargaba en cada página para todos los visitantes por igual, y ahora se carga solo para editores al pasar el ratón o hacer clic en el enlace de edición. La tarea es transparente, pero junto al código listo el modelo adjuntó un reporte de 150 líneas con antecedentes, bifurcaciones y registro de pruebas, frente al cual al revisor se le cristaliza la mirada al instante.

Cuando en un texto todo tiene el mismo peso, el lector pierde lo esencial.

Es como llamar al plomero por un grifo que gotea y preguntarle cuál era la avería. En lugar de un breve «Se rompió el empaque del agua caliente, lo cambié y ya no gotea», el técnico pone sobre la mesa un acta gruesa: aleación del latón, presión de la tubería y cronometraje de cada giro de llave. Ni una palabra falsa, pero en la segunda hoja pierdes el hilo y pasas por alto el detalle clave: que la rosca de la válvula apenas aguanta. Al ver descripciones de IA de varias pantallas en GitHub, se me dispara el mismo reflejo defensivo.

En el code review —la revisión de código antes de publicar— tu colega no necesita la estenografía de un robot, sino un filtro editorial humano.

Plantilla de dos capas con details y regla para el agente

Para recuperar ese filtro y conservar el registro de auditoría, Willison dividió la descripción del PR en dos pisos. Arriba queda un par de frases del autor (a veces con captura o salida de --help) que ponen al tanto de inmediato; a menudo basta con extraer esa frase precisa del propio borrador del modelo.

Y todo el informe detallado del agente se guarda bajo el spoiler de las etiquetas HTML <details> y <summary>.

Según la documentación de GitHub, el marcado GitHub Flavored Markdown las soporta de forma nativa (igual que GitLab y Bitbucket). Simon pone en <summary> el nombre del modelo y el nivel de esfuerzo —algo como Claude Opus 5.5 Medium—, y para no confundir el orden de las etiquetas recomienda decir en voz alta «details-summary»: suena más fluido que «summary-details». Un matiz crucial: justo después de </summary> debe haber una línea en blanco, o de lo contrario las listas y bloques de código internos se romperán en un amasijo crudo. Empaquetemos nuestra solicitud del script edit-tools.js en esa plantilla:

El script `edit-tools.js` (~220 KB) antes se descargaba en cada página para todos los visitantes. Ahora se carga mediante un cargador ligero solo para editores al pasar el ratón o hacer clic en editar.

<details>
<summary>Detalles del trabajo del agente (Claude Opus 5.5 Medium)</summary>

**Qué cambió en el código:**
- Se extrajo el cargador para la inicialización diferida de las herramientas de edición.
- Se verificaron los escenarios de acceso para lectores y editores.
</details>

En la página de GitHub, la sábana larga se pliega en una barra ordenada debajo de dos frases claras. Tu colega capta en un par de segundos la esencia de la optimización y abre la pestaña de código, y si toca buscar un bug raro seis meses después, todo el historial de pruebas se despliega con un clic. Para no teclear los corchetes a mano (sobre todo desde el teléfono, donde GitHub no tiene botón de spoiler), fija esta regla en una sola línea en CLAUDE.md —solo no sobrecargues la configuración con burocracia, algo que ya tratamos en el análisis sobre auditoría de prompts del sistema en Claude Code.

Una descripción plegada cuida los ojos del revisor, pero no permite aprobar código a ciegas: sigue haciendo falta revisar cambios y pruebas en persona (cómo construir esa disciplina lo detallamos en el artículo sobre control de calidad y code review al trabajar con asistentes de IA).

Y si miras tu jornada de hoy: ¿en qué otros reportes de trabajo, correos o chats a la gente a tu alrededor le hacen falta tus dos frases humanas encima de un texto largo de red neuronal?

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 2