Arreglar un ticket: del tracker al pull request
Dale un ticket al agente y hace el ciclo completo: lee el ticket, encuentra el código, reproduce el defecto, lo arregla, pasa las comprobaciones, hace commit, hace push, abre el pull request y actualiza el ticket. Los pasos que ven otras personas esperan tu aprobación.
Beta Funciona en el chat del agente de Ingot y como misión de Rex, con Jira, Asana, OpenText Octane, Linear y GitHub Issues, sobre GitHub, GitLab, Bitbucket, Azure DevOps y Gitea / Forgejo.
Empezar
En el chat del agente, cualquiera de estas opciones:
- Escribe
fix PROJ-123(ofix #12para un issue de GitHub). - Pega la URL de un ticket de Jira, Asana, Octane, Linear o GitHub.
- Escribe
/fix-ticket PROJ-123. - Abre el menú
{ + }y elige Fix a ticket. Sin clave, el agente lista tus defectos abiertos de los trackers conectados y pregunta cuál arreglar.
Una pregunta como "¿por qué falló PROJ-12?" sigue siendo un mensaje normal.
Qué hace el agente
| Paso | Qué ocurre | Pregunta antes |
|---|---|---|
| Leer | El ticket, sus comentarios y lo que el tracker devuelve sobre enlaces y adjuntos | No (solo lectura) |
| Rama | fix/PROJ-123-resumen-corto, creada antes de editar | Tu ajuste de aprobación de git |
| Reproducir | Un test que falla por el defecto, ejecutado una vez para verlo fallar | Tu ajuste de aprobación de comandos |
| Arreglar y comprobar | Ediciones pequeñas; después el test y las comprobaciones del proyecto | Tu ajuste de aprobación de comandos |
| Commit | El asunto empieza con la clave: PROJ-123: …. Ingot añade la clave si el modelo la omitió | Tu ajuste de aprobación de git |
| Push | Solo la rama del ticket, nunca main, master ni una rama de release | Sí |
| Pull request | Título con la clave; el cuerpo enlaza el ticket y lista las comprobaciones | Sí, siempre |
| Ticket | Un comentario con el enlace del pull request y el paso a In Review | Sí, cada escritura |
Si omites un paso en su tarjeta, el agente se detiene ahí y dice qué falta.
Pull requests en cualquier host
El agente abre el pull request con una sola herramienta, open_pull_request:
- GitHub: con el inicio de sesión de GitHub que Ingot ya tiene (la CLI de GitHub,
GH_TOKENo el token del servidor MCP de GitHub). - GitLab, Bitbucket, Azure DevOps, Gitea / Forgejo: con la cuenta conectada en Git Hosts.
Si el host no está conectado, no se abre nada y el agente te da la página de "nuevo pull request" del host.
Conecta tu tracker
Los trackers son servidores MCP. Conéctalos en la página Rules & MCP:
| Tracker | Cómo se conecta |
|---|---|
| Jira | Jira & Confluence: inicio de sesión en un clic con tu cuenta de Atlassian |
| Asana | Asana: inicio de sesión mediante una app de Asana. Asana no permite que las apps se registren solas, así que introduces el client ID de una app creada en la consola de desarrolladores de Asana |
| OpenText Octane | OpenText Octane: la URL de tu servidor, https://<tu-host-de-octane>/mcp. Un administrador de Octane debe activar MCP en tu sitio y registrar el cliente o darte un token de API |
| Linear | Linear: inicio de sesión en un clic o una clave de API |
| GitHub Issues | GitHub: tu inicio de sesión de GitHub |
Sin conexión, el agente te pide que pegues el texto del ticket y no toca el ticket al final.
Lo que el agente puede hacer en un ticket depende de las herramientas que ofrece el servidor del tracker. Si falta una herramienta para un paso (por ejemplo, cambiar el estado), el agente lo dice en lugar de adivinar.
Rex
En Rex, empieza una tarea en un repositorio conectado con Fix ticket PROJ-123 o el enlace de un ticket. Se ejecuta como una misión:
- Rex lee el ticket con la app conectada, reproduce el defecto y lo arregla.
- La plataforma hace commit en
ingot-bot/fix-PROJ-123-…, con la clave en el asunto del commit y en el título del pull request, y enlaza el ticket al principio del pull request. - Con el pull request abierto, Rex comenta en el ticket y lo pasa a In Review. Cada cambio espera en la tarjeta de aprobación.
Se desactiva en Rex › Settings › Missions: Fix tickets y Update the ticket after the pull request.
Ajustes
| Ajuste | Por defecto | Qué hace |
|---|---|---|
ingot.tickets.fix.enabled | true | Fix ticket y la herramienta open_pull_request del agente (Settings › Features) |
ingot.tickets.fix.detect | true | Empieza con fix <clave> o una URL pegada. Desactivado: solo /fix-ticket y la acción de { + } |
ingot.tickets.fix.branchPrefix | fix/ | Con qué empiezan las ramas de ticket |
ingot.tickets.fix.comment | true | Comenta en el ticket cuando se abre el pull request |
ingot.tickets.fix.moveTo | In Review | El estado al que pasa el ticket. Vacío: no se toca |
ingot.tickets.fix.draftPullRequest | false | Abre los pull requests de tickets como borradores |
Están en Settings › Version Control › Tickets, y un proyecto puede fijarlos en .ingot/settings.json.
Límites
- Los adjuntos se leen solo hasta donde los devuelve el servidor del tracker.
- Octane documenta herramientas de lectura; que se pueda comentar o cambiar la fase depende del servidor de tu sitio.
- Rex abre pull requests en GitHub y GitLab. En otros hosts el cambio queda en el registro de la ejecución.
- Los commits y pull requests llevan la atribución salvo que la desactives.