antrophiclove
← Kütüphaneye dön
0

Subagent yazma şablonu — ne zaman gerekir, ne zaman gerekmez

Kendi alt ajanını yazarken kopyalayacağın iskelet. Asıl değeri şurada: çoğu iş için subagent gereksizdir; hangi durumda gerçekten kazandırdığını da anlatıyor.

yazan kuscubasiece·8 Eylül 2026

Kaynak: Claude Code dokümantasyonu

Kurulum
mkdir -p .claude/agents && curl -sL https://www.antrophiclove.com/api/kaynak/subagent-yazma-sablonu-ne-zaman-gerekir-ne-zaman-gerekmez/raw -o .claude/agents/subagent-yazma-sablonu-ne-zaman-gerekir-ne-zaman-gerekmez.md

Hedef dosya: .claude/agents/subagent-yazma-sablonu-ne-zaman-gerekir-ne-zaman-gerekmez.md

.claude/agents/db-reviewer.md


name: db-reviewer description: Veritabanı şeması ve migration incelemesi. Şema değişikliği, index kararı ya da migration güvenliği sorulduğunda kullan. tools: Read, Grep, Glob, Bash(psql *) model: sonnet

Sen bir veritabanı incelemecisisin. Şu sırayla bak:

  1. Migration geri alınabilir mi? down yolu var mı?
  2. Kilitleme: ALTER TABLE canlıda tabloyu kilitler mi? Postgres'te ADD COLUMN ... DEFAULT eski sürümlerde tüm tabloyu yeniden yazar.
  3. Index: yeni sorgu deseni hangi index'i ister? Var olan index'lerle çakışıyor mu?
  4. Geri uyum: eski uygulama sürümü bu şemayla çalışır mı? (deploy sırası)
  5. Veri kaybı: DROP COLUMN veya tip daraltma var mı?

Bulguları "engelleyici / düzeltilmeli / not" olarak sınıfla. Kod yazma, yalnızca incele.


Subagent ne zaman kazandırır

  • İş kendi başına uzun bir bağlam istiyorsa (yüzlerce dosya okunacak) ve bu bağlamın ana konuşmayı doldurmasını istemiyorsan
  • Aynı işi farklı girdilerle paralel çalıştıracaksan
  • Farklı bir uzmanlık ve farklı bir araç kümesi gerekiyorsa

Ne zaman gereksiz

  • Tek dosyada tek değişiklik
  • Ana konuşmadaki bağlamı zaten kullanan iş — subagent o bağlamı görmez, her şeyi baştan anlatman gerekir
  • "Daha iyi olur" hissi; ölçmeden subagent eklemek yalnızca gecikme katar

tools alanı

Yazmıyorsan ajan tüm araçları devralır. İnceleme yapan bir ajana yazma aracı verme — yanlışlıkla düzeltmeye kalkar.