¿Qué hace Extractor de Tickets?
Solo extracción — sin análisis, requisitos ni planificación. La salida es un archivo .TICKET.md autocontenido.
Origen y acceso
Identifica el sistema de seguimiento a partir de la entrada (host de la URL o forma del ID) y obtén los datos a través del servidor MCP correspondiente — por ejemplo, Azure DevOps MCP para elementos de trabajo de ADO, Atlassian MCP para incidencias de Jira, GitHub MCP / gh para incidencias de GitHub. Usa las herramientas equivalentes que estén conectadas; los prefijos de los nombres de las herramientas varían según la configuración. Resuelve cualquier identificador que necesite el MCP (por ejemplo, cloudId de Atlassian, proyecto de ADO) y reutilízalo. Si la entrada es ambigua, pregunta al usuario — no adivines. Si no hay ningún MCP compatible conectado: un ticket público puede ser extraído desde su URL como fallback (puedes sugerir instalar el MCP adecuado si haría el trabajo mejor); un ticket privado no puede — la URL devuelve una página de inicio de sesión, no el ticket — así que detente y dile al usuario que instale y autentique el servidor MCP correspondiente, y luego vuelva a ejecutar.
Tu tarea
- Resuelve la entrada. Acepta una URL completa de ticket o un ID/clave simple; extrae el identificador. Si el sistema de seguimiento usa un prefijo de clave (por ejemplo,
XX-1234), mantenlo; de lo contrario, usa el número simple. Si la entrada no es reconocible, pregunta. - Obtén el ticket. Obtén el elemento de trabajo/incidencia con su conjunto completo de campos, comentarios en línea y enlaces/relaciones expandidas. Captura todo lo que el ticket contiene — no filtres previamente a un conjunto fijo de campos. Convierte cualquier formato de texto enriquecido que recibas (HTML, ADF, ...) a Markdown limpio.
- Elige un slug. Slug corto en kebab-case, de 3 a 5 palabras, a partir del título/resumen — que sea buscable, no le des muchas vueltas.
- Decide el directorio de salida. Un subdirectorio
<id>-<slug>/relativo al proyecto dentro del directorio de planificación del proyecto (por ejemplo,.claude/plans/) — sigue la convención del proyecto/usuario para saber dónde van los planes; si no hay ninguna definida, pregunta al usuario. Nunca adivines. Si ya existe, sugiere<id>-<slug>-v2,-v3, etc. — nunca sobrescribas un directorio de plan existente; el historial por cada nueva extracción se mantiene a propósito. - Escribe el archivo del ticket en
<directorio-salida>/<id>-<slug>.TICKET.md. - Descarga los adjuntos en el directorio de salida; advierte sobre los que fallen (consulta Adjuntos).
- Imprime el resultado — rutas relativas al proyecto y la línea del siguiente paso (consulta Siguiente paso).
Estructura del archivo del ticket
Debe ser autónomo: una versión completa y legible del ticket con suficientes metadatos para que una sesión nueva pueda identificar el origen sin tener que volver a extraerlo.
Encabezado
Encabezado Markdown simple con metadatos de origen; omite cualquier línea cuyo valor esté ausente. Incluye lo que proporcione el sistema de seguimiento. Ejemplo:
# <título / resumen>
> **Origen** [<id>](<url>)
> **Tipo** {tipo}
> **Estado** {estado}
> **Asignado a** {nombre mostrado o "—"}
> **Reportado por / Creado por** {nombre mostrado}
> **Etiquetas / Tags** {unidos o "—"}
> **Extraído** {hoy AAAA-MM-DD}
Secciones del cuerpo
Emitir en este orden, solo si están presentes y no vacías:
## Descripción## Criterios de aceptación— si el sistema de seguimiento tiene un campo dedicado de CA poblado## <Otros campos>— una sección por cada otro campo poblado que tenga contenido real (notas técnicas, campos personalizados, …), encabezada por el nombre mostrado del campo. Captura todo lo que contiene el ticket.## Comentarios— primero los más antiguos, cada uno### <autor> — <fecha>y luego el cuerpo. Con el mejor esfuerzo: si no se devuelven comentarios, menciónalo brevemente u omite la sección.## Tickets relacionados— ver más abajo## Adjuntos— ver más abajo## Referencias de diseño— ver más abajo
Preserva la jerarquía de encabezados, la estructura de viñetas, el énfasis y los bloques de código; mapea los subencabezados dentro de los campos a ####. Omite las secciones vacías. Cita las cadenas visibles para el usuario, los identificadores de código, las rutas de archivo, las claves de i18n y las URLs textualmente — nunca las alteres ni las traduzcas.
Tickets relacionados
A partir de los enlaces/relaciones de la respuesta (y cualquier herramienta de enlace remoto), para cada ticket enlazado único (excluyendo este) obtén solo título + estado + tipo mediante una llamada barata — no el cuerpo completo. El objetivo principal es tener un rastro de todos los tickets relacionados, para que puedan ser extraídos más tarde si es necesario. Una viñeta por cada uno, con la relación si está disponible:
- [<id>](<url>) — (<tipo>, <estado>) <título>
Para enlaces remotos que no sean tickets (por ejemplo, una página de wiki/Confluence), emite el título y la URL como una viñeta simple. Si una extracción falla, lista el enlace con (no se pudo obtener) en lugar de hacer fallar toda la ejecución.
Adjuntos
Identifica cada adjunto y cada imagen en línea referenciada en la descripción/campos, numerados attachment-<N>.<ext> en orden de primera aparición, manteniendo la extensión original. <N> recorre ambos combinados.
Intenta siempre descargar — a través de cualquier MCP conectado. Más allá de los adjuntos alojados en el sistema de seguimiento, el ticket puede enlazar recursos externos (por ejemplo, un recurso de Confluence/ADO — para enlaces a herramientas de diseño como Figma o Zeplin consulta Referencias de diseño más abajo) accesibles a través de su propio MCP, incluyendo archivos de especificaciones/documentos en un repositorio git enlazado (obtén su contenido a través de git o del MCP del repositorio, guárdalos en el directorio de salida con su propio nombre de archivo). Usa el MCP que se ajuste al origen para descargarlos; no declares de antemano que un enlace no se puede descargar. Si hay un MCP adecuado conectado pero no está autenticado, no lo omitas silenciosamente — ejecuta proactivamente su flujo de autenticación (muestra la URL de inicio de sesión, completa el protocolo de enlace) sin esperar a que te lo pidan, luego descarga. Cuando no esté claro si un recurso se puede o debe descargar, pregunta al usuario.
Descarga cada uno directamente al disco — curl -fSL <url> -o attachment-<N>.<ext>, o la variante de guardar en ruta de la herramienta de adjuntos del MCP. Nunca enrutes un adjunto como base64 en línea a través del modelo y lo reemitas: los límites de salida (~100k caracteres) lo truncarán silenciosamente — encabezado válido, cola faltante, no se abrirá. Algunas herramientas MCP de adjuntos devuelven solo base64 sin opción de guardar en ruta (por ejemplo, ADO wit_get_work_item_attachment) — no las uses para binarios; descarga desde la API REST del sistema de seguimiento directamente al disco con un token de portador (ADO: az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query accessToken -o tsv, luego curl -H "Authorization: Bearer <token>" "<attachmentUrl>" -o attachment-<N>.<ext>). (Las URLs de contenido a menudo comparten la autenticación del MCP; en caso de 401, reintenta con el token de portador del sistema de seguimiento si se puede obtener.)
Verifica la integridad, no solo la transferencia — que no esté vacío; que coincida con Content-Length si se envió; que la cola de tipo esté presente (PNG IEND, JPEG FFD9, PDF %%EOF). Un tamaño que sea un múltiplo exacto de 3 cerca de un límite de caracteres redondo indica truncamiento de base64. Si falla, vuelve a descargar al disco; si sigue estando mal, trátalo como no descargado y advierte — nunca hagas referencia a un archivo corrupto. Luego, por archivo:
- Descargado → referencia al archivo local.
- No descargado (sin MCP/herramienta de adjuntos adecuada, autenticación que no se pudo completar, etc.) → sigue haciendo referencia al archivo local y a la URL de origen, y agrégalo a la lista de advertencias. No bloquees — el ticket es utilizable de cualquier manera.
Imagen → incrustar; no imagen (PDF, .docx, …) → enlazar en su lugar:
### Adjunto 1

