Ce guide de démarrage rapide vous accompagne d'un compte tout juste créé jusqu'à votre première merge request rédigée par l'agent. Cela ne devrait prendre que quelques minutes — la majeure partie de ce temps consiste à attendre l'agent, pas à cliquer à travers des étapes de configuration.
Avant de commencer
Vous avez besoin d'un accès administrateur à un groupe GitLab ou à une organisation GitHub dont vous souhaitez que l'agent modifie les dépôts, et — pour la prise en main la plus fluide — d'un espace de travail Linear. C'est tout : rien à installer localement, aucune clé à copier d'un endroit à l'autre.
Étape 1 — Connectez-vous
Rendez-vous sur la page de connexion et identifiez-vous avec GitLab ou GitHub. Ce consentement unique vous connecte tout en provisionnant votre organisation : TaskGoblin crée une organisation pour chacun de vos groupes distants (GitLab) ou pour l'installation de l'application (GitHub), de sorte que vos dépôts sont connectés dès votre arrivée.
Pour GitHub, vous installez l'application GitHub de TaskGoblin sur l'organisation de votre choix ; le jeton d'installation de l'application constitue l'identité du bot qui publie sous le nom taskgoblin[bot]. Pour GitLab, le consentement OAuth énumère vos groupes et les connecte.
Étape 2 — Connectez votre gestionnaire d'issues
Ouvrez Intégrations depuis le menu de votre organisation et connectez Linear. Il s'agit d'un consentement OAuth en un clic qui permet à TaskGoblin de voir les issues qui lui sont assignées et de republier des mises à jour. Si votre équipe travaille sur Slack, connectez également Slack ici — vous pourrez ensuite mentionner le goblin dans n'importe quel fil de discussion.
Consultez Connecter vos intégrations pour la liste complète et ce que chacune débloque.
Étape 3 — Assignez une tâche à l'agent
Confiez maintenant du travail à l'agent. La première tâche la plus simple est un changement petit et bien décrit — une correction de texte, un petit refactoring, un test manquant.
- Dans Linear : ouvrez un issue, décrivez clairement le changement et définissez TaskGoblin comme assigné.
- Sur GitHub : ajoutez le label
taskgoblinà un issue. - Sur GitLab : assignez un issue au bot
@taskgoblin.
TaskGoblin prend automatiquement la tâche en charge — l'assignation ou le label constitue le déclencheur. Il n'y a aucune file d'attente à surveiller ni bouton à presser.
Étape 4 — Regardez-le travailler
L'agent démarre un sandbox, clone le dépôt et commence à travailler sur une branche nommée ai-{issue-identifier}. Il republie sa progression sur l'issue au fur et à mesure, ce qui vous permet de suivre sans rien ouvrir de nouveau. Une fois terminé, il committe, pousse, et ouvre une merge request (ou pull request) liée à l'issue.
Étape 5 — Vérifiez et itérez
Vérifiez la merge request exactement comme vous le feriez pour celle d'un collègue. Si quelque chose doit être modifié, n'ouvrez pas une nouvelle fenêtre de discussion — laissez simplement un commentaire de revue en mentionnant @taskgoblin, ou répondez sur l'issue. L'agent reprend sur la même branche, avec tout le contexte de l'exécution jusque-là, et pousse un commit de suivi. Consultez Assigner du travail à l'agent pour découvrir toutes les façons de le relancer.
Ce que vous venez de faire
Vous avez connecté vos outils, délégué une tâche via l'interface que votre équipe utilise déjà, et récupéré une merge request prête à être vérifiée — sans que l'agent ne touche jamais votre ordinateur portable. C'est là toute la boucle. Tout le reste de cette documentation n'est que du détail qui s'appuie dessus.