Skilly

Skilly spravujete vo webovom rozhraní na adrese /p/skills/ alebo v Nastavenia → Pluginy → Skilly. Skill je opakovane použiteľný postup v Markdownu, ktorý Elowen dokáže uplatniť v neskorších konverzáciách, napríklad kontrolný zoznam na nasadenie alebo formát reportu. Trvalé údaje ukladajte do pamäti, kroky aktuálnej požiadavky do zoznamu úloh konverzácie.

Elowen zvyčajne vidí názov skillu, jeho popis a dĺžku v riadkoch. Keď sa úloha zhoduje s popisom, načíta celé pokyny podľa názvu, alebo pri dlhom skille postupne len časť.

Než začnete

Plugin Skilly musí byť zapnutý. Každý účet potrebuje, aby mu administrátor pridelil Skilly v časti Používatelia → účet → Povolené pluginy → Spravovať; administrátori si svoje pridelenie môžu upraviť sami. Skill, ktorý prináša iný prideľiteľný plugin, vyžaduje aj pridelenie toho pluginu. Pravidlá nástrojov účtu môžu načítanie skillu aj tak zakázať.

Ak plugin alebo jeho nástroj SkillLoad nie je dostupný, skilly nemožno objaviť ani načítať. Pozrite Pluginy.

Použite skill

Napíšte stručný popis, kedy sa skill uplatní. To je spúšťač, ktorý Elowen vidí, kým postup načíta:

Use when preparing the weekly customer-support report.

Zvažujú sa len skilly viditeľné pre aktuálny tah. Skill označený len ručne sa automaticky nevyberá.

Ak chcete skill načítať výslovne, použite jeho presný názov:

/skill:deploy-checklist

Funguje to vo webovom rozhraní aj v CLI. Pomocou /skills skilly prechádzate a načítavate ich z ponuky. Skilly len na ručné použitie možno tiež načítať výslovne.

Každý skill, ktorý možno načítať výslovne, má aj skratku /<skill-name>, ktorá ho načíta rovnako. Skratka je dostupná len pre názvy do 32 znakov, ktoré sa nezhodujú so zabudovaným príkazom; inak použite /skill:<name>.

Nástroje ponúkajú rovnaké operácie: ListSkills vypíše dostupné skilly, SkillLoad načíta jeden podľa presného názvu, CreateSkill ho uloží na neskôr a DeleteSkill odstráni vlastný skill, ktorý smiete spravovať.

Zmeny pridelenia, vlastníctva alebo pravidiel nástrojov platia od ďalšieho tahu. Zmeny zapnutých pluginov platia po reštarte démona.

Vytvorte skill a spravujte ho

Skill vytvorte v správcovi alebo ho uložte volaním CreateSkill. Napríklad:

CreateSkill({
  name: "deploy-checklist",
  description: "Use before deploying a new service version.",
  content: "# Deployment checklist\\n\\n1. Run the focused tests.\\n2. Verify the health endpoint.",
  scope: "personal"
})

Nástroj vyžaduje:

• name: 2 až 64 znakov: malé písmená, číslice a pomlčky, začínajúce písmenom alebo číslicou; je to zároveň identifikátor skillu.
• description: jeden riadok vysvetľujúci, kedy skill použiť.
• content: pokyny a príklady v Markdownu.
• scope: personal, alebo instance.

Osobný skill je dostupný reláciám svojho vlastníka, nie iným účtom. Skill inštancie je dostupný v celej inštancii. Vytvorenie skillu inštancie vyžaduje oprávnenie administrátora. Osobná definícia má prednosť pred definíciou inštancie s rovnakým názvom; zdieľaná práca a práca bez účtu vidí len spôsobilé skilly inštancie.

Uloženie osobného skillu s existujúcim názvom ho aktualizuje. Skill nesmie zatieniť vstavaný skill ani kolidujúcu definíciu; ak Elowen ohlási kolíziu, zvoľte iný názov. Úspešné zmeny platia od ďalšej správy, bez reštartu.

Otvorte pracovný priestor Skilly na adrese /p/skills/ alebo prejdite do Nastavenia → Pluginy → Skilly. Správca umožňuje pridávať a upravovať vlastné skilly, s oprávnením zvoliť Len pre mňa alebo Pre všetkých, zapnúť či vypnúť Ponúkať agentovi automaticky a po potvrdení mazať vlastné skilly. Vstavané skilly sú len na čítanie. Administrátori spravujú skilly inštancie a tam, kde to pravidlá dovoľujú, aj vlastné skilly iných účtov; ostatné účty spravujú svoje osobné skilly. Zmazaním účtu sa zmažú aj jeho osobné skilly.

Vypnutím Ponúkať agentovi automaticky skill zostane dostupný cez /skill:<name> a /<skill-name>, ale zmizne z automatického objavovania.

Automatické učenie skillov

