Linear
Sorunları Cursor'a devrederek veya yorumlarda @Cursor etiketleyerek Cloud Agents'ı doğrudan Linear üzerinden kullanın.
Başlarken
Kurulum
Linear entegrasyonunu bağlamak için Cursor yöneticisi olmanız gerekir. Diğer ekip ayarlarına yönetici olmayan üyeler de erişebilir.
- Cursor entegrasyonları sayfasına gidin
- Linear'ın yanındaki Bağlan seçeneğine tıklayın
- Linear çalışma alanınızı bağlayın ve bir ekip seçin
- Yetkilendir seçeneğine tıklayın
- Cursor'da kalan Cloud Agent kurulumunu tamamlayın:
- Bir depo sağlayıcısı bağlayın ve varsayılan depoyu seçin
- Kullanım tabanlı fiyatlandırmayı etkinleştirin
- Gizlilik ayarlarını onaylayın
Hesap bağlama
İlk kullanımda Cursor ile Linear hesaplarınızı bağlamanız istenir. PR oluşturmak için bir depo sağlayıcısına bağlanmanız gerekir.
Nasıl kullanılır
Sorunları Cursor'a devredin veya yorumlarda @Cursor etiketini kullanın. Cursor, sorunları analiz eder ve geliştirme dışı işleri otomatik olarak filtreler.
İş devretme
- Linear işini açın
- Atanan kişi alanına tıklayın
- "Cursor"u seçin
Cursor'dan bahsetme
Yeni bir agent atamak veya ek talimatlar vermek için bir yorumda @Cursor etiketleyin. Örneğin: @Cursor fix the authentication bug described above.
İş akışı
Bulut ajanları Linear'da durumlarını gerçek zamanlı olarak gösterir ve tamamlandıklarında otomatik olarak PR oluşturur. İlerlemeyi Cursor kontrol panelinden takip edin.
Takip talimatları
Agent oturumunda yanıt verebilirsiniz; yanıtınız takip mesajı olarak agente iletilir. Çalışan bir Cloud Agent'a ek yönlendirme sağlamak için bir Linear yorumunda @Cursor etiketleyin.
Yapılandırma
Cloud Agent ayarlarını Kontrol Paneli → Cloud Agents üzerinden yapılandırın.
| Ayar | Konum | Açıklama |
|---|---|---|
| Varsayılan Depo | Cursor Kontrol Paneli | Proje deposu yapılandırılmadığında kullanılan ana depo |
| Varsayılan Model | Cursor Kontrol Paneli | Bulut ajanları için yapay zekâ modeli |
| Temel Dal | Cursor Kontrol Paneli | PR'lerin oluşturulacağı dal (genellikle main veya develop) |
Yapılandırma seçenekleri
Cloud Agent davranışını çeşitli yöntemlerle yapılandırabilirsiniz:
Sorun açıklaması veya yorumlar: Örneğin, [anahtar=değer] söz dizimini kullanın:
@cursor please fix [repo=anysphere/everysphere]@cursor implement feature [model=claude-3.5-sonnet] [branch=feature-branch]
Sorun etiketleri: Üst etiketin yapılandırma anahtarı, alt etiketin ise değer olduğu bir üst-alt etiket yapısı kullanın.
Proje etiketleri: Sorun etiketleriyle aynı üst-alt yapıyı proje düzeyinde uygulayın.
Desteklenen yapılandırma anahtarları:
repo: Hedef depoyu belirtin (ör.owner/repository)branch: PR oluşturmak için temel dalı belirtinmodel: Kullanılacak yapay zekâ modelini belirtin
Depo seçimi
Cursor, üzerinde çalışacağı depoyu aşağıdaki öncelik sırasına göre belirler:
- Sorun açıklaması/yorumlar: Sorun metninde veya yorumlarda
[repo=owner/repository]söz dizimi - Sorun etiketleri: İlgili Linear sorununa eklenen depo etiketleri
- Proje etiketleri: Linear projesine eklenen depo etiketleri
- Varsayılan depo: Cursor kontrol paneli ayarlarında belirtilen depo
Depo etiketlerini ayarlama
Linear'da depo etiketleri oluşturmak için:
- Linear çalışma alanınızda Ayarlar'a gidin
- Etiketler'e tıklayın
- Yeni grup'a tıklayın
- Gruba "repo" adını verin (büyük/küçük harf duyarlı değildir; tam olarak "repo" olmalıdır, "Repository" veya başka bir varyasyon olmamalıdır)
- Bu grupta,
owner/repobiçimini kullanarak her depo için etiket oluşturun
Ardından bu etiketleri, Cloud Agent'ın hangi depoda çalışacağını belirtmek için issue'lara veya projelere atayabilirsiniz.
Gelişmiş özellikler
Triage kuralları (Gelişmiş)
Sorunları otomatik olarak Cursor'a devretmek için Linear'da otomasyon kuralları oluşturun:
- Linear proje ayarlarına gidin
- Triage kurallarına gidin
- Otomatik olarak şunları yapan kurallar oluşturun:
- Belirli etiketleri ekleme
- Sorunları Cursor'a atama
- Koşullara göre Cloud Agents'ı tetikleme
Triage kuralları, şu anda bazı sınırlamalara sahip gelişmiş bir özelliktir. Linear, kuralların tetiklenmesi için bir insan atanmış kişi gerektirir; ancak bu gereklilik gelecekteki güncellemelerde kaldırılabilir.
Yardım alma
Destekle iletişime geçerken agent etkinliğini kontrol edin ve istek kimliklerini ekleyin.
Geri bildirim
Geri bildiriminizi Linear yorumları veya Cursor kontrol panelinizdeki destek kanalları üzerinden paylaşın.