Přihlásit seDomluvit prezentaci

Kapitola 2.20

Dovednosti

Jak napsat, otestovat a publikovat dovednost v modulu Skills Engine, kde se zobrazí po spuštění a jak se liší dovednosti v manifestu pluginu. Obsahuje vypracovaný přehled přidělování kotvišť pro organizaci Harrow Port Authority.

Tato stránka byla přeložena pomocí AI z anglického originálu. Pokud je cokoliv nejasné, směrodatná je anglická stránka. Přečíst tuto stránku v angličtině

17 min čtení

Tomás Reilly, platformní inženýr v Harrow Port Authority, se mě minulý měsíc zeptal, proč jeho plánovači kotvišť dostali pokaždé jinou odpověď, když se asistenta zeptali „kdo je zítra na kterém kotvišti a co se přesunulo?“. Odpověď zněla, že asistentovi nikdo neřekl, jak vypadá dobrá odpověď. Dovednost v Skills Engine to spravila za odpoledne: plánovači nyní dostávají pokaždé stejné třídílné shrnutí, nejprve s tabulkou kotvišť, pod ní se změnami od posledního plánu a nakonec s kolizemi. Tato kapitola prochází tuto dovednost od začátku do konce a poté se věnuje druhému druhu dovednosti, té, která žije v manifestu pluginu.

Dva druhy dovedností

Nexus používá slovo „dovednost“ (skill) pro dvě různé věci a každá se vytváří jinak.

Dovednost ve Skills Engine Dovednost v manifestu
Co to je Balíček SKILL.md v knihovně dovedností Typovaný řádek v poli skills[] pluginu
Kdo ji píše Kdokoli s oprávněním, v tvůrci nebo ve vlastním editoru Vývojář, uvnitř pluginu
Co obsahuje Instrukce, nástroje, které může volat, volitelné soubory a skripty Vstupní a výstupní schéma, úroveň (tier) a pole, která tato úroveň vyžaduje
Jak se dostane na platformu Zvalidována, nahrána a publikována do Skills Engine Zkompilována z manifestu a synchronizována do registru dovedností
Co ji spouští Asistent, agenti, workflow, tlačítka AI (umělé inteligence), Claude Code Dispečink UNO (workflow engine)
Typické použití „Shrň plán kotvišť pokaždé stejným způsobem“ „Spusť náš propagátor oběžné dráhy na tomto přeletu“

Zbytek kapitoly je důsledně rozlišuje. Pokud odstavec uvádí samostatně „dovednost“, jde o dovednost v Skills Engine.

Část 1: dovednosti modulu Skills Engine

Co je to dovednost

Dovednost je složka. Její SKILL.md říká, k čemu dovednost slouží a jak úkol provést; vedle něj leží veškeré soubory, které úkol potřebuje, a skripty, které spouští. Engine načítá dovednost ve třech vrstvách: název a popis vždy, instrukce, když si úkol dovednost vyžádá, a soubory pouze tehdy, když je potřebuje konkrétní krok. Proto může instalace obsahovat dvě stě dovedností a neplatit za ně téměř nic, dokud se některá nepoužije.

skills/<slug>/
├── SKILL.md      # required: YAML frontmatter, then the instructions
├── skill.yaml    # optional: engine metadata (triggers, aliases, tags, capabilities)
└── scripts/      # optional: bundled with the skill as components

Název adresáře se musí shodovat se slugem dovednosti. Neshoda vyvolá validační varování a vyplatí se ji opravit, protože podle slugu knihovna páruje nahrávaný balíček s existující dovedností.

Úvodní metadata SKILL.md

Úvodní metadata (frontmatter) jsou v jazyce YAML mezi dvěma řádky --- na začátku souboru. Formát vyžaduje tři pole. Samotná validace blokuje jen několik věcí: chybějící název nebo popis a již obsazený slug nebo typ úlohy. Vše ostatní hlásí jako varování.

Pole Typ Povinné Co obsahuje
name řetězec ano Jedinečný identifikátor v zápisu kebab-case
description řetězec ano Co dovednost dělá, nejvýše 500 znaků. Čtou jej knihovna a párovací algoritmus (matcher), proto jej pište pro čtenáře, který se rozhoduje, zda jde o správnou dovednost
allowed-tools string nebo list ano Nástroje, které může dovednost volat. Může pouze zúžit seznam povolených nástrojů (allow-list) toho, kdo ji spouští
triggers list ne Lomítkové příkazy, které dovednost vyvolají přímo
capabilities list ne Strukturované schopnosti, každá s name, description a volitelně input_schema, output_schema a examples
version řetězec ne Sémantická verze; 1.0.0, pokud je vynechána
visibility řetězec ne private, team nebo public
status řetězec ne draft, testing nebo published

