Saltar a contenido

Lectura e ingesta de historias y bugs

Estas seis skills son el punto de entrada de casi cualquier flujo de QA: normalizan una historia de usuario o un bug reportado — venga de un archivo local, de Jira o de Azure DevOps — en una estructura de datos común que el resto de las skills puede consumir sin preguntarse de dónde salió. La sexta, lippia-neo-read-test-plan, hace lo mismo con un plan de pruebas ya escrito en disco.

Ninguna escribe en disco cuando la fuente es remota

El contenido traído de Jira/Azure DevOps se mantiene siempre en memoria, nunca se persiste en el directorio local de historias.


lippia-neo-read-user-story

Cuándo usarla

Al iniciar un flujo de QA sobre una historia de usuario. Recibe una referencia — un path local a un .md o la URL de un ticket (Jira / Azure DevOps) — la resuelve automáticamente y extrae el resumen, los criterios de aceptación, la URL de la app, las credenciales de prueba y las funcionalidades clave a probar. Es el punto de entrada estándar de cualquier flujo basado en historias (el análogo de lippia-neo-read-bug-report para bugs).

Ejemplo de invocación
{
  "input": {
    "user_story": "user-stories/PA-US-02.md"
  }
}
Input Tipo Descripción
input.user_story Requerido Path local a un .md o URL de un ticket remoto; nunca se hardcodea. Un path se lee siempre del disco (probando también relativo a paths.user_stories_storage.local_path); una URL solo se procesa si su proveedor coincide con paths.user_stories_storage.cloud_provider_mcp de qa-stack.yaml y su host con la instancia configurada en .mcp.json — si no, la skill se detiene.
input.user_story_ref Opcional Alias explícito de la referencia, si no se usa input.user_story.
input.identifier Opcional Identificador ya resuelto por quien la invoca; tiene prioridad sobre el us_id derivado de la historia.
input.jira_content / input.jira_source_url Opcional Contenido ya traído por lippia-neo-fetch-jira-user-story (típico de un plan M2/M4 que ya resolvió la fuente); si viene, tiene prioridad sobre input.user_story.
input.azure_content / input.azure_source_url Opcional Mismo criterio, para contenido ya traído de Azure DevOps.

Salida

Campo Descripción
us_id / identifier Identificador corto de la historia, y su alias normalizado.
summary Resumen de la historia.
acceptance_criteria Lista de criterios de aceptación.
app_urls URL(s) de la app bajo prueba.
credentials Credenciales de prueba referenciadas.
key_features Funcionalidades clave a probar.
source_kind local_path | jira | azure-devops.
user_story_path / source_url Ruta local o URL del ticket de origen, según source_kind.
can_continue true si hubo contexto suficiente para resumir con confianza; null si no (nunca false).
Se encadena con

Primer paso de cualquier flujo basado en historia (lippia-neo-workflow-e2e, planes M2/M4). Para URLs remotas, despacha a lippia-neo-fetch-jira-user-story / lippia-neo-fetch-azure-user-story. Sigue con lippia-neo-create-test-plan → lippia-neo-scripted-execution → lippia-neo-generate-test-suite → lippia-neo-run-and-heal → lippia-neo-write-test-report.


lippia-neo-fetch-jira-user-story

Subskill de lippia-neo-read-user-story

No hace falta invocarla directamente: invocás lippia-neo-read-user-story y esta subskill se elige sola cuando le pasás la URL o la clave de un issue de Jira.

Cuándo usarla

Cuando el trabajo de QA debe arrancar desde un issue de Jira Cloud en vez de un archivo .md local. Trae el issue vía el MCP de Atlassian y, si enlaza páginas de Confluence, las trae también y enriquece el contenido con esa spec (objetivo, contexto, criterios de aceptación, info técnica). Devuelve todo estructurado en memoria, listo para que lippia-neo-read-user-story (o lippia-neo-workflow-e2e) lo consuma directo. Acepta clave desnuda (TS-42), URL de Jira, o el argumento del slash command.

Ejemplo de invocación
{
  "input": {
    "jira_issue_ref": "https://tu-sitio.atlassian.net/browse/TS-42"
  }
}
Input Tipo Descripción
input.jira_issue_ref Requerido Clave o URL del issue; la skill extrae la clave canónica.
input.jira_issue_key Opcional Alias explícito, si ya se tiene la clave desnuda (ej. TS-42).

Salida

