Propósito de la Lista de Verificación: "Pruebas Unitarias para Inglés"
CONCEPTO CRÍTICO: Las listas de verificación son PRUEBAS UNITARIAS PARA LA REDACCIÓN DE REQUISITOS - validan la calidad, claridad y completitud de los requisitos en un dominio determinado.
NO para verificación/pruebas:
- ❌ NO "Verificar que el botón haga clic correctamente"
- ❌ NO "Probar que el manejo de errores funcione"
- ❌ NO "Confirmar que la API devuelva 200"
- ❌ NO verificar si el código/implementación coincide con la especificación
PARA validación de calidad de requisitos:
- ✅ "¿Están definidos los requisitos de jerarquía visual para todos los tipos de tarjetas?" (completitud)
- ✅ "¿Está cuantificado 'visualización prominente' con tamaño/posicionamiento específico?" (claridad)
- ✅ "¿Son consistentes los requisitos de estado hover en todos los elementos interactivos?" (consistencia)
- ✅ "¿Están definidos los requisitos de accesibilidad para la navegación por teclado?" (cobertura)
- ✅ "¿Define la especificación qué sucede cuando la imagen del logo falla al cargar?" (casos límite)
Metáfora: Si tu especificación es código escrito en inglés, la lista de verificación es su conjunto de pruebas unitarias. Estás probando si los requisitos están bien escritos, son completos, inequívocos y están listos para la implementación - NO si la implementación funciona.
Propiedad y ciclo de vida de las casillas de verificación:
- Las listas de verificación personalizadas generadas por este comando son artefactos de revisión de calidad de requisitos propiedad del revisor.
[x]significa que el revisor determinó que el criterio de calidad de requisitos está satisfecho.[x]NO significa que el trabajo de implementación esté completo.- Este comando genera o agrega elementos de la lista de verificación; NO DEBE marcar los elementos generados como
[x]. - Un agente puede ayudar a evaluar elementos solo cuando el revisor lo solicite explícitamente.
checklists/requirements.mdes una lista de verificación de calidad de especificación incorporada separada, mantenida por/speckit-specifyy/speckit-clarify; no tratar esa excepción como aplicable a listas de verificación personalizadas generadas aquí.
Entrada del Usuario
$ARGUMENTS
DEBES considerar la entrada del usuario antes de continuar (si no está vacía).
Verificaciones Previas a la Ejecución
Verificar si hay hooks de extensión (antes de la generación de la lista de verificación):
- Verificar si existe
.specify/extensions.ymlen la raíz del proyecto. - Si existe, leerlo y buscar entradas bajo la clave
hooks.before_checklist - Si el YAML no se puede analizar o no es válido, no omitir en silencio: informar al usuario que
.specify/extensions.ymlno se pudo leer (incluir el error del analizador) y que no se verificaron hooks, incluidos los hooks obligatorios (optional: false) registrados allí, luego continuar normalmente - Filtrar los hooks donde
enabledsea explícitamentefalse. Tratar los hooks sin un campoenabledcomo habilitados por defecto. - Para cada hook restante, no intentar interpretar o evaluar las expresiones de
conditiondel hook:- Si el hook no tiene campo
condition, o es nulo/vacío, tratar el hook como ejecutable - Si el hook define una
conditionno vacía, omitir el hook y dejar la evaluación de la condición a la implementación de HookExecutor
- Si el hook no tiene campo
- Al construir invocaciones de comando a partir de nombres de comando de hook, reemplazar los puntos (
.) con guiones (-). Por ejemplo,speckit.git.commit→/speckit-git-commit. - Para cada hook ejecutable, generar la siguiente salida según su bandera
optional:- Hook opcional (
optional: true):## Extension Hooks **Pre-Hook Opcional**: {extension} Comando: `/{command}` Descripción: {description} Indicación: {prompt} Para ejecutar: `/{command}` - Hook obligatorio (
optional: false):
Después de emitir el bloque anterior, DEBES invocar realmente el hook y esperar a que termine antes de continuar. Ejecutarlo de la misma manera que ejecutarías el comando tú mismo en este agente/sesión (la invocación puede diferir del ID literal## Extension Hooks **Pre-Hook Automático**: {extension} Ejecutando: `/{command}` EXECUTE_COMMAND: {command} Esperar el resultado del comando del hook antes de continuar con los Pasos de Ejecución.{command}mostrado arriba, por ejemplo, un agente en modo habilidades lo ejecuta como/skill:speckit-...o$speckit-...). Emitir el bloque solo no ejecuta el hook.
- Hook opcional (
- Si no hay hooks registrados o
.specify/extensions.ymlno existe, omitir en silencio
Pasos de Ejecución
-
Configuración: Ejecutar
.specify/scripts/bash/check-prerequisites.sh --json --template checklist-templatedesde la raíz del repositorio y analizar el JSON para obtener FEATURE_DIR, lista AVAILABLE_DOCS y TEMPLATE_CONTENT.- Todas las rutas de archivo deben ser absolutas.
- Para comillas simples en argumentos como "I'm Groot", usar sintaxis de escape: p.ej. 'I'''m Groot' (o comillas dobles si es posible: "I'm Groot").
-
SI EXISTE: Cargar
.specify/memory/constitution.mdpara principios del proyecto y restricciones de gobierno. -
Aclarar intención (dinámica): Derivar hasta TRES preguntas aclaratorias de contexto iniciales (sin catálogo predefinido). DEBEN:
- Generarse a partir de la redacción del usuario + señales extraídas de la especificación/plan/tareas
- Preguntar solo sobre información que cambie materialmente el contenido de la lista de verificación
- Omitirse individualmente si ya no son ambiguas en
$ARGUMENTS - Preferir precisión sobre amplitud
Algoritmo de generación:
- Extraer señales: palabras clave del dominio de la funcionalidad (p. ej., auth, latencia, UX, API), indicadores de riesgo ("crítico", "debe", "cumplimiento"), pistas de partes interesadas ("QA", "revisión", "equipo de seguridad"), y entregables explícitos ("a11y", "rollback", "contratos").
- Agrupar señales en áreas de enfoque candidatas (máx. 4) clasificadas por relevancia.
- Identificar audiencia y momento probables (autor, revisor, QA, publicación) si no es explícito.
- Detectar dimensiones faltantes: amplitud del alcance, profundidad/rigor, énfasis en el riesgo, límites de exclusión, criterios de aceptación medibles.
- Formular preguntas elegidas de estos arquetipos:
- Refinamiento del alcance (p. ej., "¿Debería esto incluir puntos de contacto de integración con X e Y o limitarse a la corrección del módulo local?")
- Priorización de riesgos (p. ej., "¿Cuáles de estas áreas de riesgo potencial deberían tener verificaciones de puerta obligatorias?")
- Calibración de profundidad (p. ej., "¿Es una lista de verificación rápida previa a la confirmación o una puerta de lanzamiento formal?")
- Marco de audiencia (p. ej., "¿Será utilizada solo por el autor o por pares durante la revisión del PR?")
- Exclusión de límites (p. ej., "¿Deberíamos excluir explícitamente los elementos de ajuste de rendimiento esta vez?")
- Brecha de clase de escenario (p. ej., "No se detectaron flujos de recuperación; ¿están los caminos de reversión/fallo parcial dentro del alcance?")
Reglas de formato de preguntas:
- Si se presentan opciones, generar una tabla compacta con columnas: Opción | Candidato | Por qué es importante
- Limitar a un máximo de opciones A–E; omitir la tabla si una respuesta de forma libre es más clara
- Nunca pedir al usuario que reformule lo que ya dijo
- Evitar categorías especulativas (sin alucinaciones). Si no está seguro, preguntar explícitamente: "Confirme si X pertenece al alcance."
Valores predeterminados cuando la interacción es imposible:
- Profundidad: Estándar
- Audiencia: Revisor (PR) si está relacionado con código; Autor en caso contrario
- Enfoque: Los 2 grupos de relevancia principales
Generar las preguntas (etiquetar Q1/Q2/Q3). Después de las respuestas: si ≥2 clases de escenario (Alternativa / Excepción / Recuperación / Dominio no funcional) permanecen poco claras, PUEDES hacer hasta DOS preguntas de seguimiento más específicas (Q4/Q5) con una justificación de una línea cada una (p. ej., "Riesgo de ruta de recuperación no resuelto"). No exceder de cinco preguntas en total. Omitir la escalada si el usuario declina explícitamente más.
-
Comprender la solicitud del usuario: Combinar
$ARGUMENTS+ respuestas aclaratorias:- Derivar el tema de la lista de verificación (p. ej., seguridad, revisión, despliegue, ux)
- Consolidar elementos obligatorios explícitos mencionados por el usuario
- Mapear selecciones de enfoque a la estructura de categorías
- Inferir cualquier contexto faltante de la especificación/plan/tareas (NO alucinar)
-
Cargar contexto de la funcionalidad: Leer desde FEATURE_DIR:
- spec.md: Requisitos y alcance de la funcionalidad
- plan.md (si existe): Detalles técnicos, dependencias
- tasks.md (si existe): Tareas de implementación
Estrategia de Carga de Contexto:
- Cargar solo las porciones necesarias relevantes para las áreas de enfoque activas (evitar volcado de archivos completos)
- Preferir resumir secciones largas en viñetas concisas de escenario/requisito
- Usar divulgación progresiva: agregar recuperación de seguimiento solo si se detectan brechas
- Si los documentos fuente son grandes, generar elementos de resumen provisionales en lugar de incrustar texto sin procesar
-
Generar lista de verificación - Usar TEMPLATE_CONTENT como plantilla estructural y crear "Pruebas Unitarias para Requisitos":
- Crear el directorio
FEATURE_DIR/checklists/si no existe - Generar un nombre de archivo de lista de verificación único:
- Usar un nombre corto y descriptivo basado en el dominio (p. ej.,
ux.md,api.md,security.md) - Formato:
[dominio].md
- Usar un nombre corto y descriptivo basado en el dominio (p. ej.,
- Comportamiento de manejo de archivos:
- Si el archivo NO existe: Crear nuevo archivo y numerar elementos comenzando desde CHK001
- Si el archivo existe: Agregar nuevos elementos al archivo existente, continuando desde el último ID CHK (p. ej., si el último elemento es CHK015, comenzar nuevos elementos en CHK016)
- Nunca eliminar o reemplazar el contenido existente de la lista de verificación; siempre preservar y agregar
- Dejar cada elemento recién generado sin marcar (
[ ]); el estado de la casilla pertenece al revisor
PRINCIPIO FUNDAMENTAL - Probar los Requisitos, No la Implementación: Cada elemento de la lista de verificación DEBE evaluar los REQUISITOS EN SÍ MISMOS para:
- Completitud: ¿Están presentes todos los requisitos necesarios?
- Claridad: ¿Son inequívocos y específicos los requisitos?
- Consistencia: ¿Se alinean los requisitos entre sí?
- Capacidad de Medición: ¿Se pueden verificar objetivamente los requisitos?
- Cobertura: ¿Se abordan todos los escenarios/casos límite?
Estructura de Categorías - Agrupar elementos por dimensiones de calidad de requisitos:
- Completitud de Requisitos (¿Están documentados todos los requisitos necesarios?)
- Claridad de Requisitos (¿Son los requisitos específicos e inequívocos?)
- Consistencia de Requisitos (¿Se alinean los requisitos sin conflictos?)
- Calidad de los Criterios de Aceptación (¿Son medibles los criterios de éxito?)
- Cobertura de Escenarios (¿Se abordan todos los flujos/casos?)
- Cobertura de Casos Límite (¿Están definidas las condiciones límite?)
- Requisitos No Funcionales (Rendimiento, Seguridad, Accesibilidad, etc. - ¿están especificados?)
- Dependencias y Suposiciones (¿Están documentadas y validadas?)
- Ambigüedades y Conflictos (¿Qué necesita aclaración?)
CÓMO ESCRIBIR ELEMENTOS DE LA LISTA DE VERIFICACIÓN - "Pruebas Unitarias para Inglés":
❌ INCORRECTO (Probar la implementación):
- "Verificar que la página de inicio muestre 3 tarjetas de episodios"
- "Probar que los estados hover funcionen en escritorio"
- "Confirmar que el clic en el logo navegue a inicio"
✅ CORRECTO (Probar la calidad de los requisitos):
- "¿Están especificados el número exacto y la disposición de los episodios destacados?" [Completitud]
- "¿Está cuantificado 'visualización prominente' con tamaño/posicionamiento específico?" [Claridad]
- "¿Son consistentes los requisitos de estado hover en todos los elementos interactivos?" [Consistencia]
- "¿Están definidos los requisitos de navegación por teclado para toda la UI interactiva?" [Cobertura]
- "¿Está especificado el comportamiento de respaldo cuando la imagen del logo falla al cargar?" [Casos Límite]
- "¿Están definidos los estados de carga para datos de episodios asíncronos?" [Completitud]
- "¿Define la especificación la jerarquía visual para elementos de UI en competencia?" [Claridad]
ESTRUCTURA DEL ELEMENTO: Cada elemento debe seguir este patrón:
- Formato de pregunta sobre la calidad del requisito
- Enfoque en lo que está ESCRITO (o no escrito) en la especificación/plan
- Incluir la dimensión de calidad entre corchetes [Completitud/Claridad/Consistencia/etc.]
- Referenciar la sección de la especificación
[Spec §X.Y]al verificar requisitos existentes - Usar el marcador
[Brecha]al verificar requisitos faltantes
EJEMPLOS POR DIMENSIÓN DE CALIDAD:
Completitud:
- "¿Están definidos los requisitos de manejo de errores para todos los modos de fallo de la API? [Brecha]"
- "¿Están especificados los requisitos de accesibilidad para todos los elementos interactivos? [Completitud]"
- "¿Están definidos los requisitos de punto de interrupción móvil para diseños responsivos? [Brecha]"
Claridad:
- "¿Está cuantificada la 'carga rápida' con umbrales de tiempo específicos? [Claridad, Spec §NFR-2]"
- "¿Están definidos explícitamente los criterios de selección de 'episodios relacionados'? [Claridad, Spec §FR-5]"
- "¿Está definido 'prominente' con propiedades visuales medibles? [Ambigüedad, Spec §FR-4]"
Consistencia:
- "¿Se alinean los requisitos de navegación en todas las páginas? [Consistencia, Spec §FR-10]"
- "¿Son consistentes los requisitos del componente de tarjeta entre las páginas de inicio y detalle? [Consistencia]"
Cobertura:
- "¿Están definidos los requisitos para escenarios de estado cero (sin episodios)? [Cobertura, Caso Límite]"
- "¿Se abordan escenarios de interacción de usuario concurrente? [Cobertura, Brecha]"
- "¿Están especificados los requisitos para fallos de carga de datos parciales? [Cobertura, Flujo de Excepción]"
Capacidad de Medición:
- "¿Son medibles/comprobables los requisitos de jerarquía visual? [Criterios de Aceptación, Spec §FR-1]"
- "¿Se puede verificar objetivamente el 'peso visual equilibrado'? [Capacidad de Medición, Spec §FR-2]"
Clasificación y Cobertura de Escenarios (Enfoque en la Calidad de los Requisitos):
- Verificar si existen requisitos para: Escenarios Primarios, Alternativos, de Excepción/Error, de Recuperación y No Funcionales
- Para cada clase de escenario, preguntar: "¿Son los requisitos de [tipo de escenario] completos, claros y consistentes?"
- Si falta una clase de escenario: "¿Están los requisitos de [tipo de escenario] excluidos intencionalmente o faltantes? [Brecha]"
- Incluir resiliencia/reversión cuando ocurra mutación de estado: "¿Están definidos los requisitos de reversión para fallos de migración? [Brecha]"
Requisitos de Trazabilidad:
- MÍNIMO: ≥80% de los elementos DEBEN incluir al menos una referencia de trazabilidad
- Cada elemento debe referenciar: sección de la especificación
[Spec §X.Y], o usar marcadores:[Brecha],[Ambigüedad],[Conflicto],[Suposición] - Si no existe un sistema de ID: "¿Se ha establecido un esquema de ID de requisitos y criterios de aceptación? [Trazabilidad]"
Superficie y Resolución de Problemas (Problemas de Calidad de los Requisitos): Hacer preguntas sobre los propios requisitos:
- Ambigüedades: "¿Está el término 'rápido' cuantificado con métricas específicas? [Ambigüedad, Spec §NFR-1]"
- Conflictos: "¿Entran en conflicto los requisitos de navegación entre §FR-10 y §FR-10a? [Conflicto]"
- Suposiciones: "¿Está validada la suposición de 'API de podcast siempre disponible'? [Suposición]"
- Dependencias: ...
- Crear el directorio
[...truncado para traducción...]