Instrukce udržujte pod hranicí přibližně 5 000 tokenů. Buďte konkrétní a uvádějte příklady. Každá dovednost by měla dělat dobře jednu věc; pokud se přistihnete, že píšete „a také“, máte pravděpodobně dvě dovednosti.

skill.yaml

skill.yaml nese to, co engine potřebuje pro vyhledávání a knihovnu, aby SKILL.md zůstal čitelný. Mezi pole, která engine čte, patří name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools a capabilities. Schopnost může obsahovat query_patterns, tedy formulace, které by jí měl párovací algoritmus posílat. Existují také nápovědy pro vlastní rozpočtování enginu: complexity, estimated_tokens a required_services.

scripts/

Cokoli pod scripts/ je beze změny přibaleno k dovednosti jako komponenta. Skript se spouští, nikdy se nenačítá do kontextu modelu a běží v sandboxu. Použijte jej, když krok představuje výpočty nebo parsování, které by model neměl dělat zpaměti.

Viditelnost a stav

Viditelnost určuje, kdo může dovednost najít: private jste vy, team je váš tým a public jsou všichni v organizaci, které knihovna slouží. V konzoli stejná volba zní „Pouze já“, tým jako „Celní přepážka“ nebo celá organizace, a dovednost lze také nasdílet do doménového balíčku prostřednictvím vlastního schvalovacího procesu daného balíčku.

Stav udává, v jaké fázi životního cyklu se dovednost nachází.

Stav Význam
draft Rozpracováno; nelze vyhledat
testing Probíhá validace, s omezeným přístupem
published K dispozici pro obecné použití
deprecated Nahrazeno; na cestě k vyřazení

Jakmile je verze publikována, už se nikdy nemění. V konzoli jsou „live“, „canary“ a „shadow“ štítky na verzích a přepnutí zpět na starší verzi pouze přesune štítek. Právě probíhající běhy se dokončí na verzi, se kterou začaly.

Nová dovednost · 2 Instrukce a nástroje
Nová dovednost · 2 Instrukce a nástroje
Druhý krok tvůrce ukazuje návrh SKILL.md, soubory vedle něj a kdy se každý z nich načítá, a nástroje, které může dovednost volat. Kontrolní dovednosti není nabídnut žádný nástroj, který zapisuje, a dovednost může pouze zúžit seznam povolených nástrojů spouštějícího.

Od složky k živé dovednosti

Pět skriptů npm v repozitáři Skills Engine přenese dovednost z vašeho editoru do knihovny a ověří, že tam dorazila.

Příkaz Co dělá
npm run skill:validate skills/<slug> Provede lint balíčku. Publikování vyžaduje nula chyb
npm run skill:upload skills/<slug> Zvaliduje a publikuje v jednom kroku; idempotentní
npm run skill:upload skills/<slug> --dry-run Zvaliduje a vypíše plán bez jakéhokoli zápisu
npm run skill:publish -- --dry-run skills/<slug> Nízkoúrovňové publikování na pozadí nahrávání, stejná pipeline
npm run skill:reconcile Porovná dovednosti ve vašem repozitáři s tím, co obsahuje knihovna a registr dovedností
npm run skill:live:verify Zkontroluje publikovanou dovednost od začátku do konce na běžící instalaci

Publikování zapíše dva záznamy a na obou záleží. Jedním je samotná dovednost s jejím tělem SKILL.md, schopnostmi, komponentami a záznamem kvality; ten čte knihovna, vyhledávání a párovací algoritmus. Druhým je záznam v registru, vůči kterému workflow engine vyhodnocuje odeslání (dispatch). Dovednost, která dorazila pouze do registru, sice běží, ale v knihovně je neviditelná, dokud ji nenahrajete.

Publikování je idempotentní. Nezměněná dovednost neprovede žádnou operaci (no-op) a existující dovednost je spárována podle svého slugu a aktualizována na místě, nikdy se nevytváří znovu. Pokud nahrajete stejné bajty jako u verze, která je již publikována, dostanete zpět tuto verzi s CONTENT_HASH_ALREADY_PUBLISHED, nikoli duplikát.

