← Retour à la documentation

Intégration GitHub

Liez un dépôt GitHub à un projet Willet pour que les pull requests mettent à jour les statuts des tâches automatiquement.

Comment ça fonctionne

Quand une pull request est ouverte dans un dépôt lié et référence une tâche Willet avec un mot-clé de fermeture, la tâche passe à in_progress. Quand la pull request est fusionnée, la tâche passe à done. L'intégration ne fait qu'avancer le statut d'une tâche — les tâches déjà terminées ou annulées ne sont jamais modifiées, et une PR réouverte ou annulée ne remet pas une tâche à un statut antérieur. Les changements de statut sont attribués à « Willet (GitHub) » et l'URL de la PR est enregistrée dans l'historique de la tâche.

Configuration

La liaison est gérée via les outils MCP de Willet, pas depuis le tableau de bord. Demandez à n'importe quel agent IA connecté à Willet de configurer ça pour vous, ou exécutez les outils directement. Vous aurez besoin du rôle administrateur ou propriétaire sur l'organisation Willet, et d'un accès administrateur sur le dépôt GitHub.

  1. Connectez-vous à Willet avec GitHub. Nous demanderons les permissions nécessaires pour enregistrer des webhooks sur vos dépôts.
  2. Demandez à votre agent d'appeler l'outil link_github_repo avec le slug de votre organisation, le slug de votre projet, et le dépôt sous la forme propriétaire/dépôt.
  3. Si votre autorisation GitHub enregistrée manque de portées, l'outil vous renverra une URL — ouvrez-la, autorisez à nouveau, puis relancez link_github_repo.
link_github_repo org_slug=<org> project_slug=<project> repo=<owner>/<repo>

Référencer des tâches dans les PRs

Référencez une tâche par sa clé lisible (le préfixe du projet suivi du numéro de tâche, comme WD-42) ou par son ULID de 26 caractères. Placez la référence n'importe où dans le titre, la description ou le nom de branche de la PR, et associez-la à un mot-clé de fermeture. Vous pouvez indiquer autant de tâches que vous voulez après un même mot-clé.

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

Mots-clés de fermeture

La correspondance est insensible à la casse et aux accents, et fonctionne dans toutes les langues prises en charge par Willet. Les mots-clés anglais standards (close/closes/closed, fix/fixes/fixed, resolve/resolves/resolved, complete/completes/completed) sont reconnus, ainsi que leurs équivalents naturels en allemand, espagnol, français, italien, japonais, coréen et turc. Les deux ordres sont acceptés — « fix <tâche> » ou « <tâche> fixed » — pour s'adapter aux langues où le verbe se place naturellement en fin de phrase.

Sécurité

Chaque dépôt lié dispose de son propre secret HMAC de webhook par correspondance, ce qui empêche un webhook non signé ou rejoué de modifier des tâches. Les événements de webhook provenant d'un dépôt sans correspondance Willet sont ignorés. L'intégration fait confiance à la correspondance dépôt↔projet elle-même : toute personne pouvant fusionner une PR dans le dépôt lié peut faire avancer le statut d'une tâche, donc ne liez pas de dépôts dont les contributeurs ne devraient pas pouvoir mettre à jour vos tâches.