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