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

/dixi.interview

Propósito

Rellenar los huecos pendientes del proyecto con una entrevista guiada, una pregunta a la vez.

Rellenar los huecos {{pending: …}} de los documentos del proyecto entrevistando a la persona, una pregunta a la vez. $ARGUMENTS puede acotar la entrevista a un área (por ejemplo 01-business) o a un archivo.

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

Invocación

Argumento: [área o archivo opcional]. 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. Ejecuta dixi placeholders para ver qué archivos tienen huecos pendientes y cuántos. Si no queda ninguno, dilo y detente.
  2. Lee profile en .dixi/project.json para saber qué áreas aplican. Sigue el orden del perfil: empieza por 00-master-spec.md y 01-business/ y después las demás áreas que instala el perfil. Con $ARGUMENTS, recorre solo esa área o ese archivo.
  3. Para cada hueco, haz una sola pregunta a la vez, en lenguaje claro y con el contexto que la persona necesita para responder. Ofrece un ejemplo o un valor por defecto solo como sugerencia, nunca como respuesta.
  4. Escribe cada respuesta en lugar de su marcador, en el idioma del documento. Nunca respondas por la persona: si no lo sabe o prefiere dejarlo para después, conserva el marcador tal cual.
  5. Rellena solo huecos. No edites reglas, políticas ni texto marcado como norma; si una respuesta contradice alguna, muestra la contradicción y pregunta.
  6. Cuando una respuesta sea una decisión estructural (stack, arquitectura, almacenamiento de datos, integraciones), regístrala en 09-architecture/adr/ADR-NNN-<slug>.md con estado «Propuesto»; queda bloqueada hasta que la persona la valide.
  7. Al terminar cada área, resume lo que escribiste y pregunta si se sigue con la siguiente. Ejecuta de nuevo dixi placeholders para mostrar lo que queda.
  8. Sugiere /dixi.discover o /dixi.clarify si quedan preguntas abiertas, o /dixi.status.

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