Saltar a contenido

Búsqueda de cobertura existente

Estas tres skills evitan trabajo redundante: antes de reproducir un bug, reparar un selector o generar tests nuevos, averiguan qué ya está cubierto por tests existentes y qué escenarios quedan sin cubrir. Son de solo lectura y razonamiento — ninguna crea, modifica ni borra archivos, ni ejecuta nada contra la aplicación.


lippia-neo-find-existing-tests

Cuándo usarla

Justo después de lippia-neo-read-user-story o lippia-neo-read-bug-report, dentro de un ciclo de bug, para buscar en el directorio de tests cobertura existente del criterio de aceptación o feature relacionado — antes de reproducir el bug o generar nada nuevo. Modela la búsqueda en capas (identidad fuerte / semántica controlada), con una fuerza de evidencia por match (strong/partial). Nunca aborta el ciclo aunque no encuentre nada.

Ejemplo de invocación
{
  "input": {
    "source_summary": {
      "us_id": "PA-US-02"
    }
  },
  "config": {
    "tests_dir": "tests/",
    "test_framework": "playwright"
  }
}
Input Tipo Descripción
input.source_summary Requerido Output de lippia-neo-read-user-story o de lippia-neo-read-bug-report. Un ciclo de bug no trae acceptance_criteria/key_features.
config.tests_dir Requerido Directorio donde buscar los tests existentes.
config.test_framework Requerido Define qué globs y elementos inspeccionar (playwright/lippia/pytest). Con cypress todavía no busca: devuelve not_found con un aviso.
input.issue_body Opcional Texto crudo del bug, con el mismo criterio de alineación que steps_to_reproduce/expected_result/actual_result.
input.related_us_summary Opcional Si source_summary.related_user_story es no-nulo y ya se resolvió con lippia-neo-read-user-story; si no viene, la búsqueda se degrada (queda registrado en warnings).

Salida

Campo Descripción
status found / not_found.
existing_tests Matches confirmados (path, suite_type fe/be, matched_on, matched_location, match_strength strong/partial, match_mode exact/normalized, y test_case_id solo si el archivo lo declara); los matches débiles nunca entran acá.
search_terms Todos los términos usados, con term, source, priority y match_mode, aunque existing_tests quede vacío (trazabilidad).
warnings Degradaciones (bug sin historia, related_user_story sin resolver), fallback de Pytest, matches débiles descartados, directorio de tests inexistente, etc.
Se encadena con

Se ejecuta después de lippia-neo-read-user-story/lippia-neo-read-bug-report; su existing_tests alimenta a lippia-neo-generate-test-suite como referencia de estilo, y a lippia-neo-review-test-coverage para determinar qué queda sin cubrir (plan qa-bug-coverage). En el plan qa-bug-fix-verification se usa como config.target_tests de lippia-neo-run-and-heal, para ejecutar solo esos tests.


lippia-neo-find-ui-tests-by-code-diff

Cuándo usarla

Para saber qué tests existentes coinciden con la parte de la app que cambió un diff de git (git diff en formato unified diff de un PR contra la rama destino) — típicamente como paso 1 del flujo de reparación de selectores, antes de decidir si hay que reparar algo. A diferencia de lippia-neo-find-existing-tests (que parte de una historia de usuario), deriva sus términos de búsqueda del propio diff: archivos tocados, selectores agregados/removidos/cambiados, rutas y clases CSS. Un match no significa "test roto", solo que el alcance del test se solapa con lo que cambió — no repara ni ejecuta nada.

Ejemplo de invocación
{
  "input": {
    "pr_diff_path": "tmp/pr-1234.diff"
  },
  "config": {
    "tests_dir": "tests/",
    "test_framework": "playwright"
  }
}
Input Tipo Descripción
input.pr_diff_path Requerido Ruta a un archivo con la salida de git diff del PR vs. la rama destino; fuente primaria de los términos de búsqueda.
config.tests_dir Requerido Directorio donde buscar tests.
config.test_framework Requerido Define los globs y elementos a inspeccionar (playwright/lippia/pytest). Con cypress todavía no busca: devuelve not_found con un aviso.

Salida

Campo Descripción
status found / not_found.
has_matches Booleano equivalente a status == found, pensado para un gate de plan.
matched_tests Un objeto por archivo (path, suite_type siempre fe, test_case_id si el archivo lo declara), con matched_on agrupando TODOS los términos que matchearon en ese archivo (nunca solo el más representativo); cada término trae term, matched_location, match_strength strong/partial y match_mode.
search_terms Términos derivados del diff (changed_file, selector, route, css_class, text_content), con priority y match_mode (exact/normalized/template_regex; este último es un patrón para textos con partes dinámicas).
warnings Diff vacío/inexistente, fallback de Pytest, términos de alta prioridad sin match confirmado, texto 100% interpolado sin patrón derivable, etc.
Se encadena con

Paso 1 del plan ui-selector-repair; su matched_tests es el input obligatorio de lippia-neo-repair-selectors-by-diff, que solo repara lo que aparece en esa lista y solo se ejecuta si has_matches es true.


lippia-neo-review-test-coverage

Cuándo usarla

Para determinar qué escenarios explícitos de una historia de usuario o un bug quedan sin cobertura, a partir de una lista de matches ya resueltos (típicamente el output de lippia-neo-find-existing-tests) y de los criterios de aceptación / funcionalidades clave declarados. Es puro razonamiento sobre datos ya recibidos: no busca en ningún directorio de tests ni lee archivos.

Ejemplo de invocación
{
  "input": {
    "source_summary": {
      "us_id": "PA-US-02"
    },
    "existing_tests": [
      { "path": "tests/checkout.spec.ts", "match_strength": "strong" }
    ]
  }
}
Input Tipo Descripción
input.source_summary Requerido Mismo contrato que en lippia-neo-find-existing-tests (historia o bug); un bug sin historia asociada no trae AC/key_features.
input.existing_tests Requerido Array de matches ya resueltos; solo cuentan los matches strong o partial.
input.related_us_summary Opcional AC/key_features/identifier de la historia asociada, si source_summary.related_user_story es no-nulo y ya fue resuelta antes de invocar esta skill.

Salida

Campo Descripción
needs_expansion true si algún escenario explícito queda sin cobertura strong/partial, o si existing_tests vino vacío.
missing_cases Escenarios sin cubrir, cada uno con description (tal como lo describe la historia, sin reformular) y rationale (la frase exacta del AC, key feature o bug que lo respalda). En un bug sin historia asociada, el único escenario evaluado es el propio bug.
warnings Por ejemplo, related_user_story declarada pero no resuelta.
Se encadena con

Consume el existing_tests de lippia-neo-find-existing-tests (plan qa-bug-coverage); su missing_cases alimenta a lippia-neo-generate-test-suite, que entra en modo "ampliación de casuística" cuando ese campo está presente.