Frontmatter agenta | Ekosistem NativeAI Hub

Datoteke agentov so v mapi ~/.claude/agents/ kot datoteke .md. YAML frontmatter se MORA začeti v prvi vrstici (brez prazne vrstice pred prvim ---). Polja: name (kebab-case), description (niz v narekovajih s primeri), model (opus/sonnet/haiku), color (green/blue/cyan/red/yellow/magenta), tools (z vejicami ločena imena orodij). Preostanek datoteke je sistemski prompt agenta.

01Kaj počne

Osebna izkaznica agenta

Vsak prilagojen agent je datoteka Markdown z YAML frontmatter med ločiloma --- na vrhu. Frontmatter opredeljuje, kdo je agent (ime, opis), kaj zna (orodja), kako razmišlja (model) in kako je videti (barva). Telo pod frontmatterjem vsebuje sistemski prompt, ki oblikuje osebnost in strokovnost agenta.

Ključna zahteva: prvi --- mora biti v prvi vrstici datoteke. Če je pred njim prazna vrstica, se agent tiho ne naloži. Ni sporočila o napaki; preprosto se ne pojavi na vašem seznamu agentov.

02Pregled polj

🏷️

nameIdentifikator v obliki kebab case (male črke, besede ločene z vezaji). Tako se sklicujete na agenta in ga prikličete. Primeri: <code>code-reviewer</code>, <code>email-marketing</code>, <code>stock-analyst</code>. Naj bo kratek in opisen.

📝

descriptionPove Claude Code, kdaj naj tega agenta samodejno aktivira. Zapišite ga v dvojne narekovaje, za nove vrstice uporabite <code>\n</code> in vključite primere uporabniških sporočil, da lahko Claude pravemu agentu pripiše pravo zahtevo. Bolj ko so vaši primeri natančni, boljše je usmerjanje.

🧠

modelKateri model Claude poganja tega agenta. Nastavite <code>opus</code> za zahtevno sklepanje in arhitekturo, <code>sonnet</code> za uravnotežene vsakodnevne naloge ali <code>haiku</code> za hitre, preproste operacije. Izbira modela neposredno vpliva na zmožnosti agenta in hitrost odzivov.

🎨

colorBarva prikaza v terminalu, ko je ta agent aktiven. Možnosti: <code>green</code>, <code>blue</code>, <code>cyan</code>, <code>red</code>, <code>yellow</code>, <code>magenta</code>. Z barvo agente med sejami vizualno ločite na prvi pogled.

🔧

toolsZ vejicami ločen seznam orodij, do katerih ima ta agent dostop. Uporabite <code>Read, Grep, Glob</code> za agente samo za branje (pregledovalci, analitiki). Dodajte <code>Write, Edit, Bash</code> za agente, ki spreminjajo. Omejevanje orodij prepreči, da bi agent počel stvari zunaj svoje vloge.