Exportación de casos de prueba
Estas tres skills llevan los escenarios de un plan de pruebas a la herramienta de gestión de tests
del proyecto. El flujo arranca de un plan en Markdown (el que genera lippia-neo-create-test-plan):
lippia-neo-meta-normalize-test-cases lo pasa a un formato de test case agnóstico de herramienta y lo
guarda como JSON junto al plan; lippia-neo-meta-export-test-cases toma ese resultado y lo despacha a la
subskill de la herramienta declarada en test_management.tool de qa-stack.yaml. Hoy la única
subskill disponible es la de Xray Cloud (lippia-neo-export-test-cases-xray); la de QMetry
(lippia-neo-export-test-cases-qmetry) está pendiente: el router ya la reconoce, pero mientras
no esté instalada el export a QMetry devuelve blocked. Ninguna escritura en la herramienta ocurre
sin confirmación humana.
plan de pruebas (.md)
↓ lippia-neo-meta-normalize-test-cases → <us_id>-test-cases.json
↓ lippia-neo-meta-export-test-cases → lee test_management.tool de qa-stack.yaml
↓ lippia-neo-export-test-cases-xray (xray) · lippia-neo-export-test-cases-qmetry (qmetry, pendiente)
lippia-neo-meta-normalize-test-cases
Cuándo usarla
Cuando ya tenés un plan de pruebas en Markdown y querés llevar sus escenarios a un formato
estructurado e independiente de la herramienta, listo para importar a Xray, Zephyr Scale,
TestRail, qTest o Azure Test Plans. No parsea el Markdown por su cuenta: delega la lectura en
lippia-neo-read-test-plan y normaliza cada escenario 1:1, copiando textos, pasos, prioridad y
tipo tal cual vienen en el plan (nunca los inventa ni los mapea a un vocabulario fijo). La
única transformación es mover a preconditions un primer paso sin resultado esperado verificable
(—, -, N/A). No exporta nada ni conoce el schema de ninguna herramienta.
{
"input": {
"test_plan_path": "test-plans/LTM-21-test-plan.md"
}
}
| Input | Tipo | Descripción |
|---|---|---|
input.test_plan_path |
Requerido | Ruta (relativa a la raíz del repositorio de pruebas) al plan en Markdown. Se reenvía a lippia-neo-read-test-plan y define dónde se guarda el JSON de salida. |
Salida
| Campo | Descripción |
|---|---|
status |
normalized / failed. Falla si no hay ruta, la lectura del plan falla, no se resuelve el identificador de la historia, no hay escenarios normalizables o hay ids duplicados; en ese caso no se guarda nada y el motivo es el primer warning. |
us_id |
Identificador de la historia que resolvió la lectura del plan (ej. LTM-21), o null. |
test_cases |
Un test case por escenario: id (el del plan, sin renumerar), title, user_story (id + acceptance_criteria), priority, type, preconditions, steps (step, action, expected_result, test_data), test_data y tags ([us_id, ...CA]). |
unparsed |
Escenarios que no se pudieron normalizar sin ambigüedad (sin pasos, paso sin acción o sin resultado esperado), cada uno con id y reason. No frenan al resto. |
json_path |
Archivo generado, <directorio del plan>/<us_id>-test-cases.json (avisa antes de sobreescribir si ya existe); null si falló. |
warnings |
Prioridad/tipo/datos no especificados, más los warnings de la lectura con prefijo [read-test-plan] (incluye literales que parecen URL o credencial dentro del plan). |
Se encadena con
Se ejecuta sobre el plan que genera lippia-neo-create-test-plan (ver planificación)
y usa internamente lippia-neo-read-test-plan. Normalmente no la invocás vos: la llama
lippia-neo-meta-export-test-cases como su primer paso, aunque también podés ejecutarla sola para
revisar el JSON antes de exportar.
lippia-neo-meta-export-test-cases
Cuándo usarla
Es el punto de entrada para exportar los test cases de un plan a la herramienta de gestión del
proyecto, o para previsualizar qué se crearía sin escribir nada. Le pasás solo la ruta al plan:
resuelve la herramienta desde test_management.tool de qa-stack.yaml (nunca la infiere del
contexto), pasa el plan por lippia-neo-meta-normalize-test-cases y le entrega los test cases, sin
tocarlos, a la subskill de esa herramienta. Es un router: no mapea campos, no llama APIs, no
maneja credenciales y no responde la confirmación humana de la subskill. Si no hay herramienta
configurada, el valor no está soportado o la subskill no está instalada, devuelve blocked
antes de normalizar.
{
"input": {
"test_plan_path": "test-plans/LTM-21-test-plan.md",
"mode": "preview"
}
}
| Input | Tipo | Descripción |
|---|---|---|
input.test_plan_path |
Requerido | Ruta al plan de pruebas en Markdown. Se reenvía al normalizador y a la subskill destino. |
input.mode |
Opcional | dry-run / preview / export, reenviado tal cual. Si falta, rige el default de la subskill (export, con su confirmación). |
input.approval_decision |
Opcional | "approved" / "rejected": confirmación humana ya tomada, para ejecuciones no interactivas. Se reenvía tal cual; nunca se infiere. |
input.tool_overrides |
Opcional | Overrides puntuales del bloque test_management.<tool> de qa-stack.yaml; se reenvían como input.<tool> (ej. input.xray). |
Valores soportados de test_management.tool: xray (→ lippia-neo-export-test-cases-xray) y
qmetry (→ lippia-neo-export-test-cases-qmetry, pendiente: hoy devuelve blocked por skill
no instalada). Las credenciales no pasan por esta skill: cada subskill las toma de su propio entorno.
Salida
| Campo | Descripción |
|---|---|
status |
blocked (sin qa-stack.yaml, sin herramienta, herramienta no soportada o subskill no instalada) / failed (sin ruta, normalización fallida o sin test cases) / o el status de la subskill tal cual: exported, partial, preview, dry_run, pending_approval, rejected. |
routing |
{ tool, skill, available }: herramienta leída, subskill resuelta y si está instalada. |
us_id |
Identificador de la historia que resolvió el normalizador, o null. |
test_plan_path |
La ruta recibida. |
normalization |
{ status, json_path, test_cases_count, unparsed }; null si frenó antes de normalizar. |
export |
Salida de la subskill, sin modificar; null si no se llegó a invocarla. |
summary |
Una línea con herramienta, status y totales (o el motivo del bloqueo/falla). |
warnings |
Los del router, los del normalizador ([normalize]) y los de la subskill ([export:<tool>]), incluidas diferencias de conteo entre normalizados y exportados. |
Se encadena con
Recibe el plan de lippia-neo-create-test-plan (ver planificación), invoca
lippia-neo-meta-normalize-test-cases y despacha a lippia-neo-export-test-cases-xray. El bloque
test_management de qa-stack.yaml lo puede generar lippia-neo-bootstrap-stack (ver
configuración e infraestructura).
lippia-neo-export-test-cases-xray
Subskill de lippia-neo-meta-export-test-cases
No hace falta invocarla directamente: invocás lippia-neo-meta-export-test-cases y esta subskill se elige sola cuando test_management.tool de qa-stack.yaml es xray.
Cuándo usarla
Cuando test_management.tool del proyecto es xray y hay que crear en Xray Cloud los Tests
de una historia a partir de test cases ya normalizados, o previsualizar qué se crearía y qué ya
estaba exportado. Crea un Test Manual por test case (bulk import), con summary
<user_story.id> · <tc_id> — <title> y el label único lippia-neo-test; opcionalmente los
vincula al issue de Jira de la historia y los asocia a un Test Plan / Test Set. El mapeo lo hace
un script determinístico (scripts/xray-export.mjs, requiere Node ≥ 20), siempre en el
orden dry-run → preview → confirmación → export. Solo Xray Cloud: si la instancia es
Server/Data Center, aborta.
{
"input": {
"test_cases": [
{
"id": "TC-01",
"title": "Login exitoso con credenciales válidas",
"user_story": { "id": "US-001", "acceptance_criteria": ["CA-01"] },
"priority": "Alta",
"type": "Positivo",
"preconditions": "",
"steps": [
{ "step": 1, "action": "Navegar a /login", "expected_result": "Página de login visible", "test_data": null }
],
"test_data": null,
"tags": ["US-001", "CA-01"]
}
],
"requirement_key": "KAN-4",
"test_plan_path": "test-plans/US-001-test-plan.md",
"mode": "preview"
}
}
| Input | Tipo | Descripción |
|---|---|---|
input.test_cases |
Requerido | Array de test cases normalizados (salida de lippia-neo-meta-normalize-test-cases), que pasa al script sin tocar. Si llega el objeto completo del normalizador, toma solo test_cases. |
input.requirement_key |
Opcional | Clave del issue de Jira de la historia (ej. KAN-4). Solo explícita: si falta, los Tests no se vinculan (nunca se deduce del us_id ni del plan). Vincula todos los Tests a ese issue, así que solo se admite si todos los test cases son de la misma historia. |
input.test_plan_path |
Opcional | Ruta al plan de origen; solo trazabilidad (va a la descripción del Test). |
input.mode |
Opcional | dry-run (valida sin red y devuelve el payload) / preview (solo lectura contra Xray) / export (default, con confirmación). |
input.approval_decision |
Opcional | "approved" / "rejected" para ejecuciones no interactivas. Sin un valor válido, devuelve pending_approval. |
input.xray |
Opcional | Overrides puntuales del bloque test_management.xray de qa-stack.yaml. |
Configuración en qa-stack.yaml (test_management.xray): project_key es obligatorio;
opcionales jira_base_url (para armar links), requirement_link_type (default Test), test_plan
({ key }, { create: true, summary } o null), test_set_key, folder y on_existing (skip
por default; create genera duplicados). Sin test_plan ni test_set_key no se crea ni se toca
ningún Test Plan o Test Set.
Credenciales
XRAY_CLIENT_ID y XRAY_CLIENT_SECRET (obligatorias para preview y export), y opcional
XRAY_BASE_URL para instancias con data residency. Se generan en Jira (Apps → Xray → Settings →
API Keys) y van solo en el archivo de paths.env_file del proyecto (gitignored), nunca en
qa-stack.yaml, en el chat ni en el request. Si faltan, la skill aborta indicando cómo
configurarlas.
Salida
| Campo | Descripción |
|---|---|
status |
exported / partial (algunos creados, otros no) / preview / dry_run / pending_approval / rejected / failed. |
mode |
Modo en que ejecutó: dry-run, preview o export. |
project_key / requirement_key |
Proyecto de Jira donde viven los Tests y el issue vinculado (o null). |
totals |
{ received, to_create, skipped_existing, created, failed }. |
created |
Tests creados: tc_id, user_story_id, key, issue_id y url (si hay jira_base_url). |
skipped |
Test cases ya exportados (mismo label + <us_id> · <tc_id> en el summary), que no se duplicaron, con su reason. |
errors |
Test cases que Xray rechazó, con el detalle de la API. |
test_plan / test_set |
Asociación realizada (key, action, added), o null. |
payload |
Solo en dry-run / preview: el JSON exacto que se enviaría a Xray. |
summary / warnings |
Resumen del resultado y avisos del script y de la skill. |
Limitaciones: un re-export no actualiza Tests existentes (los saltea), solo se generan Tests
Manuales (no Cucumber ni Generic) y no exporta resultados de ejecución. No edites a mano el summary
de un Test ya exportado: si pierde <us_id> · <tc_id> (o el label), el próximo export lo vuelve a
crear.
Se encadena con
La invoca lippia-neo-meta-export-test-cases cuando test_management.tool: xray, pasándole los
test_cases de lippia-neo-meta-normalize-test-cases. También podés invocarla directamente con un
JSON ya normalizado; es la única vía para pasar input.requirement_key, porque el router no
envía esa clave.