TaskGoblin se connecte à deux types d'outils, et la distinction détermine la façon dont vous vous inscrivez :
- Un fournisseur git — GitLab ou GitHub — apporte vos dépôts et provisionne votre organisation. Exactement un par organisation, choisi à la connexion.
- Les fournisseurs de capacités — Linear, Jira, Slack et Microsoft Teams — ajoutent des surfaces où les boucles peuvent se déclencher et les goblins rendre compte. Ceux-là se connectent dans une organisation que vous avez déjà.
Vous les gérez tous depuis Intégrations dans le menu de votre organisation (/{organisation}/integrations).
Connecter un fournisseur installe ses boucles par défaut. C'est la conséquence pratique à retenir : une intégration n'est pas qu'un identifiant, c'est un ensemble de comportements permanents qui arrive avec. Voir Boucles d'événement pour ce que chacune installe.
Fournisseurs git (GitLab ou GitHub)
Se connecter, c'est connecter votre fournisseur git — un seul consentement OAuth vous authentifie et provisionne votre organisation et vos dépôts. C'est pourquoi il n'y a pas d'étape séparée « connectez votre dépôt ».
GitLab
Connecter GitLab énumère les groupes auxquels vous appartenez et provisionne une organisation TaskGoblin pour chacun, plus une organisation personnelle. Le goblin publie sous @taskgoblin sur les merge requests et les tickets. Si le jeton doit être rafraîchi, la page Intégrations propose Reconnecter en un clic.
Installe : Relire les merge requests, Traiter les tickets assignés.
GitHub
GitHub est une GitHub App, pas une application OAuth classique. Vous installez l'app TaskGoblin sur l'organisation voulue, et chaque installation devient une organisation TaskGoblin. L'app émet à la demande des jetons d'installation de courte durée et le goblin publie sous taskgoblin[bot]. Comme les permissions se rafraîchissent via l'installation elle-même, les organisations GitHub n'ont jamais besoin d'une reconnexion manuelle.
Installe : Relire les pull requests, Traiter les tickets labellisés.
Une organisation provisionnée par git reste liée au fournisseur qui l'a créée — la carte de ce fournisseur propose Reconnecter plutôt que Déconnecter.
Fournisseurs de capacités
Linear
Un consentement OAuth en un clic dans votre organisation active. Une fois connecté, les goblins prennent en charge les tickets assignés à l'agent TaskGoblin, lisent le ticket et ses commentaires comme contexte, et publient statut, activité et lien de merge request sur le ticket.
Installe : Traiter les tickets assignés.
Jira
Un consentement OAuth Atlassian qui connecte votre site Jira à l'organisation active. Les goblins prennent en charge les tickets assignés au compte TaskGoblin et répondent aux mentions dans les commentaires, sous forme de commentaire sur le ticket, et le font avancer dans votre flux quand vous le demandez.
Un ticket Jira nomme rarement un dépôt : le goblin déduit donc la destination de la demande, de votre mémoire d'organisation et de vos dépôts connectés — et demande plutôt que de deviner quand il ne peut vraiment pas savoir. Le lui dire une fois suffit : il note la réponse.
Installe : Traiter les tickets assignés.
Slack
Connecter Slack permet à quiconque de mentionner le goblin dans un fil et d'obtenir une réponse là où la conversation a lieu. Le jeton du bot n'expire pas, il n'y a donc rien à rafraîchir. Slack est aussi l'endroit où les boucles planifiées livrent résumés et rappels quand l'instruction nomme un canal.
N'installe aucune boucle — c'est une surface, pas un déclencheur.
Microsoft Teams
Mentionnez le goblin dans un canal Teams, une conversation de groupe ou un message direct : il répond sur place, en modifiant son propre message au fil du travail. La connexion vérifie votre tenant Microsoft ; aucun jeton de bot à gérer.
N'installe aucune boucle.
Comment le goblin s'authentifie en tant que lui-même
Vous ne collez jamais de jeton d'accès personnel dans TaskGoblin, et le goblin ne voit jamais vos identifiants.
Chaque fournisseur a sa propre identité de bot — @taskgoblin sur GitLab, Slack et Teams, taskgoblin[bot] sur GitHub. Dans le sandbox, les identifiants git sont provisionnés par organisation à l'exécution (un jeton OAuth GitLab, ou un jeton d'installation GitHub fraîchement émis) et injectés dans l'environnement autour de l'agent plutôt que remis à lui pour lecture.
Cette frontière est délibérée, et elle explique aussi pourquoi le goblin commente via ses propres intégrations plutôt qu'avec le jeton git qu'on lui a confié : un commentaire publié avec votre jeton apparaîtrait sous votre nom. Tout ce que dit un goblin, il le dit en son nom propre.
Déconnecter
Déconnectez un fournisseur depuis la page Intégrations et les goblins perdent cet accès immédiatement — les boucles qui en dépendaient cessent de se déclencher, et plus rien n'y est lu ni publié. Reconnecter rétablit la même connexion.
Où aller ensuite
- Boucles d'événement — ce que font les boucles par défaut de chaque fournisseur et comment les modifier.
- Exécutions ponctuelles — mentionner le goblin directement sur n'importe quelle surface connectée.
- Démarrage rapide — tout le chemin de l'inscription à votre première boucle.