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

/dixi.risk-review

Propósito

Preparar para una persona un informe de revisión por riesgo de un pull request, rama o diff.

Preparar para una persona un informe de revisión por riesgo del cambio de $ARGUMENTS (número de pull request, rama o base; por defecto la rama actual contra main). Este informe no aprueba nada.

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

Invocación

Argumento: [número de pull request, rama o base, por defecto la rama actual contra main]. 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. Obtén el diff sin modificar nada: git diff <base>...HEAD y git diff --stat <base>...HEAD, o gh pr diff <n> si gh está disponible y $ARGUMENTS es un número de pull request.
  2. Mide el tamaño con dixi pr-size --base <base>. Las pruebas se informan aparte; léelas primero.
  3. Encuentra la spec y la tarea que implementa el cambio (05-features/*/feature-spec.md, 05-features/*/tasks.md, .dixi/traceability.json). Si no hay, es el primer hallazgo.
  4. Clasifica el riesgo (bajo, medio, alto) según lo que toca: contratos, datos, seguridad, permisos, migraciones, dinero, entrada externa. Si el autor declaró un riesgo menor, señálalo: el riesgo se sube, nunca se baja.
  5. Explica el diff contra la spec, criterio por criterio: qué cambia en el comportamiento observable y qué prueba lo cubre.
  6. Enumera los casos borde que maneja y los que no (valores vacíos, límites, nulos, concurrencia, zonas horarias, redondeo).
  7. Enumera los supuestos que hace el cambio y que no están en la spec; cada uno es una pregunta para el autor.
  8. Indica qué podría romperse fuera de los archivos cambiados: llamadores, contratos, datos, configuración.
  9. Comprueba que las pruebas congeladas no cambiaron y que no se omitió ninguna prueba nueva; si ocurrió, es un hallazgo bloqueante.
  10. Entrega el informe: riesgo y motivo, tamaño, tabla de criterios (criterio, prueba, estado), supuestos, dónde mirar primero (archivo y línea, y por qué), hallazgos por severidad, preguntas para el autor y lo que se puede ignorar. Pon primero los hallazgos críticos. La aprobación y la integración son de la persona.

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

Sin operación siguiente fija; /dixi.status sugiere una.

Relacionado