TaskGoblin verbindet sich mit zwei Arten von Werkzeugen, und der Unterschied bestimmt, wie Sie sich anmelden:
- Ein Git-Anbieter — GitLab oder GitHub — liefert Ihre Repositories und richtet Ihre Organisation ein. Genau einer pro Organisation, gewählt beim Anmelden.
- Fähigkeits-Anbieter — Linear, Jira, Slack und Microsoft Teams — fügen Oberflächen hinzu, auf denen Loops auslösen und Goblins berichten können. Diese verbinden Sie in eine bereits bestehende Organisation.
Verwalten Sie alle unter Integrationen im Menü Ihrer Organisation (/{organisation}/integrations).
Einen Anbieter zu verbinden installiert dessen Standard-Loops. Das ist die praktische Folge, die man sich merken sollte: Eine Integration ist nicht bloß eine Zugangsberechtigung, sondern ein Satz dauerhafter Verhaltensweisen, der mitkommt. Was jeweils installiert wird, steht unter Ereignis-Loops.
Git-Anbieter (GitLab oder GitHub)
Sich anzumelden ist das Verbinden Ihres Git-Anbieters — eine einzige OAuth-Zustimmung authentifiziert Sie und richtet Ihre Organisation samt Repositories ein. Deshalb gibt es keinen separaten Schritt „Repository verbinden".
GitLab
GitLab zu verbinden listet die Gruppen auf, denen Sie angehören, und richtet für jede eine TaskGoblin-Organisation ein, dazu eine persönliche. Der Goblin schreibt als @taskgoblin in Merge Requests und Issues. Muss das Token erneuert werden, bietet die Integrationsseite Erneut verbinden mit einem Klick.
Installiert: Merge Requests prüfen, Zugewiesene Issues bearbeiten.
GitHub
GitHub ist eine GitHub App, keine klassische OAuth-App. Sie installieren die TaskGoblin-App in der gewünschten Organisation, und jede Installation wird zu einer TaskGoblin-Organisation. Die App stellt bei Bedarf kurzlebige Installations-Tokens aus, und der Goblin schreibt als taskgoblin[bot]. Da Berechtigungen über die Installation selbst erneuert werden, brauchen GitHub-Organisationen nie ein manuelles erneutes Verbinden.
Installiert: Pull Requests prüfen, Gelabelte Issues bearbeiten.
Eine über Git eingerichtete Organisation ist an den Anbieter gebunden, der sie erzeugt hat — dessen Karte bietet Erneut verbinden statt Trennen.
Fähigkeits-Anbieter
Linear
Eine OAuth-Zustimmung mit einem Klick in Ihre aktive Organisation. Danach übernehmen Goblins Issues, die dem TaskGoblin-Agenten zugewiesen sind, lesen Issue und Kommentare als Kontext und posten Status, Aktivität und den Merge-Request-Link zurück ans Issue.
Installiert: Zugewiesene Issues bearbeiten.
Jira
Eine Atlassian-OAuth-Zustimmung, die Ihre Jira-Site mit der aktiven Organisation verbindet. Goblins übernehmen Issues, die dem TaskGoblin-Konto zugewiesen sind, und beantworten Erwähnungen in Issue-Kommentaren — als Kommentar am Issue, und auf Wunsch bewegen sie es durch Ihren Workflow.
Ein Jira-Issue nennt selten ein Repository, also erschließt der Goblin das Ziel aus der Anfrage, aus Ihrem Organisationsgedächtnis und aus Ihren verbundenen Repositories — und fragt nach, statt zu raten, wenn er es wirklich nicht wissen kann. Einmal sagen genügt; er schreibt die Antwort auf.
Installiert: Zugewiesene Issues bearbeiten.
Slack
Slack zu verbinden erlaubt es allen, den Goblin in einem Thread zu erwähnen und dort eine Antwort zu bekommen, wo das Gespräch stattfindet. Das Bot-Token läuft nicht ab, es gibt also nichts zu erneuern. In Slack liefern außerdem Zeitplan-Loops ihre Zusammenfassungen und Erinnerungen ab, wenn die Anweisung einen Kanal nennt.
Installiert keine eigenen Loops — es ist eine Oberfläche, kein Auslöser.
Microsoft Teams
Erwähnen Sie den Goblin in einem Teams-Kanal, einem Gruppenchat oder einer Direktnachricht, und er antwortet an Ort und Stelle und bearbeitet seine eigene Nachricht, während die Arbeit voranschreitet. Das Verbinden verifiziert Ihren Microsoft-Tenant; ein Bot-Token müssen Sie nicht verwalten.
Installiert keine eigenen Loops.
Wie der Goblin sich als er selbst authentifiziert
Sie fügen nie ein persönliches Zugriffstoken in TaskGoblin ein, und der Goblin sieht Ihre Zugangsdaten nie.
Jeder Anbieter hat seine eigene Bot-Identität — @taskgoblin bei GitLab, Slack und Teams, taskgoblin[bot] bei GitHub. In der Sandbox werden Git-Zugangsdaten pro Organisation zur Laufzeit bereitgestellt (ein GitLab-OAuth-Token oder ein frisch erzeugtes GitHub-Installations-Token) und in die Umgebung um den Agenten herum eingespeist, statt ihm zum Lesen übergeben zu werden.
Diese Grenze ist Absicht — und sie erklärt auch, warum der Goblin über seine eigenen Integrationen kommentiert und nicht über das Git-Token, das er bekommen hat: Mit Ihrem Token gepostete Kommentare erschienen unter Ihrem Namen. Was ein Goblin sagt, sagt er als er selbst.
Trennen
Trennen Sie einen Anbieter auf der Integrationsseite, verlieren Goblins diesen Zugang sofort — die Loops, die davon abhingen, lösen nicht mehr aus, und es wird dort nichts mehr gelesen oder gepostet. Erneutes Verbinden stellt dieselbe Verbindung wieder her.
Wie es weitergeht
- Ereignis-Loops — was die Standard-Loops jedes Anbieters tun und wie Sie sie ändern.
- Einzelne Läufe — den Goblin auf jeder verbundenen Oberfläche direkt erwähnen.
- Schnellstart — der ganze Weg von der Anmeldung bis zum ersten Loop.