skill:reconcile projde dovednosti vašeho repozitáře oproti knihovně, registru a inventáři workflow enginu a nahlásí vše, co existuje na jednom místě a na jiném ne. skill:live:verify jde na běžící instalaci ještě dál: oba záznamy existují a odkazují na sebe se stejným hashem obsahu, zkušební odeslání (dry-run dispatch) typu úlohy dané dovednosti je přijato, dovednost se zobrazuje v seznamu i detailu knihovny, lze ji vyvolat a auditní stopa propojuje publikování, odeslání a běh pomocí slugu a ID požadavku.

Z pracovní stanice se nahrávání dostane ke znalostní službě instalace, nexus-graphrag, přes přesměrování portů (port-forward) a vyžaduje v prostředí servisní klíč Skills Engine. Načtěte klíč bez jeho vypsání na obrazovku:

kubectl -n nexus port-forward svc/nexus-graphrag 8090:8090
read -rs GRAPHRAG_SKILLS_ENGINE_SERVICE_KEY
export GRAPHRAG_SKILLS_ENGINE_SERVICE_KEY
GRAPHRAG_URL=http://localhost:8090 npm run skill:upload skills/berth-allocation-summary

Uvnitř clusteru, v úloze pipeline, se výchozí adresa přeloží sama a GRAPHRAG_URL není potřeba. Získejte klíč prostřednictvím vlastního procesu správy tajemství vaší organizace. Nikdy nepatří do repozitáře, historie vašeho shellu ani do výstupu příkazu.

Testy, schválení a spuštění do ostrého provozu

Dovednost dorazí do knihovny jako návrh a tvůrce ji tam drží, dokud neprojdou tři věci.

Kontrola Co dělá
Testovací případy Každý případ musí projít, než může jít dovednost ke schválení. Případ lze odebrat pouze s uvedením důvodu, který schvalovatelé uvidí.
Zkušební běh ve stínovém režimu (shadow) Dovednost běží na minulé práci, kde odpovědi nikdo nevidí, a její výsledky se porovnávají s tím, jak v dané době rozhodl člověk.
Slepá revize modelem z jiné rodiny Hledá vynechanou kontrolu, vymyšlený zdroj a podstrčenou instrukci, kterou se dovednost řídila, ačkoliv neměla.

Poté následuje schválení. Dovednost, která přidává nástroj provádějící zápis, je pozdržena, dokud ji neschválí dva lidé pomocí svých přístupových klíčů (passkeys), přičemž osoba, která ji navrhla, nemůže být jedním z nich (PUBLISH_NEEDS_APPROVAL). Poté přejde do ostrého provozu ve stínovém režimu (shadow), následně v kanárkovém režimu (canary) pro jednu jednotku za pojmenovanými branami (gates) a nakonec pro všechny. Pokud některá kanárková brána není splněna, kanárkový provoz se sám zastaví a všichni zůstávají na předchozí verzi; předčasné uvolnění pro všechny vyžaduje uvedení důvodu a druhého schvalovatele (CANARY_GATE_NOT_MET).

V edici Community jsou tvůrce, knihovna, verze i testy plně k dispozici a vlastník publikuje sám, jakmile testy projdou. Kanárkový provoz, schvalování dvěma osobami, synchronizace pluginů a slučování duplikátů přicházejí s edicí Enterprise.

Nová dovednost · 4 Publikování
Nová dovednost · 4 Publikování
Publikování ukazuje, proč je dovednost pozdržena, kdo musí souhlasit a jak přechází do ostrého provozu: schváleno, ve stínovém režimu, v kanárkovém režimu za pojmenovanými branami a poté pro všechny. Navrhovatel nemůže schválit vlastní změnu a poslední verze zůstává připravena pro případné přepnutí zpět.

Kde se dovednosti objevují

Stejná publikovaná dovednost se k lidem dostává na pěti místech.

  1. Asistent spáruje požadavek s dovedností podle jejího popisu, spouštěčů (triggers) a vzorů dotazů a řídí se instrukcemi dovednosti.
  2. Agenti a workflow volají dovednosti jako jednotlivé kroky. Krok workflow jmenuje dovednost; běh zaznamená, kterou verzi použil.
  3. Tlačítka AI na obrazovkách spouštějí každé jednu dovednost. Administrátor může otevřít „O tomto tlačítku“, aby viděl, jakou dovednost tlačítko spouští, co čte a kdo tlačítko naposledy změnil, a může tlačítko vypnout, aniž by zasahoval do samotné dovednosti.
  4. Vaše IDE (integrované vývojové prostředí) a Claude Code přistupují ke knihovně přes Workbench a třináct nástrojů MCP (Model Context Protocol): mimo jiné list_skills, get_skill, match_prompt, discover_skills, invoke_skill, record_execution, create_skill, import_skill, get_generation_job a sync_skills_local. Každé volání běží pod identitou osoby, která jej spustila, v rámci jejího seznamu povolených nástrojů.
  5. Samotná knihovna dovedností, kde lidé procházejí, spouštějí a navrhují změny dovedností a administrátoři vidí vlastníka, uživatele, běhy a náklady každé dovednosti.

