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.
{
"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.
{
"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.
{
"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.