Campo Descripción
jira_issue_key Clave del issue, para trazabilidad.
content Contenido completo en formato canónico, en memoria, listo para lippia-neo-read-user-story.
source_url URL canónica del issue.
title / issue_type / status Summary, tipo (Story/Bug/Task/…) y estado del issue.
ac_source De dónde salieron los criterios de aceptación (custom_field | description | confluence | none).
confluence_pages Páginas de Confluence traídas (page_id, title, url).
summary Resumen legible de la operación.
warnings Advertencias (ej. descripción vacía, Confluence MCP no disponible).
Se encadena con

Se ejecuta antes de lippia-neo-read-user-story (paso 1 de lippia-neo-workflow-e2e). Nunca escribe en el directorio local de historias. En qa-stack.yaml podés ajustar jira.acceptance_criteria_field (custom field donde viven los AC) y jira.follow_confluence_links (default true; en false no sigue los links a Confluence).


lippia-neo-fetch-azure-user-story

Subskill de lippia-neo-read-user-story

No hace falta invocarla directamente: invocás lippia-neo-read-user-story y esta subskill se elige sola cuando le pasás la URL o el ID de un work item de Azure DevOps.

Cuándo usarla

El análogo de lippia-neo-fetch-jira-user-story para Azure DevOps: trae un work item de Azure Boards vía el MCP azure-devops y lo devuelve estructurado en memoria. Acepta ID desnudo (1234), URL de Azure Boards, o argumento de slash command. A diferencia de la de Jira, hace una traducción fiel estricta — no reordena, no reestructura ni agrega secciones que el work item no tiene.

Ejemplo de invocación
{
  "input": {
    "work_item_ref": "https://dev.azure.com/tu-org/tu-proyecto/_workitems/edit/1234"
  }
}
Input Tipo Descripción
input.work_item_ref Requerido ID o URL del work item; la skill extrae el ID canónico.
input.work_item_id Opcional Alias explícito, si ya se tiene el ID desnudo.
input.project Opcional Override del Team Project; si no viene, usa azure_devops.default_project de qa-stack.yaml y, en su defecto, AZURE_DEVOPS_DEFAULT_PROJECT de .mcp.json.

Salida

Campo Descripción
work_item_id ID del work item, para trazabilidad.
content Contenido completo en formato canónico, en memoria, listo para lippia-neo-read-user-story.
source_url URL canónica del work item.
title / work_item_type / state Título, tipo (User Story/Bug/Task/Feature) y estado.
ac_source custom_field | description | none.
summary Resumen legible de la operación.
warnings Advertencias.
Se encadena con

Se ejecuta antes de lippia-neo-read-user-story, como su "gemela" para Azure DevOps. Nunca toca el directorio local de historias. Los AC salen de azure_devops.acceptance_criteria_field de qa-stack.yaml (default Microsoft.VSTS.Common.AcceptanceCriteria; en null los busca en la descripción).


lippia-neo-read-bug-report

Cuándo usarla

Al iniciar trabajo de QA sobre un bug reportado (no una historia de usuario). Acepta, a través de un único campo, tres formas detectadas automáticamente por su contenido: path local a un .md, URL de ticket (Jira/Azure DevOps), o texto crudo ya disponible (por ejemplo, inyectado por el dispatcher M2). Extrae pasos de reproducción, resultado esperado vs. obtenido, severidad, entorno y cualquier criterio de aceptación/historia referenciada.

Ejemplo de invocación
{
  "input": {
    "bug_report": "El botón 'Aplicar cupón' no muestra el descuento al confirmar un cupón válido en el carrito."
  }
}
Input Tipo Descripción
input.bug_report Requerido Path local, URL de ticket remoto, o texto crudo del bug; la forma se detecta automáticamente por el contenido. No hay una clave propia para bugs en qa-stack.yaml: un path relativo se busca también bajo paths.user_stories_storage.local_path; si guardás los bugs en otra carpeta, pasá el path completo.
input.identifier Opcional Identificador ya resuelto por quien la invoca; tiene prioridad sobre el bug_id derivado del ticket.
input.credentials Opcional Credenciales de prueba ya resueltas por quien la invoca; tienen prioridad sobre lo que la skill encuentre mencionado en el reporte.

Salida

Campo Descripción
bug_id / identifier Identificador corto del bug, y su alias normalizado.
title Título del bug.
steps_to_reproduce / expected_result / actual_result Texto literal del reporte, nunca inventado.
severity Tal como esté clasificada; vacía si no está.
environment URL/browser/versión mencionados.
related_user_story Referencia a la historia/feature relacionada, o null (no se resuelve acá).
app_urls / credentials URL(s) de la app y credenciales de prueba referenciadas.
source_kind local_path | jira | azure-devops | raw_text.
bug_report_path / source_url Ruta local o URL del ticket, según source_kind.
can_continue true si hubo contenido suficiente para caracterizar el bug; null si no (nunca false).
Se encadena con