Ať už dovednost spouští cokoli, dovednost nemůže rozšířit oprávnění spouštějícího: volá pouze nástroje v rámci seznamu povolených nástrojů spouštějícího a čte pouze to, co tato osoba smí otevřít (SKILL_CANNOT_WIDEN_TOOLS). Běh bez trasy k modelu je odmítnut, nikoli odhadnut (SKILLS_ENGINE_BINDING_MISSING); trasu vybírá dispečer z vlastního nastavení modelů organizace.

O tomto tlačítku
O tomto tlačítku
Okno O tomto tlačítku ukazuje dovednost, kterou tlačítko AI spouští, tři zdroje, které čte, kdo ji napsal a zrevidoval, a co změnila nejnovější verze. Vypnutím tlačítka jej odstraníte všude najednou; dovednost i všechny minulé odpovědi zůstávají.

Praktický příklad: shrnutí přidělení kotvišť pro Harrow

Plánovači v Harrow již měli na svém seznamu povolených nástrojů dva nástroje pouze pro čtení z vlastního pluginu Harrow pro plánování kotvišť: berth-plan.read vrací plán pro dané datum a vessel-call.read vrací zastávku plavidla s jeho oknem příjezdu a délkou. Dovednost nepotřebuje nic dalšího. Nikdy nezapisuje, takže nikdy nepotřebuje dva schvalovatele.

---
name: berth-allocation-summary
description: Summarise tomorrow's berth plan at Harrow for the planning desk. Use when someone asks who is on which berth, what moved since the last plan, or where two calls clash.
allowed-tools: berth-plan.read, vessel-call.read
triggers:
  - /berth-summary
capabilities:
  - name: summarise_berth_plan
    description: The berth table, the changes since the last plan and any clashes, for one date
version: 1.0.0
visibility: team
status: draft
---

# Berth allocation summary

## When to use
A planner asks about the berth plan for a date, or asks what changed.

## Steps
1. Read the plan for the date with berth-plan.read. If no date is given, use tomorrow.
2. For each call on the plan, read it with vessel-call.read.
3. Write the berth table first: berth, vessel, arrival window, length overall.
4. Then list what moved since the previous plan, one line per change, with the reason the plan records.
5. Then list clashes: two calls whose windows overlap on one berth, or a vessel longer than the berth.
6. Cite the plan's version for every line. Never guess a time the plan doesn't give.

## Output
Three headed sections, in this order: Berths, Changes, Clashes. Write "No clashes" when there are none.

Soubor skill.yaml vedle ní dává knihovně zobrazovaný název, kategorii a formulace, které by sem měl párovací algoritmus směrovat:

# skill.yaml, beside SKILL.md
name: berth-allocation-summary
display_name: "Berth allocation summary"
version: "1.0.0"
status: draft
visibility: team
category: operations
tags:
  - berths
  - planning
triggers:
  - "/berth-summary"
allowed_tools:
  - berth-plan.read
  - vessel-call.read
capabilities:
  - name: "summarise_berth_plan"
    description: "Berth table, changes since the last plan and clashes, for one date"
    query_patterns:
      - "who is on which berth tomorrow"
      - "what moved on the berth plan"
      - "any berth clashes on *"

Poté příkazy z kořenového adresáře repozitáře:

npm run skill:validate skills/berth-allocation-summary
npm run skill:upload skills/berth-allocation-summary --dry-run
npm run skill:upload skills/berth-allocation-summary

Tomás přidal v tvůrci šest testovacích případů: běžný den, den se zpožděným příjezdem, který posunul dvě zastávky, den se skutečnou kolizí, datum, pro které zatím neexistuje plán, plavidlo příliš dlouhé pro své kotviště a požadavek, který se snažil přimět dovednost navrhnout nové kotviště (to by dělat neměla; nemá žádný nástroj, který zapisuje). Zkušební běh přehrál dvacet minulých plánů ve stínovém režimu. Jakmile případy prošly, revizor z plánovacího oddělení dovednost schválil a ta přešla do ostrého provozu pro plánovací tým. Asistent nyní odpovídá na otázku pokaždé ve stejném tvaru a tlačítko AI plánovačů na stránce plánu kotvišť spouští tutéž dovednost.

