Paralel Ajanları Gönderme

Genel Bakış

Görevleri izole bağlamla uzmanlaşmış ajanlarına devredersiniz. Talimatlarını ve bağlamını dikkatli bir şekilde hazırlayarak, onların odaklanmış kalmasını ve görevlerini başarmasını sağlarsınız. Asla oturumunuzun bağlamını veya geçmişini miras almamalıdırlar — tam olarak ihtiyaç duydukları şeyi siz oluşturursunuz. Bu aynı zamanda koordinasyon çalışması için kendi bağlamınızı korur.

Birden fazla ilişkisiz hatanız olduğunda (farklı test dosyaları, farklı alt sistemler, farklı hatalar), bunları sırayla araştırmak zaman kaybeder. Her araştırma bağımsızdır ve paralel olarak gerçekleştirilebilir.

Temel ilke: Bağımsız her sorun alanı için bir ajan gönderin. Onları eşzamanlı olarak çalışmaya bırakın.

Ne Zaman Kullanılır

digraph when_to_use {
    "Multiple failures?" [shape=diamond];
    "Are they independent?" [shape=diamond];
    "Single agent investigates all" [shape=box];
    "One agent per problem domain" [shape=box];
    "Can they work in parallel?" [shape=diamond];
    "Sequential agents" [shape=box];
    "Parallel dispatch" [shape=box];

    "Multiple failures?" -> "Are they independent?" [label="yes"];
    "Are they independent?" -> "Single agent investigates all" [label="no - related"];
    "Are they independent?" -> "Can they work in parallel?" [label="yes"];
    "Can they work in parallel?" -> "Parallel dispatch" [label="yes"];
    "Can they work in parallel?" -> "Sequential agents" [label="no - shared state"];
}

Kullanın:

3+ test dosyası farklı kök nedenlerle başarısız olduğunda
Birden fazla alt sistem bağımsız olarak bozulduğunda
Her sorun diğerlerinden bağlam olmadan anlaşılabilir olduğunda
Araştırmalar arasında paylaşılan durum olmadığında

Kullanmayın:

Hatalar ilişkili olduğunda (birini düzeltmek diğerlerini düzeltebilir)
Tam sistem durumunu anlamanız gerektiğinde
Ajanlar birbirini etkileyeceğinde

Desen

1. Bağımsız Alanları Tanımla

Hataları ne kırıldığına göre grupla:

Dosya A testleri: Araç onay akışı
Dosya B testleri: Toplu iş tamamlanma davranışı
Dosya C testleri: İptal işlevi

Her alan bağımsızdır - araç onayını düzeltmek iptal testlerini etkilemez.

2. Odaklanmış Ajan Görevleri Oluştur

Her ajan alır:

Spesifik kapsam: Bir test dosyası veya alt sistem
Açık amaç: Bu testleri geçmesini sağla
Kısıtlamalar: Başka kod değiştirme
Beklenen çıktı: Bulduklarınız ve düzelttiğiniz şeylerin özeti

3. Paralel Olarak Gönder

Aynı cevap içinde üç alt ajan göndermesini yapın — paralel çalışırlar:

Subagent (general-purpose): "Fix agent-tool-abort.test.ts failures"
Subagent (general-purpose): "Fix batch-completion-behavior.test.ts failures"
Subagent (general-purpose): "Fix tool-approval-race-conditions.test.ts failures"
# All three run concurrently.

Bir cevap içinde birden fazla gönderim = paralel yürütme. Bir cevap başına bir tane = sırayla.

4. İnceleme ve Entegrasyon

Ajanlar döndüğünde:

Her özeti okuyun
Düzeltmelerin çakışmadığını doğrulayın
Tam test paketini çalıştırın
Tüm değişiklikleri entegre edin

Ajan İstemi Yapısı

İyi ajan istekleri:

Odaklanmış - Bir açık sorun alanı
Kendi kendine yeterli - Sorunu anlamak için gereken tüm bağlam
Çıktı hakkında spesifik - Ajan ne döndürmelidir?

Fix the 3 failing tests in src/agents/agent-tool-abort.test.ts:

1. "should abort tool with partial output capture" - expects 'interrupted at' in message
2. "should handle mixed completed and aborted tools" - fast tool aborted instead of completed
3. "should properly track pendingToolCount" - expects 3 results but gets 0

These are timing/race condition issues. Your task:

1. Read the test file and understand what each test verifies
2. Identify root cause - timing issues or actual bugs?
3. Fix by:
   - Replacing arbitrary timeouts with event-based waiting
   - Fixing bugs in abort implementation if found
   - Adjusting test expectations if testing changed behavior

Do NOT just increase timeouts - find the real issue.

Return: Summary of what you found and what you fixed.

Yaygın Hatalar

❌ Çok geniş: "Tüm testleri düzelt" - ajan kaybolur ✅ Spesifik: "agent-tool-abort.test.ts'i düzelt" - odaklanmış kapsam

❌ Bağlam yok: "Yarış durumunu düzelt" - ajan nerede olduğunu bilmez ✅ Bağlam: Hata mesajlarını ve test adlarını yapıştırın

❌ Kısıtlama yok: Ajan her şeyi refactor edebilir ✅ Kısıtlamalar: "Üretim kodunu DEĞIŞTIRME" veya "Yalnızca testleri düzelt"

❌ Muğlak çıktı: "Düzelt" - ne değiştiğini bilmezsiniz ✅ Spesifik: "Kök nedeni ve değişikliklerin özetini döndür"

Ne Zaman Kullanılmaz

İlişkili hatalar: Birini düzeltmek diğerlerini düzeltebilir - önce birlikte araştırın Tam bağlam gerekli: Anlama için tüm sistemi görmek gereklidir Keşifsel hata ayıklama: Ne kırıldığını henüz bilmiyorsunuz Paylaşılan durum: Ajanlar birbirini etkileyebilir (aynı dosyaları düzenleme, aynı kaynakları kullanma)

Oturumdan Gerçek Örnek

Senaryo: Ana refactoring sonrası 3 dosya genelinde 6 test hatası

Hatalar:

agent-tool-abort.test.ts: 3 hata (zamanlama sorunları)
batch-completion-behavior.test.ts: 2 hata (araçlar çalışmıyor)
tool-approval-race-conditions.test.ts: 1 hata (yürütme sayısı = 0)

Karar: Bağımsız alanlar - iptal mantığı toplu tamamlanmadan ayrı, ıraksallık koşullarından ayrı

Gönderim:

Agent 1 → Fix agent-tool-abort.test.ts
Agent 2 → Fix batch-completion-behavior.test.ts
Agent 3 → Fix tool-approval-race-conditions.test.ts

Sonuçlar:

Agent 1: Zaman aşımlarını olay tabanlı beklemeyle değiştirdi
Agent 2: Olay yapısı hatasını düzeltti (threadId yanlış yerde)
Agent 3: Zaman uyumsuz araç yürütmesinin tamamlanmasını beklemek için eklendi

Entegrasyon: Tüm düzeltmeler bağımsız, çatışma yok, tam test paketi yeşil

Kazanılan zaman: 3 sorun sırayla yerine paralel çözüldü

Temel Faydalar

Paralelleştirme - Birden fazla araştırma aynı anda gerçekleşir
Odaklanma - Her ajanın dar kapsamı, izlenecek daha az bağlam
Bağımsızlık - Ajanlar birbirini etkilemez
Hız - 3 sorun 1'in zamanında çözülür

Doğrulama