Zručnosti
Modulárne know-how — priečinok s inštrukciami a podkladmi pre jednu úlohu.
Zručnosť je modulárny kus know-how, ktorý agent vie použiť. Oproti agentovi (jedna osoba so všeobecnými inštrukciami) je zručnosť úzko zameraná na jednu úlohu alebo postup.
Každá zručnosť je samostatný priečinok obsahujúci:
SKILL.md— čo zručnosť vie, kedy ju má agent použiť, ako s ňou pracovať.- Ďalšie súbory — šablóny, vzorové dokumenty, kontrolné zoznamy, referencie, ukážkové odpovede, skripty.
Prečo zručnosti
Bez zručností by ste museli písať dlhé inštrukcie do každého agenta znova a znova. Zručnosti to oddelia:
- Agent — štýl, rola, všeobecné pravidlá.
- Zručnosť — konkrétny postup pre konkrétnu úlohu.
Agent si sám vyberie správnu zručnosť podľa otázky. Vy napíšete jednu zručnosť, používajú ju všetci vaši agenti.
Vlastné vs. pluginové zručnosti
- Vlastné zručnosti — uložené vo vašom pracovnom adresári. Upravíte editorom vnútri CODEXISu.
- Zručnosti pluginov — dodané doplnkom. Aktualizujú sa centrálne.
Vytvoriť vlastnú zručnosť
V sekcii Zručnosti → Nová zručnosť:
- Meno a slug — používa sa na identifikáciu (agent ju bude volať podľa mena).
- Popis — kedy zručnosť použiť. Agent podľa tohto textu rozhoduje, či je zručnosť relevantná k dotazu.
- Inštrukcie (
SKILL.md) — aký postup dodržať. Štruktúrovaný markdown:- Kedy použiť
- Ako to urobiť krok za krokom
- Na čo dať pozor
- Vzorová odpoveď / formát
- Súbory — pripojené šablóny, referencie, dátové podklady.
Dobrý popis je kľúč
Agent v prvej fáze číta len description. Musí z neho rozpoznať, kedy
zručnosť použiť. Buďte konkrétni: „Pomáha zostaviť návrh zmluvy o dielo
podľa § 2586 OZ" bije „Pomáha so zmluvami".
Štruktúra priečinka
my-skill/
├─ SKILL.md # instrukce (povinné)
├─ template.md # šablona výstupu
├─ reference/
│ ├─ zakon.md
│ └─ vzor-prednesu.md
└─ examples/
└─ odpoved-ukazka.mdAko agent zručnosť používa
- Používateľ položí dotaz.
- Agent prechádza popismi dostupných zručností.
- Vyberie zručnosť, ktorej
descriptionnajviac zodpovedá. - Načíta si
SKILL.mda prípadné referenčné súbory. - Zareaguje podľa postupu.
Vy vidíte, ktorú zručnosť agent použil — v chate sa zobrazí ako badge.
Príklady zručností
- Rozbor zmluvy — extrakcia kľúčových ustanovení, identifikácia rizík, návrhy úprav.
- Draft odvolania — štruktúra podania, povinné náležitosti, citácie.
- Citácia judikatúry — správny formát sp. zn. ČR aj EÚ.
- Rešerš predpisu — nájsť pôvodné znenie + všetky novelizácie.
- Výpočet lehoty — vypočítať procesnú lehotu s ohľadom na sviatky.
Editácia a mazanie
Zmazaním vlastnej zručnosti sa odstráni celý priečinok vrátane súborov. Pluginové zručnosti miznú s odinštalovaním doplnku.