Punto de entrada de bugs, análogo a lippia-neo-read-user-story. Para URLs despacha a lippia-neo-fetch-jira-user-story / lippia-neo-fetch-azure-user-story. Sigue con lippia-neo-find-existing-tests → lippia-neo-bug-reproduction → lippia-neo-generate-test-suite → ....


lippia-neo-resolve-user-story-source

Cuándo usarla

Cuando un plan u orquestador (M2/M4) necesita decidir dónde leer una referencia de historia de usuario — path local o ticket remoto — antes de decidir si ejecuta una skill de fetch. Es una decisión de ruteo pura: solo clasifica y valida una URL contra la configuración del proyecto; nunca lee un archivo, nunca toca Jira/Azure, nunca fetchea nada. Si la URL no corresponde al proveedor (paths.user_stories_storage.cloud_provider_mcp) ni a la instancia configurada en .mcp.json, se detiene con el motivo en vez de clasificarla.

Ejemplo de invocación
{
  "input": {
    "user_story": "https://tu-sitio.atlassian.net/browse/TS-42"
  }
}
Input Tipo Descripción
input.user_story Requerido Path local a un .md o URL de un ticket remoto.
input.user_story_ref Opcional Alias explícito de la referencia, si no se usa input.user_story.

Salida

Campo Descripción
kind local_path | jira | azure-devops: a dónde hay que ir a buscar el contenido.
fetch_url_jira La URL tal cual, solo si kind == jira (se pasa a input.jira_issue_ref del fetch de Jira); null en otro caso.
fetch_url_azure_devops La URL tal cual, solo si kind == azure-devops (se pasa a input.work_item_ref del fetch de Azure); null en otro caso.
reason Una línea explicando la clasificación (para logs/debug).
Se encadena con

Primer eslabón de la cadena de resolución de historias en planes M4; según kind, dispara lippia-neo-fetch-jira-user-story o lippia-neo-fetch-azure-user-story, y siempre continúa con lippia-neo-read-user-story → lippia-neo-create-test-plan → ....


lippia-neo-read-test-plan

Cuándo usarla

Cuando una skill o un plan necesita la información de un plan de pruebas en Markdown ya estructurada como datos, en vez de parsear el .md por su cuenta. Lee el plan desde su path local (típicamente test-plans/<US-ID>-test-plan.md, generado por lippia-neo-create-test-plan) y extrae todo: encabezado, alcance, cobertura de criterios de aceptación, datos de prueba, precondiciones, escenarios completos con sus pasos y preguntas abiertas. Es de solo lectura y literal: no persiste nada, no corrige ni completa escenarios, y no se conecta a herramientas externas — si le pasás una URL, falla.

Ejemplo de invocación
{
  "input": {
    "test_plan_path": "test-plans/LTM-21-test-plan.md"
  }
}
Input Tipo Descripción
input.test_plan_path Requerido Path (absoluto o relativo) al plan en Markdown; si no lo encuentra tal cual, lo busca relativo a la raíz del repo y a paths.test_plans_dir de qa-stack.yaml (default test-plans/). Solo paths locales.

Salida

Campo Descripción
status read si se leyó el plan con al menos un escenario; failed si no hubo referencia, era una URL, el archivo no existe/está vacío o no tiene escenarios (el motivo va como primer warning).
test_plan_path Ruta efectivamente leída.
us_id / identifier Identificador de la historia, tomado del nombre del archivo o del H1 del plan, y su alias normalizado.
header Encabezado del plan: título, historia, URL de la app, credenciales, stack, fuente de los escenarios y otras etiquetas (extra).
scope Alcance incluido / fuera de alcance, o null si el plan no lo trae.
acceptance_criteria_coverage Matriz de cobertura: por cada criterio (id, title), los escenarios que lo cubren.
test_data / general_preconditions Datos de prueba generales (tablas y notas) y precondiciones generales.
scenarios Escenarios completos: id, title, acceptance_criteria, type, priority, preconditions, steps (acción + resultado esperado por paso), test_data, etc.
open_questions Preguntas abiertas y riesgos del plan.
other_sections / missing_sections Secciones que no mapean a ningún campo (nunca se pierden) y secciones esperadas que el plan no tiene.
warnings Inconsistencias detectadas (matriz vs. escenarios, pasos sin resultado esperado, posibles credenciales literales, etc.); se señalan, nunca se corrigen.
Se encadena con

Se ejecuta después de lippia-neo-create-test-plan, sobre el plan que esa skill dejó en disco. Hoy la consume lippia-neo-normalize-test-cases (y, a través de ella, lippia-neo-export-test-cases). Quien la consuma debe chequear status antes de usar el resultado.