Documentación de DIXI Spec Kit English · Código en GitHub

/dixi.bugfix

Propósito

Corregir un bug con trazabilidad: reproducción, prueba en rojo primero, arreglo mínimo, spec actualizada.

Llevar el bug descrito en $ARGUMENTS del reporte al arreglo con una prueba en rojo commiteada antes del código, y dejar un registro trazado de causa, prueba y arreglo.

Generada por scripts/build-command-reference.py a partir del texto empaquetado del comando; no la edites a mano.

Invocación

Argumento: [reporte del bug, número de issue o comportamiento que falla]. Los signos de menor y mayor marcan un valor obligatorio y los corchetes uno opcional. En los pasos, $ARGUMENTS es el texto escrito después del comando.

Ejemplo

El texto después del comando es la petición; cámbialo para que corresponda a tu proyecto.

Cuándo usarlo

Pasos

  1. Reproduce: anota los pasos, el comportamiento esperado y el real, y el entorno. Si no puedes reproducirlo, dilo y detente.
  2. Localiza el criterio, la cláusula de contrato o el principio que rompe el comportamiento en las specs de la feature y en 00-governance/principles.md. Si el comportamiento esperado no está especificado, es un hueco de la spec, no un bug: detente y sugiere /dixi.clarify o /dixi.change.
  3. Escribe 05-features/<slug>/bugs/BUG-NNN.md (siguiente número libre): reporte, reproducción, criterio roto y, más adelante, la causa raíz, la prueba y el arreglo.
  4. Escribe una prueba que falle por la razón reportada, en el lenguaje del proyecto. Ejecútala y muestra que falla. Propón registrarla en su propio commit, sin Signed-off-by; la persona firma después. Desde ese momento está congelada.
  5. Escribe el arreglo mínimo. No cambies pruebas congeladas. Ejecuta make verify y muestra el resultado real; si falla, corrige el código, no la prueba.
  6. Si el arreglo cambia un comportamiento especificado, actualiza la spec o el contrato solo cuando la persona esté de acuerdo, y regístralo en BUG-NNN.md. Registra la prueba en .dixi/traceability.json (kind: test).
  7. Sugiere /dixi.verify y /dixi.review.

Archivos que lee y escribe

Rutas que nombra el texto del comando:

Paradas y controles humanos

Cierre

Ejecuta dixi check antes de terminar e informa: archivos tocados, el registro del bug, la prueba en rojo y su commit, comprobaciones (ejecutadas, fallidas, no ejecutadas), pendientes y el siguiente comando sugerido.

Siguiente paso

Relacionado