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

/dixi.build

Propósito

Construir una tarea con pruebas primero: rojo, verde y verificación.

Implementar la tarea de $ARGUMENTS siguiendo TDD: pruebas en rojo, código mínimo hasta verde y make verify.

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

Invocación

Argumento: <ID de la tarea>. 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. Localiza la tarea en 05-features/*/tasks.md. Si un archivo de 05-features/<slug>/checklists/ tiene ítems abiertos (- [ ]), enuméralos y detente hasta que la persona los cierre o decida continuar. Si no existe, tiene dependencias abiertas o es de nivel 3 sin validar, detente y dilo. Lee wip_limit en AGENTS.md (por defecto 3); si gh está disponible y autenticado y la persona ya tiene esa cantidad de pull requests abiertos, detente y sugiere terminar uno primero.
  2. Escribe primero las pruebas del criterio de la tarea en el lenguaje del proyecto. Ejecútalas y muestra que fallan por la razón esperada. Sin prueba en rojo no escribas código.
  3. Propón registrar las pruebas en rojo en su propio commit, sin Signed-off-by; la persona firma después. Desde ese momento son pruebas congeladas.
  4. Escribe el código mínimo para pasar a verde. No cambies las pruebas congeladas; si crees que una es incorrecta, detente y explícalo.
  5. Ejecuta make verify y muestra el resultado real. Si falla, corrige el código, no la prueba.
  6. Registra las pruebas en .dixi/traceability.json (kind: test) y marca la tarea como hecha solo con make verify en verde.
  7. Sugiere /dixi.verify.

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, comprobaciones (ejecutadas, fallidas, no ejecutadas), pendientes y el siguiente comando sugerido.

Siguiente paso

Relacionado