← Torna alla documentazione

Integrazione GitHub

Collega un repository GitHub a un progetto Willet così le pull request possono aggiornare automaticamente gli stati delle attività.

Come funziona

Quando una pull request viene aperta in un repository collegato e fa riferimento a un'attività di Willet con una parola chiave di chiusura, l'attività passa allo stato in_progress. Quando la pull request viene unita, l'attività passa allo stato done. L'integrazione fa avanzare lo stato di un'attività solo in avanti — le attività già completate o annullate non vengono mai modificate, e una PR riaperta o ripristinata non riporta indietro un'attività. Le modifiche di stato vengono attribuite a "Willet (GitHub)" e l'URL della PR viene registrato nella cronologia dell'attività.

Configurazione

Il collegamento viene gestito tramite gli strumenti MCP di Willet, non dalla dashboard. Chiedi a qualsiasi agente AI connesso a Willet di configurarlo per te, oppure esegui gli strumenti direttamente. Avrai bisogno del ruolo di Admin o Proprietario sull'organizzazione Willet e dell'accesso da Admin sul repository GitHub.

  1. Accedi a Willet con GitHub. Richiederemo i permessi necessari per registrare i webhook sui tuoi repository.
  2. Chiedi al tuo agente di chiamare lo strumento link_github_repo con lo slug della tua organizzazione, lo slug del progetto e il repository nel formato proprietario/repository.
  3. Se all'autorizzazione GitHub salvata mancano alcuni permessi, lo strumento restituirà un URL — aprilo, ri-autorizza, poi esegui di nuovo link_github_repo.
link_github_repo org_slug=<org> project_slug=<project> repo=<owner>/<repo>

Riferimento alle attività nelle PR

Fai riferimento a un'attività tramite la sua chiave leggibile (il prefisso del progetto più il numero dell'attività, come WD-42) o tramite il suo ULID di 26 caratteri. Inserisci il riferimento nel titolo della PR, nella descrizione o nel nome del branch, e abbinalo a una parola chiave di chiusura. Puoi indicare quante attività vuoi dopo una singola parola chiave.

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

Parole chiave di chiusura

Il confronto non distingue maiuscole/minuscole né accenti, e funziona in tutte le lingue supportate da Willet. Le parole chiave standard in inglese (close/closes/closed, fix/fixes/fixed, resolve/resolves/resolved, complete/completes/completed) sono riconosciute, insieme ai loro equivalenti naturali in tedesco, spagnolo, francese, italiano, giapponese, coreano e turco. Entrambi gli ordini sono validi — "fix <attività>" o "<attività> fixed" — per adattarsi alle lingue in cui il verbo segue naturalmente il complemento.

Sicurezza

Ogni repo collegato ha il proprio segreto HMAC webhook per mapping, quindi un webhook non firmato o ripetuto non può modificare le attività. Gli eventi webhook provenienti da un repo senza mapping Willet vengono ignorati. L'integrazione si fida del mapping repo↔progetto in sé: chiunque possa fare il merge di una PR nel repo collegato può aggiornare lo stato delle attività, quindi non collegare repo i cui collaboratori non dovrebbero poter modificare le tue attività.