Skilly

Skilly spravujete ve webovém rozhraní na adrese /p/skills/ nebo v Nastavení → Pluginy → Skilly. Skill je opakovaně použitelný postup v Markdownu, který Elowen umí uplatnit v pozdějších konverzacích, například kontrolní seznam pro nasazení nebo formát reportu. Trvalé údaje ukládejte do paměti, kroky aktuálního požadavku do seznamu úkolů konverzace.

Elowen obvykle vidí název skillu, jeho popis a délku v řádcích. Když se úkol shoduje s popisem, načte celé pokyny podle názvu, nebo u dlouhého skillu postupně jen část.

Než začnete

Plugin Skilly musí být zapnutý. Každý účet potřebuje, aby mu administrátor přidělil Skilly v části Uživatelé → účet → Povolené pluginy → Spravovat; administrátoři si své přidělení mohou upravit sami. Skill, který přispívá jiný přidělitelný plugin, vyžaduje i přidělení toho pluginu. Zásady nástrojů účtu mohou načtení skillu i tak zakázat.

Pokud plugin nebo jeho nástroj SkillLoad není dostupný, skilly nelze objevit ani načíst. Viz Pluginy.

Použijte skill

Napište stručný popis, kdy se skill uplatní. To je spouštěč, který Elowen vidí, než postup načte:

Use when preparing the weekly customer-support report.

Zvažují se jen skilly viditelné pro aktuální tah. Skill označený jen ručně se automaticky nevybírá.

Chcete-li skill načíst výslovně, použijte jeho přesný název:

/skill:deploy-checklist

Funguje to ve webovém rozhraní i v CLI. Pomocí /skills skilly procházíte a načítáte je z nabídky. Skilly jen pro ruční použití lze také načíst výslovně.

Každý skill, který lze načíst výslovně, má i zkratku /<skill-name>, která ho načte stejně. Zkratka je dostupná jen pro názvy do 32 znaků, které se neshodují se zabudovaným příkazem; jinak použijte /skill:<name>.

Nástroje nabízejí stejné operace: ListSkills vypíše dostupné skilly, SkillLoad načte jeden podle přesného názvu, CreateSkill ho uloží na později a DeleteSkill odstraní vlastní skill, který smíte spravovat.

Změny přidělení, vlastnictví nebo zásad nástrojů platí od dalšího tahu. Změny zapnutých pluginů platí po restartu démona.

Vytvořte skill a spravujte ho

Skill vytvořte ve správci, nebo ho uložte voláním CreateSkill. Napří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 znaků: malá písmena, číslice a pomlčky, začínající písmenem nebo číslicí; je to zároveň identifikátor skillu.
• description: jeden řádek vysvětlující, kdy skill použít.
• content: pokyny a příklady v Markdownu.
• scope: personal, nebo instance.

Osobní skill je dostupný relacím svého vlastníka, nikoli jiným účtům. Skill instance je dostupný v celé instanci. Vytvoření skillu instance vyžaduje oprávnění administrátora. Osobní definice má přednost před definicí instance se stejným názvem; sdílená práce a práce bez účtu vidí jen způsobilé skilly instance.

Uložení osobního skillu s existujícím názvem ho aktualizuje. Skill nesmí zastínit vestavěný skill ani kolidující definici; pokud Elowen ohlásí kolizi, zvolte jiný název. Úspěšné změny platí od další zprávy, bez restartu.

Otevřete pracovní prostor Skilly na adrese /p/skills/ nebo přejděte do Nastavení → Pluginy → Skilly. Správce umožňuje přidávat a upravovat vlastní skilly, s oprávněním zvolit Jen pro mě nebo Pro všechny, zapnout či vypnout Nabízet agentovi automaticky a po potvrzení mazat vlastní skilly. Vestavěné skilly jsou jen pro čtení. Administrátoři spravují skilly instance a tam, kde to pravidla dovolují, i vlastní skilly jiných účtů; ostatní účty spravují své osobní skilly. Smazáním účtu se smažou i jeho osobní skilly.

Vypnutím Nabízet agentovi automaticky skill zůstane dostupný přes /skill:<name> a /<skill-name>, ale zmizí z automatického objevování.

Automatické učení skillů

