Assignez du travail à l'agent

Toutes les façons de mettre le gobelin au travail : assignez-lui un ticket Linear, mentionnez-le sur une merge request, étiquetez un ticket GitHub, sollicitez-le sur Slack, laissez-le relire automatiquement vos pull requests, ou planifiez une tâche récurrente.

Il n'existe pas de bouton "exécuter" unique dans TaskGoblin. L'agent surveille plutôt les outils que vous utilisez déjà et prend en charge le travail dès que vous le lui confiez — les mêmes gestes que vous utiliseriez pour déléguer à un coéquipier. Cette page est le catalogue complet de ces déclencheurs.

Quelle que soit la surface que vous utilisez, l'agent arrive sur la tâche en connaissant déjà son contexte et rapporte le résultat au même endroit.

Assigner un ticket Linear

Définissez l'agent TaskGoblin comme assigné d'un ticket Linear. Il lit le titre, la description et les commentaires du ticket, effectue le travail, puis relie la merge request au ticket avec des mises à jour de statut au fil de l'avancement. C'est le déclencheur le plus courant, celui qu'utilise le guide de démarrage rapide.

Pour lui demander une nouvelle itération, laissez un commentaire sur le ticket décrivant le changement souhaité — l'agent reprend sur la même branche.

Le mentionner sur une merge request ou une pull request

Laissez un commentaire mentionnant le gobelin sur une MR ou une PR existante :

  • Sur GitLab, @taskgoblin dans une note de merge request.
  • Sur GitHub, @taskgoblin dans un commentaire de pull request ou de ticket.

Utilisez-le pour itérer : @taskgoblin please address the review comments (veuillez traiter les commentaires de revue) ou @taskgoblin add tests for the edge case in the last commit (ajoutez des tests pour le cas limite du dernier commit). L'agent pousse un commit de suivi sur la même branche.

Revue de code automatique

Lorsqu'une merge request ou une pull request est ouverte ou mise à jour, TaskGoblin peut la relire automatiquement et publier ses retours en commentaires — sans qu'aucune mention ne soit nécessaire. L'agent devient ainsi un relecteur de première ligne sur chaque changement, pas seulement ceux qu'il a lui-même écrits.

Déclencher depuis un ticket

Vous n'êtes pas obligé d'utiliser Linear pour démarrer depuis un ticket :

  • Sur GitHub, ajoutez le label taskgoblin à un ticket. Le label est le déclencheur ; les mentions dans les commentaires de ce ticket poursuivent ensuite l'exécution.
  • Sur GitLab, assignez un ticket au bot @taskgoblin, ou mentionnez-le dans un commentaire du ticket.

Solliciter sur Slack

Mentionnez le gobelin dans un fil Slack. Il répond dans le fil où se déroule la conversation, ce qui fait de Slack la bonne surface lorsqu'une demande commence comme une discussion plutôt que comme un ticket formel. Connectez d'abord Slack depuis Intégrations.

Planifier une tâche récurrente

Pour un travail qui doit se produire selon une cadence plutôt qu'à la demande, créez un loop : une instruction en texte libre que l'agent exécute à un moment unique ou récurrent. Chaque déclenchement se comporte exactement comme n'importe quelle autre exécution — il crée un thread et ouvre une merge request — de sorte que le travail planifié partage le même historique et le même flux de revue. Gérez-les depuis /{organisation}/loops.

Bons candidats : une mise à jour hebdomadaire des dépendances, une ébauche de changelog nocturne, une tâche de nettoyage récurrente.

Ce que tous les déclencheurs ont en commun

  • L'agent arrive avec du contexte. Il lit le ticket, le thread ou l'historique des commentaires avant de commencer.
  • Le travail se déroule dans un sandbox, sur une branche nommée ai-{issue-identifier}, jamais sur votre machine.
  • Le résultat revient là où vous l'avez demandé. Une merge request, un commentaire de revue ou une réponse Slack — au même endroit où vous avez déclenché l'action.

Pour savoir ce qui se passe entre le déclenchement et la merge request, lisez Comment fonctionne l'agent.