Saltar a contenido

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.

Ejemplo de invocación
{
  "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.

Ejemplo de invocación
{
  "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.

Ejemplo de invocación
{
  "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.