Část 2: dovednosti v manifestu

Dovednost v manifestu je výpočetní jednotka, kterou publikuje plugin. Je deklarována v skills[] manifestu, validována pomocí SDK (software development kit), když spustíte create-nexus-plugin validate, zkompilována do těla registru pomocí compileRegistry a synchronizována do registru dovedností. Nikdy nepíšete SQL pro registr ručně, takže řádek, který platforma odesílá ke zpracování, a deskriptor, který jste deklarovali, se nemohou rozejít.

Každá dovednost v manifestu vyžaduje id, displayName, description, tier, classification, inputSchema a outputSchema. Deklarujte také timeoutMs: jde o celé číslo od 1 000 do 21 600 000 (jedna sekunda až šest hodin) a hodnota mimo tento rozsah je odmítnuta s chybou TIMEOUT_OUT_OF_BOUNDS. dataResidency je any, eu nebo us, přičemž výchozí je any.

id je ve formátu lower_snake a klíčem pro odeslání v registru je typ úlohy se jmenným prostorem <plugin name>.<skill id>, takže dva pluginy mohou mít oba dovednost summarise, aniž by došlo ke kolizi. Zde je jedna dovednost ze šablony, zkrácená:

{
  "id": "sentiment_score",
  "displayName": "Sentiment score",
  "description": "Deterministic lexicon-based sentiment score for a piece of text.",
  "tier": "host_callback",
  "classification": "tenant",
  "dataResidency": "any",
  "inputSchema": { "type": "object", "properties": { "text": { "type": "string", "minLength": 1 } }, "required": ["text"] },
  "outputSchema": { "type": "object", "properties": { "score": { "type": "number" } }, "required": ["score"] },
  "hostCallback": {
    "service": "my-plugin",
    "port": 8080,
    "path": "/internal/skills/sentiment_score",
    "maxRequestBytes": 262144,
    "maxResponseBytes": 16384,
    "tenantHeader": "X-Organization-ID"
  },
  "timeoutMs": 10000
}

Pět úrovní

Úroveň (tier) není jen štítek. Každá úroveň má svá vlastní pole a pole, které patří jiné úrovni, je odmítnuto s chybou FIELD_NOT_FOR_TIER, nikoli tiše zahozeno.

Úroveň Vyžaduje Volá model Kdo ji spouští
host_callback hostCallback: vaše Service, její port, cesta a oba bajtové limity Ne Platforma odešle vstup metodou POST na vaši vlastní Service uvnitř vašeho jmenného prostoru
plugin_queue queueName, zapsáno jako <plugin name>.<name> Ne Váš worker, který si bere úlohy z vaší fronty
tool_using systemPrompt a tools[]; důvěryhodnost core nebo verified Ano Platforma prostřednictvím AI Provider Routeru; každé volání nástroje běží přes povolený exekutor
llm_only systemPrompt; důvěryhodnost core nebo verified Ano Platforma, jedno volání přes AI Provider Router
map map.perItemJobType, jmenující jinou dovednost téhož manifestu, která není typu map Pouze prostřednictvím svého cíle Platforma spustí cíl jednou pro každou položku a shromáždí výsledky

Žádná z modelových úrovní nejmenuje poskytovatele ani model. Router vybere obojí z vlastního fondu odesílající organizace. Nástroj v dovednosti úrovně tool_using jmenuje jeden ze šesti exekutorů: standing_service_call (vaše vlastní Service), graphrag, graphrag_query, graphrag_search, h3 nebo web_search. Jakýkoli jiný je odmítnut s chybou EXECUTOR_NOT_PERMITTED. Tři exekutory znalostního grafu přijímají pouze názvy nástrojů graphrag_query a graphrag_search, protože exekutor spouští operaci, po které je nástroj pojmenován.

V registru existují dvě úrovně, které plugin nemůže deklarovat: řetězce (chains) a dovednosti, které běží samy o sobě, zapisuje výhradně platforma. Synchronizace, která některou z nich jmenuje, je jako celek odmítnuta.

