← Dokümanlara geri dön

GitHub Entegrasyonu

Çekme isteklerinin görev durumlarını otomatik olarak güncelleyebilmesi için bir GitHub deposunu Willet projesiyle ilişkilendirin.

Nasıl çalışır

Bağlı bir depoda pull request açıldığında ve bu PR bir Willet görevine kapanış anahtar kelimesiyle atıfta bulunduğunda, görev in_progress durumuna geçer. Pull request birleştirildiğinde ise görev done durumuna taşınır. Entegrasyon yalnızca bir görevin durumunu ilerletir — halihazırda tamamlanmış veya iptal edilmiş görevlere hiçbir zaman dokunulmaz; yeniden açılan veya geri alınan bir PR, görevi önceki durumuna döndürmez. Durum değişiklikleri "Willet (GitHub)" olarak kaydedilir ve PR URL'si görevin geçmişine eklenir.

Kurulum

Bağlantı, Gösterge Paneli üzerinden değil, Willet'in MCP araçları aracılığıyla yönetilir. Bunu ayarlamak için Willet'e bağlı herhangi bir AI asistanından yardım isteyin ya da araçları doğrudan çalıştırın. Willet organizasyonunda yönetici veya sahip rolüne ve GitHub deposunda yönetici erişimine sahip olmanız gerekir.

  1. GitHub ile Willet'e giriş yapın. Repolarınıza webhook kaydetmek için gereken izinleri talep edeceğiz.
  2. AI asistanınıza, org slug'ınızı, proje slug'ınızı ve repoyu owner/repo formatında belirterek link_github_repo aracını çağırmasını söyleyin.
  3. Kayıtlı GitHub yetkilendirmenizde eksik kapsamlar varsa, araç size bir URL döndürecektir — URL'yi açın, yeniden yetkilendirin, ardından link_github_repo komutunu tekrar çalıştırın.
link_github_repo org_slug=<org> project_slug=<project> repo=<owner>/<repo>

PR'larda görevlere referans verme

Bir göreve, okunabilir anahtarıyla (projenin öneki ve görev numarasının birleşimi, örneğin WD-42) veya 26 karakterlik ULID'iyle başvurabilirsiniz. Bu başvuruyu PR başlığına, açıklamasına veya dal adına istediğiniz yere ekleyin ve bir kapanış anahtar kelimesiyle eşleştirin. Bir anahtar kelimeden sonra istediğiniz kadar görev belirtebilirsiniz.

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

Kapatma anahtar kelimeleri

Eşleştirme büyük/küçük harf ve aksan duyarsızdır ve Willet'in desteklediği her dilde çalışır. Standart İngilizce anahtar kelimeler (close/closes/closed, fix/fixes/fixed, resolve/resolves/resolved, complete/completes/completed) desteklenir; bunların yanı sıra Almanca, İspanyolca, Fransızca, İtalyanca, Japonca, Korece ve Türkçedeki doğal karşılıkları da geçerlidir. Fiili sona taşıyan dillere uyum sağlamak için her iki sıralama da kabul edilir — "fix <görev>" veya "<görev> fixed".

Güvenlik

Her bağlı repo, kendi başına bir HMAC webhook gizli anahtarı alır; bu sayede imzasız veya tekrarlanan bir webhook görevleri hareket ettiremez. Willet eşleşmesi olmayan bir repodan gelen webhook olayları işleme alınmaz. Entegrasyon, repo↔proje eşleşmesine güvenir: bağlı repoda PR birleştirebilen herkes görev durumunu ilerletebilir, bu nedenle katkıda bulunanların görevlerinizi güncelleyememesi gereken repoları bağlamayın.