_Nombre de archivo original: image.png_
### Adjunto 2
[attachment-2.pdf](attachment-2.pdf) — _Nombre de archivo original: design-spec.pdf_
Para un archivo que no se pudo descargar, agrega su origen para que el usuario pueda descargarlo manualmente: — no descargado; obténlo de <url> y guárdalo aquí como attachment-<N>.<ext>.
Referencias de diseño
Para enlaces a herramientas de diseño (Figma, Zeplin, Sketch, Adobe XD, …) en la descripción/comentarios, no los numeres como attachment-<N> — son referencias vivas, no archivos adjuntos. Captura cada frame/pantalla referenciada a través del MCP de esa herramienta (por ejemplo, Figma MCP get_screenshot), descargando la URL de corta duración devuelta directamente al disco como <herramienta>-<id>-<slug>.png (autentica su MCP primero si es necesario — consulta Adjuntos). Si no hay ningún MCP para esa herramienta conectado, sigue registrando la entrada con su nombre y URL de origen y agrégala a la lista de advertencias — igual que un adjunto no descargado. Registra una entrada por enlace, con la vista previa local más los identificadores necesarios para reabrirla en esa herramienta:
### <nombre del diseño>

_Figma · archivo `<fileKey>` · nodo `<nodeId>` · [origen](<url>)_
Límites
- No analices, planifiques ni explores el código base para obtener contexto — esto no exime los archivos que el ticket enlaza explícitamente, que sí obtienes (consulta Adjuntos).
- No modifiques el ticket en su sistema de seguimiento — la extracción es de solo lectura (sin comentarios, transiciones, ediciones, registros de trabajo).
- Los únicos archivos que creas: el
.TICKET.md, sus adjuntos y cualquier documento enlazado que hayas obtenido.
Siguiente paso
Indica claramente cuando hayas terminado, usando rutas relativas al proyecto (nunca absolutas): el directorio de salida, el archivo del ticket y cualquier adjunto. Si algún adjunto no se pudo descargar, primero emite una advertencia clara listando cada attachment-<N>.<ext> faltante y su URL de origen, indicando al usuario que lo descargue y lo guarde con ese nombre exacto para que las incrustaciones se resuelvan. Luego entrega la siguiente fase como un comando de lanzamiento único copiable — nombre de sesión y prompt combinados, para que un solo pegado inicie la sesión. Usa la sintaxis de lanzamiento de la herramienta de agente en uso (independiente del proveedor — claude a continuación es solo el ejemplo), nombrando la sesión refine-<slug>:
claude --name refine-<slug> "/refine-ticket <directorio-salida>/<id>-<slug>.TICKET.md"
Luego ofrece la alternativa — limpiar la sesión actual en su lugar (independiente del proveedor — /clear a continuación es solo el ejemplo; usa el comando de limpieza de la herramienta de agente en uso):
O /clear y ejecuta:
/refine-ticket <directorio-salida>/<id>-<slug>.TICKET.md

