Sub-agents derinlemesine — 16 front-matter alanı
Resmi sub-agent şeması, model seçimi, tool kısıtı, color, when-to-trigger.
Öğreneceklerin
- 16 alanın hangisinin ne işe yaradığını bil
- Doğru model + tool seçimini yap
- Trigger description'ı net yaz
Sub-agent yazmak markdown + YAML frontmatter işidir. Frontmatter alanlarını bilmek = davranışı kontrol etmek.
16 alan
| Alan | Tip | Ne işe yarar |
|---|---|---|
name | string | Komut + dispatch isimlendirmesi (kebab-case) |
description | string | ”Use when…” ile başlayan trigger açıklaması |
tools | string | Virgülle ayrılmış tool listesi (örn. Read, Grep, Bash) |
model | string | opus, sonnet, haiku veya tam model id |
color | string | UI’da chip rengi (blue, purple, green…) |
proactive | bool | True ise model trigger’a yaklaşmadan kendi karar verir |
disallowed_tools | string | Negatif liste (Edit hariç tut, vb.) |
parallel | bool | Aynı anda başka sub-agent’larla paralel çalışabilir mi |
confirm | bool | Dispatch öncesi onay sor |
output_format | string | markdown, json, text |
context_strategy | string | isolated (default) veya inherit |
max_turns | number | Sub-agent kaç turn çalışabilir |
system_prompt_extension | string | Ana sistem promptuna eklenecek kısa not |
tags | array | Filtreleme için etiket |
version | string | Schema migration için |
examples | array | ”Bu durumlarda kullan” örnekleri |
Model seçimi pratiği
opus— kompleks akıl yürütme (mimari karar, refactor planı)sonnet(default) — günlük review, explorationhaiku— hızlı, ucuz, tekrarlayan task’ler (formatting, sınıflandırma)
Trigger description için pattern
“Use when [SYMPTOM]"
"Especially use [CONDITION]"
"Skip [NEGATIVE_CASE]”
Promptun başına LSM’in (Last Sentence Marker) gibi açık tetikleyici koy. Belirsiz description = yanlış zamanlarda dispatch edilir.
Sıradaki
Custom commands tasarımı — sub-agent ile command nasıl birlikte çalışır.