¿Qué hace validate-changes-match-specs?
Valida que la implementación de una rama o solicitud de extracción coincida con las especificaciones de producto, técnicas, de seguridad y relacionadas introducidas. Úselo al revisar o finalizar un cambio impulsado por especificaciones y resolver discrepancias entre las especificaciones registradas y la implementación.
Cómo funciona
Esta habilidad analiza los archivos de especificaciones (como specs/*.md u otros formatos) y los compara con el código fuente modificado en la rama o PR. Detecta:
- Funcionalidades implementadas sin especificación correspondiente.
- Especificaciones que no tienen implementación.
- Inconsistencias entre los requisitos especificados y la lógica del código.
- Cambios no documentados en las especificaciones.
Requisitos
- El repositorio debe contener archivos de especificaciones en una ubicación conocida (por ejemplo,
specs/). - Las especificaciones deben estar en un formato legible (Markdown, YAML, etc.).
- La habilidad asume que el agente tiene acceso de lectura al árbol de trabajo y al historial de git.
Uso
Ejemplo de invocación:
# En una terminal o contexto de agente
validate-changes-match-specs --branch feature/nueva-funcionalidad
O desde la interfaz del agente:
Valida que los cambios en la rama actual cumplan con todas las especificaciones.
Opciones
--branch <nombre>: Rama a validar (por defecto: rama actual).--specs-dir <ruta>: Directorio donde se encuentran las especificaciones (por defecto:specs/).--verbose: Muestra información detallada de las discrepancias.--fix: Intenta corregir automáticamente desviaciones menores (actualizar especificaciones o código).
Ejemplo de salida
Validando implementación contra especificaciones...
✓ Especificación: 'specs/autenticacion.md' implementada completamente.
⚠ Especificación: 'specs/exportacion.md' - Falta la función de exportar a CSV.
✗ Implementación sin especificación: 'src/utils/logging.py' añade logs sin especificación.
Resumen: 2 especificaciones, 1 implementación sin especificar. 1 discrepancia encontrada.
Notas
- Esta habilidad es complementaria a las revisiones manuales, no las reemplaza.
- Para cambios grandes, se recomienda ejecutar la validación periódicamente.
- Los resultados se basan en el análisis estático; no ejecuta pruebas ni verifica comportamiento dinámico.