¿Qué hace Revisión-de-Requisitos?
Habilidad de Claude para revisar requisitos/historias de usuario contra 7 criterios de calidad antes del análisis de pruebas — hallazgos basados en citas, niveles de severidad y preguntas abiertas al analista de negocio.
¿Qué hace?
Esta habilidad toma uno o más requisitos o historias de usuario y los evalúa contra los siguientes 7 criterios de calidad:
- Claridad: ¿El requisito está libre de jerga técnica innecesaria? ¿Es comprensible para todas las partes interesadas?
- Completitud: ¿El requisito contiene toda la información necesaria para la implementación y las pruebas?
- Consistencia: ¿El requisito está libre de contradicciones internas y es consistente con otros requisitos?
- Atomicidad: ¿El requisito aborda una sola característica o funcionalidad (no es un megarequisito)?
- Testabilidad: ¿El requisito se puede verificar mediante pruebas definidas? ¿Los criterios de aceptación son claros?
- Ausencia de ambigüedad: ¿El requisito tiene una sola interpretación? ¿Evita palabras vagas como "apropiado", "generalmente", "a veces"?
- Trazabilidad: ¿El requisito tiene un identificador único o está vinculado a un origen?
Cómo usarlo
Invoca la habilidad en Claude con el texto del requisito o la historia de usuario. Claude devolverá un informe estructurado que incluye:
- Hallazgo: Cita textual del requisito relevante para cada criterio.
- Severidad: Nivel de severidad (Alto, Medio, Bajo) para cada fallo.
- Pregunta para el BA: Una o más preguntas abiertas sugeridas para resolver la deficiencia.
Ejemplo de comando:
Usa el skill Shambolika/Revisión-de-Requisitos para revisar esta historia de usuario:
"Como usuario, quiero poder filtrar la lista de pedidos por fecha y estado, para encontrar rápidamente pedidos relevantes. El sistema debe mostrar los resultados de manera rápida."
Salida de ejemplo:
| Criterio | Hallazgo | Severidad | Pregunta para el BA |
|---|---|---|---|
| Claridad | "mostrar los resultados de manera rápida" | Medio | ¿Hay un tiempo de respuesta específico considerado como 'rápido'? |
| Completitud | Sin criterio de aceptación explícito para el filtro combinado | Alto | ¿Qué sucede si la combinación de fecha y estado no devuelve resultados? |
| Ausencia de ambigüedad | "manera rápida" es subjetivo y vago | Alto | ¿Podemos definir 'rápido' como una métrica específica (ej. < 2 segundos)? |
Plataformas compatibles
- Claude Code
- Cursor (con Claude)
- Cualquier interfaz de Claude que soporte habilidades personalizadas
Notas adicionales
- Asegúrate de que los requisitos se proporcionen con suficiente contexto para una revisión completa.
- Los niveles de severidad son sugerencias; el equipo debe acordar la priorización real.
- Las preguntas al BA deben usarse para facilitar la conversación y mejorar la calidad del requisito de manera colaborativa.