← Zurück zur Dokumentation

GitHub-Integration

Verknüpfe ein GitHub-Repository mit einem Willet-Projekt, damit Pull Requests den Status von Aufgaben automatisch aktualisieren können.

So funktioniert es

Wenn ein Pull Request in einem verknüpften Repository geöffnet wird und eine Willet-Aufgabe mit einem Closing-Keyword referenziert, wird die Aufgabe auf „in_progress" gesetzt. Wenn der Pull Request gemergt wird, wird die Aufgabe auf „done" gesetzt. Die Integration setzt den Status einer Aufgabe immer nur vorwärts – Aufgaben, die bereits als „done" markiert oder abgebrochen wurden, werden nie verändert, und ein wieder geöffneter oder revertierter PR setzt eine Aufgabe nicht zurück. Statusänderungen werden „Willet (GitHub)" zugeschrieben, und die PR-URL wird in der Historie der Aufgabe gespeichert.

Einrichtung

Die Verknüpfung wird über Willets MCP-Tools verwaltet, nicht über das Dashboard. Bitte einen beliebigen mit Willet verbundenen KI-Agenten, das für dich einzurichten, oder führe die Tools direkt aus. Du benötigst die Admin- oder Besitzer-Rolle in der Willet-Organisation sowie Admin-Zugang zum GitHub-Repository.

  1. Melde dich mit GitHub bei Willet an. Wir fordern die Berechtigungen an, die nötig sind, um Webhooks in deinen Repos zu registrieren.
  2. Bitte deinen Agenten, das Tool link_github_repo mit deinem Org-Slug, Projekt-Slug und dem Repository im Format owner/repo aufzurufen.
  3. Wenn deiner gespeicherten GitHub-Autorisierung Berechtigungen fehlen, gibt das Tool eine URL zurück – öffne sie, autorisiere erneut und führe dann link_github_repo nochmal aus.
link_github_repo org_slug=<org> project_slug=<project> repo=<owner>/<repo>

Aufgaben in PRs referenzieren

Verweise auf eine Aufgabe anhand ihres lesbaren Kürzels (das Präfix des Projekts plus die Aufgabennummer, z. B. WD-42) oder anhand ihrer 26-stelligen ULID. Füge den Verweis an beliebiger Stelle im PR-Titel, in der Beschreibung oder im Branch-Namen ein und kombiniere ihn mit einem Abschluss-Schlüsselwort. Du kannst beliebig viele Aufgaben hinter einem Schlüsselwort angeben.

Fixes WD-12, WD-13 and WD-14

Schließende Schlüsselwörter

Der Abgleich unterscheidet nicht zwischen Groß- und Kleinschreibung, ignoriert Akzente und funktioniert in jeder Sprache, die Willet unterstützt. Die englischen Standardschlüsselwörter (close/closes/closed, fix/fixes/fixed, resolve/resolves/resolved, complete/completes/completed) werden erkannt, ebenso ihre natürlichen Entsprechungen auf Deutsch, Spanisch, Französisch, Italienisch, Japanisch, Koreanisch und Türkisch. Beide Reihenfolgen funktionieren – „fix <Aufgabe>" oder „<Aufgabe> fixed" –, um Sprachen gerecht zu werden, in denen das Verb natürlicherweise am Ende steht.

Sicherheit

Jedes verknüpfte Repository erhält ein eigenes HMAC-Webhook-Secret pro Zuordnung, sodass ein unsignierter oder wiederholter Webhook keine Aufgaben verschieben kann. Webhook-Events aus einem Repository ohne Willet-Zuordnung werden verworfen. Die Integration vertraut der Repository↔Projekt-Zuordnung selbst: Jede Person, die einen PR im verknüpften Repository mergen kann, kann den Aufgabenstatus ändern – verknüpfe also keine Repositories, deren Mitwirkende deine Aufgaben nicht aktualisieren dürfen.