Zapněte Učit se skilly z dokončené práce v části Účet → Paměť, pokud chcete, aby Elowen ukládala opakovaně použitelné postupy z dokončené osobní práce ve webovém rozhraní i v CLI. Přepínač je ve výchozím stavu vypnutý a je dostupný jen s aktivním recenzentem, nenulovým rozpočtem změn a oprávněním vytvářet skilly. Pod ním jeden tlumený řádek hlásí poslední kontrolu s jejím výsledkem a průběžnými součty a kolik úspěšných volání nástrojů zbývá do další, případně že žádná kontrola ještě neproběhla. Automatická kontrola neběží pro naplánované, interní, řízené tahy ani tahy platforem.

Kontrola prochází kontext dokončené konverzace se stejným modelem a účtem poskytovatele. Výchozí interval je 100 úspěšných volání nástrojů napříč způsobilými výměnami; výslovně uložený interval zůstává beze změny. Kontroly lze přeskočit, když přesný požadavek konverzace nelze bezpečně rozšířit, když není dostupná kapacita, nebo když týdenní využití předplatného účtu poskytovatele je alespoň 90 % nebo není známé. Počet zůstává nevyřízený do další způsobilé výměny. Kontrola nemá přístup k nástrojům a její využití modelu se účtuje Vašemu účtu, včetně čtení kontextu konverzace z mezipaměti.

Nově naučené skilly jsou běžné osobní skilly: patří jen Vašemu účtu a jsou dostupné jako každý skill, který uložíte sami, bez schvalovacího kroku. Chcete-li některý spouštět jen přes /skill:<name>, vypněte ve správci Nabízet agentovi automaticky. Jakákoli změna ve správci, včetně tohoto přepínače, odstraní původ od agenta a ochrání skill před pozdějšími automatickými změnami. Automaticky vylepšit lze jen osobní skill, který napsal agent, Vy jste ho dosud neupravili a v kontrolovaném tahu se úspěšně načetl; vestavěné, sdílené ani ručně psané či upravené skilly se nikdy nemění.

Administrátor v Nastavení → <jméno asistenta> AI → Doba běhu určuje, kolik úspěšných volání nástrojů jedna výměna potřebuje, aby se počítala (Nejméně volání nástrojů pro kontrolu skillů), jak často kontrola běží (Kontrola skillů po každých N voláních nástrojů) a kolik změn smí jedna kontrola provést (Nejvyšší počet změn skillů na jednu výměnu). Plugin Skilly každý návrh ověří; jeho omezení popisuje návod k pluginu. Paměť ukládá fakta i nadále odděleně.

Formát souboru skillu

Skill může být jeden soubor Markdownu, nebo adresář se souborem SKILL.md a volitelnými podpůrnými soubory:

deploy-checklist.md

deploy-checklist/
  SKILL.md
  references/
  scripts/

Soubor skillu začíná frontmatterem 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 potřeba pro automatické objevování. Bez něj lze skill načíst podle přesného názvu, ale Elowen zapíše varování. Přidáním disable-model-invocation: true omezíte skill jen na ruční použití. Relativní cesty v pokynech se u adresářového skillu řeší z jeho vlastní složky; samostatný soubor skillu žádný podpůrný adresář nemá, takže nemůže odkazovat na soubory vedle sebe.

Vlastnictví a bezpečnost

Skilly mohou pocházet z pluginu Skilly nebo z jiného zapnutého pluginu. Dostupný katalog i načítač uplatňují stejné kontroly účtu, přidělení a zásad nástrojů.

Podpůrné soubory skillu musí zůstat uvnitř jeho registrovaného adresáře. Chybějící, nečitelné nebo unikající cesty jsou odmítnuty. Do skillu neukládejte tajné údaje a nepoužívejte ho jako náhradu řízení přístupu; oprávnění Projektu, nástrojů a pluginů platí dál.

Řešení potíží se skilly

• Žádné skilly ani nabídka: zapněte plugin Skilly a zkontrolujte přidělení pluginu účtu.
• Chybí skill od pluginu: ověřte, že je plugin zapnutý, případně přidělený, a že skill zaregistroval.
• Skill se nikdy nevybere automaticky: vylepšete jeho popis a ujistěte se, že je Nabízet agentovi automaticky zapnuté.
• /skill:<name> selže: pomocí ListSkills nebo /skills ověřte přesný název a dostupnost.
• Chybí nový nebo upravený skill: změny se projeví od další zprávy; běžící tah se nepřepisuje.

Další: Integrace MCP