Zapnite Učiť sa skilly z dokončenej práce v časti Účet → Pamäť, ak chcete, aby Elowen ukladala opakovane použiteľné postupy z dokončenej osobnej práce vo webovom rozhraní aj v CLI. Prepínač je v predvolenom stave vypnutý a je dostupný len s aktívnym recenzentom, nenulovým rozpočtom zmien a oprávnením vytvárať skilly. Pod ním jeden tlmený riadok hlási poslednú kontrolu s jej výsledkom a priebežnými súčtami a koľko úspešných volaní nástrojov zostáva do ďalšej, prípadne že žiadna kontrola ešte neprebehla. Automatická kontrola nebeží pre naplánované, interné, riadené tahy ani tahy platforiem.

Kontrola prechádza kontext dokončenej konverzácie s rovnakým modelom a účtom poskytovateľa. Predvolený interval je 100 úspešných volaní nástrojov naprieč spôsobilými výmenami; výslovne uložený interval zostáva bez zmeny. Kontroly možno preskočiť, keď presnú požiadavku konverzácie nemožno bezpečne rozšíriť, keď nie je dostupná kapacita, alebo keď týždenné využitie predplatného účtu poskytovateľa je aspoň 90 % alebo nie je známe. Počet zostáva nevybavený do ďalšej spôsobilej výmeny. Kontrola nemá prístup k nástrojom a jej využitie modelu sa účtuje Vášmu účtu, vrátane čítania kontextu konverzácie z medzipamäti.

Novo naučené skilly sú bežné osobné skilly: patria len Vášmu účtu a sú dostupné ako každý skill, ktorý uložíte sami, bez schvaľovacieho kroku. Ak chcete niektorý spúšťať len cez /skill:<name>, vypnite v správcovi Ponúkať agentovi automaticky. Akákoľvek zmena v správcovi, vrátane tohto prepínača, odstráni pôvod od agenta a ochráni skill pred neskoršími automatickými zmenami. Automaticky vylepšiť možno len osobný skill, ktorý napísal agent, Vy ste ho zatiaľ neupravili a v kontrolovanom tahu sa úspešne načítal; vstavané, zdieľané ani ručne písané či upravené skilly sa nikdy nemenia.

Administrátor v Nastavenia → <názov asistenta> AI → Čas behu určuje, koľko úspešných volaní nástrojov jedna výmena potrebuje, aby sa počítala (Najmenej volaní nástrojov pre kontrolu skillov), ako často kontrola beží (Kontrola skillov po každých N volaniach nástrojov) a koľko zmien smie jedna kontrola vykonať (Maximum zmien skillov za výmenu). Plugin Skilly každý návrh overí; jeho obmedzenia popisuje návod k pluginu. Pamäť ukladá fakty aj naďalej oddelene.

Formát súboru skillu

Skill môže byť jeden súbor Markdownu alebo priečinok so súborom SKILL.md a voliteľnými podpornými súbormi:

deploy-checklist.md

deploy-checklist/
  SKILL.md
  references/
  scripts/

Súbor skillu začína frontmatterom YAML:

---
name: deploy-checklist
description: Use before deploying a new service version.
---

# Deployment checklist

1. Run the focused tests.
2. Verify the health endpoint.

Popis je potrebný na automatické objavovanie. Bez neho možno skill načítať podľa presného názvu, ale Elowen zapíše upozornenie. Pridaním disable-model-invocation: true obmedzíte skill len na ručné použitie. Relatívne cesty v pokynoch sa pri priečinkovom skille riešia z jeho vlastného priečinka; samostatný súbor skillu žiadny podporný priečinok nemá, takže nemôže odkazovať na súbory vedľa seba.

Vlastníctvo a bezpečnosť

Skilly môžu pochádzať z pluginu Skilly alebo z iného zapnutého pluginu. Dostupný katalóg aj načítač uplatňujú rovnaké kontroly účtu, pridelenia a pravidiel nástrojov.

Podporné súbory skillu musia zostať vnútri jeho registrovaného priečinka. Chýbajúce, nečitateľné alebo unikajúce cesty sú odmietnuté. Do skillu neukladajte tajné údaje a nepoužívajte ho ako náhradu riadenia prístupu; oprávnenia Projektu, nástrojov a pluginov platia ďalej.

Riešenie problémov so skillmi

• Žiadne skilly ani ponuka: zapnite plugin Skilly a skontrolujte pridelenie pluginu účtu.
• Chýba skill od pluginu: overte, že je plugin zapnutý, prípadne pridelený, a že skill zaregistroval.
• Skill sa nikdy nevyberie automaticky: vylepšite jeho popis a uistite sa, že je Ponúkať agentovi automaticky zapnuté.
• /skill:<name> zlyhá: pomocou ListSkills alebo /skills overte presný názov a dostupnosť.
• Chýba nový alebo upravený skill: zmeny sa prejavia od ďalšej správy; bežiaci tah sa neprepisuje.

Ďalej: Integrácia MCP