Kterou úroveň použít

  • host_callback, když je práce funkcí vstupu, kterou počítá váš vlastní kód: skóre, výpočet, vyhledání ve vašem vlastním schématu. Testuje se nejjednodušeji a v šabloně je výchozí. Chraňte trasu zpětného volání (callback route): cesta v manifestu není tajemství a trasa musí ověřit volání platformy a převzít organizaci z něj, nikdy z těla požadavku. Deklarujte ji jako auth: internal a připojte na ni requireService (Fastify) nebo serviceMiddleware (Express). Ochranný mechanismus (guard) odmítne token vystavený pro kohokoli jiného. Odpovídejte rychle a zajistěte, aby druhé doručení téže úlohy bylo neškodné.
  • plugin_queue pro delší práci, na kterou člověk čeká, kde životní cyklus řídí váš worker. Worker musí při spuštění přesunout běh do stavu running a při dokončení do koncového stavu; worker, který pouze odešle svůj výsledek, ponechá běh navždy ve stavu queued.
  • llm_only, když úkol zvládne jedno volání modelu s pevným systémovým promptem a váš plugin má úroveň důvěryhodnosti core nebo verified.
  • tool_using, když model potřebuje volat nástroje ve smyčce, opět pouze při úrovni core nebo verified.
  • map, když chcete, aby platforma rozvětvila (fan out) některou z vašich dalších dovedností nad seznamem položek.

Moje dovednost pro propagaci oběžné dráhy v Corrán Orbital je typu host_callback. Náš plugin má úroveň community, takže modelové úrovně nikdy nepřicházely v úvahu, a nijak mi nechybí: propagátor, který by v úterý dal jinou odpověď, by byl horší než k ničemu.

Schválení před každým během

Dovednost v manifestu, která se nikdy nesmí spustit pouze na základě rozhodnutí stroje, to deklaruje:

"approval": { "required": true, "reason": "Re-planning a pass needs the flight dynamics lead." }

required je vždy true; dovednost, která žádné schválení nepotřebuje, tento blok vynechá. reason je to, co vidí schvalovatel, 1 až 500 znaků po oříznutí mezer, a jakýkoli jiný tvar je odmítnut s chybou APPROVAL_INVALID. Odeslání (dispatch) dovednosti je pak pozdrženo: odeslání odpoví 202 se stavem status: "awaiting_approval" a waitpointId a teprve schválení jmenovanou osobou jej jednorázově uvolní. Dávkové (batch), mapovací (map) nebo řetězené (chain) odeslání pozdržené dovednosti je odmítnuto s chybou SKILL_APPROVAL_NOT_HOLDABLE, protože rozvětvení (fan-out) nemůže pozdržet své jednotlivé položky. Vykreslete pozdrženou odpověď a nechte rozhodnout schvalovatele; neprovádějte odeslání s tím, že o souhlas požádáte až poté.

Synchronizace do registru

Každá synchronizace je deklarativní a kontroluje se jako celek. Pokaždé odešlete celou sadu dovedností: dovednost, kterou vynecháte, se deaktivuje a její historie běhů zůstane zachována. Jediná chybná dovednost odmítne celou synchronizaci s chybou SYNC_CONTRACT_VIOLATION, přičemž se vypíší všechna porušení najednou a nic se nezapíše, takže plugin není nikdy aktualizován jen napůl. Kapitola 2.22, Běhové prostředí pluginu, popisuje volání synchronizace a to, jak platforma pozná, který plugin volá.

Dovednosti v IDE a Claude Code
Dovednosti v IDE a Claude Code
Ukázka Dovednosti v IDE a Claude Code předvádí stejné kroky validace, nahrání a publikování z vlastního terminálu vývojářky, přičemž návrh čeká na schválení, protože autorka nemůže schválit vlastní změnu.

Výběr mezi oběma druhy

Pokud úkol zní „řekni to pokaždé stejným způsobem“, jde o dovednost v Skills Engine. Pokud úkol zní „spusť můj kód a dej mi jeho odpověď“, jde o dovednost v manifestu. Většina reálné práce skončí jako kombinace obojího: shrnutí kotvišť v Harrow je dovednost v Skills Engine, jejíž nástroje pocházejí z pluginu, a nástroje pluginu jsou samy deklarovány v jeho manifestu. Dovednost v Skills Engine je z těchto dvou levnější na změnu, což je dobrý důvod ponechat formulace a úsudek tam a výpočty v pluginu.

Náklady jsou reálné v obou případech. Dovednost v Skills Engine není hotová, když se SKILL.md dobře čte; je hotová, když projdou její testovací případy, její zkušební běh souhlasí s tím, jak rozhodli lidé, a schválí ji někdo jiný než vy. Na dovednost, která zapisuje, si vyhraďte týden, z čehož většinu zabere kanárkový provoz.