PrijavaRezervirajte predstavitev

Poglavje 2.20

Veščine (Skills)

Kako napisati, preizkusiti in objaviti veščino za Skills Engine, kje se prikaže, ko je aktivna, ter kako se razlikujejo manifestne veščine v vtičniku. Vključuje izdelan primer povzetka dodeljevanja privezov za organizacijo Harrow Port Authority.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

17 min branja

Tomás Reilly, platformni inženir pri Harrow Port Authority, me je prejšnji mesec vprašal, zakaj njegovi načrtovalci privezov vsakič dobijo drugačen odgovor, ko asistenta vprašajo »kdo je jutri na katerem privezu in kaj se je premaknilo?«. Odgovor je bil, da asistentu nihče ni povedal, kako je videti dober odgovor. Veščina pogona Skills Engine je to rešila v enem popoldnevu: načrtovalci zdaj vsakič dobijo enak tridelni povzetek, najprej s tabelo privezov, pod njo s spremembami od zadnjega načrta in na koncu s prekrivanji. To poglavje obravnava to veščino od začetka do konca, nato pa še drugo vrsto veščine – tisto, ki živi v manifestu vtičnika.

Dve vrsti veščin

Nexus uporablja besedo »veščina« (skill) za dve različni stvari, ki sta tudi zgrajeni različno.

Veščina Skills Engine Veščina v manifestu
Kaj to je Paket SKILL.md v knjižnici veščin Tipizirana vrstica v polju skills[] vtičnika
Kdo jo napiše Vsakdo z ustreznimi pravicami, v ustvarjalniku ali lastnem urejevalniku Razvijalec, znotraj vtičnika
Kaj vsebuje Navodila, orodja, ki jih lahko kliče, izbirne datoteke in skripte Vhodno in izhodno shemo, raven (tier) ter polja, ki jih ta raven potrebuje
Kako pride na platformo Preverjena, naložena in objavljena v pogonu Skills Engine Prevedena iz manifesta in sinhronizirana z registrom veščin
Kaj jo izvaja Asistent, agenti, delovni tokovi, gumbi UI (umetna inteligenca), Claude Code Razpošiljanje UNO (pogon delovnih tokov)
Tipična uporaba »Vsakič povzemi načrt privezov na enak način« »Zaženi naš propagator orbite na tem preletu«

V preostanku poglavja ju strogo ločujemo. Če v odstavku piše samo »veščina«, gre za veščino pogona Skills Engine.

1. del: veščine za Skills Engine

Kaj je veščina

Veščina je mapa. Njena datoteka SKILL.md določa, čemu je veščina namenjena in kako opraviti delo; poleg nje so vse datoteke, ki jih delo potrebuje, in vsi skripti, ki jih izvaja. Pogon naloži veščino v treh slojih: ime in opis vedno, navodila, ko opravilo zahteva veščino, datoteke pa šele, ko jih potrebuje posamezen korak. Zato lahko namestitev hrani dvesto veščin in zanje ne porabi skoraj ničesar, dokler ena izmed njih ni uporabljena.

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

Ime imenika se mora ujemati z okrajšavo (slug) veščine. Neujemanje sproži opozorilo pri preverjanju, ki ga je vredno odpraviti, saj knjižnica prek okrajšave poveže nalaganje z obstoječo veščino.

Uvodni metapodatki (frontmatter) v SKILL.md

Uvodni metapodatki so zapis YAML med dvema vrsticama --- na vrhu datoteke. Format zahteva tri polja. Samo preverjanje ustavi postopek le pri nekaj stvareh: če manjkata ime ali opis ter če sta okrajšava ali vrsta opravila že zasedeni. Vse drugo javi kot opozorilo.

Polje Vrsta Obvezno Kaj vsebuje
name string da Enolični identifikator v zapisu kebab-case
description string da Kaj veščina počne, največ 500 znakov. Bereta ga knjižnica in usklajevalnik, zato ga napišite za bralca, ki se odloča, ali je to prava veščina
allowed-tools string ali list da Orodja, ki jih veščina lahko kliče. Seznam dovoljenih orodij tistega, ki jo zažene, lahko le zoži
triggers list ne Ukazi s poševnico, ki neposredno prikličejo veščino
capabilities list ne Strukturirane zmožnosti, vsaka s poljem name, description ter izbirno input_schema, output_schema in examples
version string ne Semantična različica; 1.0.0, če je izpuščena
visibility string ne private, team ali public
status string ne draft, testing ali published

Navodila naj bodo krajša od približno 5.000 žetonov. Bodite natančni in navedite primere. Vsaka veščina naj dobro opravlja eno delo; če se zalotite, da pišete »in prav tako«, imate verjetno dve veščini.

skill.yaml

skill.yaml vsebuje tisto, kar pogon potrebuje za odkrivanje in knjižnico, tako da SKILL.md ostane berljiv. Polja, ki jih pogon bere, vključujejo name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools in capabilities. Zmožnost lahko vsebuje query_patterns, tj. ubeseditve, ki naj jih usklajevalnik usmeri nanjo. Obstajajo tudi namigi za lastno odmerjanje sredstev pogona: complexity, estimated_tokens in required_services.

scripts/

Vse pod scripts/ je dobesedno zapakirano z veščino kot komponenta. Skript se izvede, nikoli se ne prebere v kontekst modela, izvaja pa se v peskovniku. Uporabite ga, ko korak zahteva aritmetiko ali razčlenjevanje, česar model ne bi smel početi »na pamet«.

Vidnost in stanje

Vidnost določa, kdo lahko najde veščino: private ste vi, team je vaša ekipa in public so vsi v organizaciji, ki ji knjižnica služi. V konzoli se ista izbira glasi »Samo jaz«, ekipa, kot je »Carinska pisarna«, ali celotna organizacija, veščino pa je mogoče deliti tudi v domenski paket prek lastnega pregleda tega paketa.

Stanje pove, kje v svojem življenjskem ciklu je veščina.

Stanje Pomen
draft Delo v teku; ni mogoče odkriti
testing V postopku preverjanja, z omejenim dostopom
published Na voljo za splošno uporabo
deprecated Nadomeščeno; v postopku opuščanja

Ko je različica objavljena, se nikoli več ne spremeni. V konzoli so »v živo« (live), »kanarček« (canary) in »v senci« (shadow) oznake na različicah, preklop nazaj na starejšo različico pa premakne oznako. Zagoni v teku se dokončajo na različici, s katero so se začeli.

Nova veščina · 2 Navodila in orodja
Nova veščina · 2 Navodila in orodja
Drugi korak ustvarjalnika prikazuje osnutek SKILL.md, datoteke ob njem in kdaj se posamezna naloži ter orodja, ki jih veščina lahko kliče. Veščini za preverjanje ni ponujeno nobeno orodje, ki zapisuje, veščina pa lahko seznam dovoljenih orodij izvajalca le zoži.

Od mape do veščine v živo

Pet skriptov npm v skladišču pogona Skills Engine popelje veščino iz vašega urejevalnika v knjižnico in dokaže, da je prispela.

Ukaz Kaj naredi
npm run skill:validate skills/<slug> Preveri (lint) paket. Za objavo ne sme biti nobene napake
npm run skill:upload skills/<slug> Preveri in objavi v enem koraku; idempotentno
npm run skill:upload skills/<slug> --dry-run Preveri in izpiše načrt brez kakršnega koli zapisovanja
npm run skill:publish -- --dry-run skills/<slug> Objava na nižji ravni v ozadju nalaganja, isti cevovod
npm run skill:reconcile Primerja veščine v vašem skladišču s tistim, kar hranita knjižnica in register veščin
npm run skill:live:verify Preveri objavljeno veščino od začetka do konca na delujoči namestitvi

Objava zapiše dva vnosa in oba sta pomembna. Prvi je sama veščina s telesom SKILL.md, zmožnostmi, komponentami in zapisom o kakovosti; tega berejo knjižnica, odkrivanje in usklajevanje. Drugi je vnos v registru, glede na katerega pogon delovnih tokov razreši razpošiljanje. Veščina, ki je prišla le do registra, se sicer izvaja, vendar je v knjižnici nevidna, dokler je ne naložite.

Objava je idempotentna. Nespremenjena veščina ne sproži nobenega dejanja (no-op), obstoječa veščina pa se poišče prek okrajšave in posodobi na mestu, nikoli se ne ustvari znova. Če naložite enake bajte kot pri različici, ki je že objavljena, dobite to različico nazaj z CONTENT_HASH_ALREADY_PUBLISHED, ne podvojene.

skill:reconcile pregleda veščine vašega skladišča glede na knjižnico, register in inventar pogona delovnih tokov ter javi vse, kar obstaja na enem mestu, na drugem pa ne. skill:live:verify gre na delujoči namestitvi še dlje: oba vnosa obstajata in kažeta drug na drugega z enako zgoščeno vrednostjo vsebine, poskusno razpošiljanje vrste opravila veščine je sprejeto, veščina je prikazana na seznamu in v podrobnostih knjižnice, mogoče jo je priklicati, revizijska sled pa poveže objavo, razpošiljanje in zagon prek okrajšave ter identifikatorja zahteve.

Z delovne postaje nalaganje doseže storitev znanja namestitve, nexus-graphrag, prek posredovanja vrat (port-forward), v okolju pa potrebuje storitveni ključ pogona Skills Engine. Ključ naložite brez izpisovanja:

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

Znotraj gruče, v opravilu cevovoda, se privzeti naslov razreši sam in GRAPHRAG_URL ni potreben. Ključ pridobite prek lastnega postopka za upravljanje skrivnosti v vaši organizaciji. Nikoli ne sme zači v skladišče, zgodovino vaše lupine ali izhod ukaza.

Testi, odobritev in prehod v živo

Veščina prispe v knjižnico kot osnutek in ustvarjalnik jo tam zadrži, dokler niso uspešno opravljeni trije koraki.

Preverjanje Kaj naredi
Testni primeri Vsak primer mora biti uspešno opravljen, preden gre veščina lahko v odobritev. Primer je mogoče odstraniti le z navedbo razloga, ki ga odobritelji vidijo.
Poskusni zagon v senci Veščina se zažene na preteklem delu, kjer nihče ne vidi odgovorov, njeni rezultati pa se primerjajo s tem, kako se je takrat odločila oseba.
Slepi pregled z modelom iz druge družine Išče spregledano preverjanje, izmišljen vir in podtaknjeno navodilo, ki mu je veščina sledila, pa mu ne bi smela.

Sledi odobritev. Veščina, ki dodaja orodje za zapisovanje, je zadržana, dokler je dve osebi ne odobrita s svojima dostopnima ključema (passkey), pri čemer oseba, ki jo je predlagala, ne more biti ena izmed njiju (PUBLISH_NEEDS_APPROVAL). Nato gre v živo v senci, zatem kot kanarček za eno enoto za imenovanimi vrati in nazadnje za vse. Če vrata kanarčka niso izpolnjena, se kanarček sam ustavi in vsi ostanejo na prejšnji različici; za predčasno pošiljanje vsem pa sta potrebna razlog in drugi odobritelj (CANARY_GATE_NOT_MET).

V izdaji Community so ustvarjalnik, knjižnica, različice in testi v celoti na voljo, lastnik pa objavi sam, ko so testi uspešno opravljeni. Kanarček, odobritev dveh oseb, sinhronizacija vtičnikov in združevanje dvojnikov so na voljo v izdaji Enterprise.

Nova veščina · 4 Objava
Nova veščina · 4 Objava
Objava prikazuje, zakaj je veščina zadržana, kdo se mora strinjati in kako gre v živo: odobrena, v senci, kot kanarček za imenovanimi vrati in nato za vse. Predlagatelj ne more odobriti lastne spremembe, zadnja različica pa ostane pripravljena za morebiten preklop nazaj.

Kje se veščine pojavljajo

Ista objavljena veščina doseže uporabnike na petih mestih.

  1. Asistent poveže zahtevo z veščino glede na njen opis, sprožilce in vzorce poizvedb ter sledi navodilom veščine.
  2. Agenti in delovni tokovi kličejo veščine kot korake. Korak delovnega toka imenuje veščino; zagon zabeleži, katero različico je uporabil.
  3. Gumbi UI na zaslonih zaženejo vsak po eno veščino. Skrbnik lahko odpre »O tem gumbu«, da vidi, katero veščino gumb zažene, kaj bere in kdo jo je nazadnje spremenil, ter lahko gumb izklopi, ne da bi se dotaknil same veščine.
  4. Vaš IDE (integrirano razvojno okolje) in Claude Code dostopata do knjižnice prek okolja Workbench in trinajstih orodij MCP (Model Context Protocol), med katerimi so: list_skills, get_skill, match_prompt, discover_skills, invoke_skill, record_execution, create_skill, import_skill, get_generation_job in sync_skills_local. Vsak klic se izvede v imenu osebe, ki ga je sprožila, znotraj njenega seznama dovoljenih orodij.
  5. Sama knjižnica veščin, kjer uporabniki brskajo po veščinah, jih zaganjajo in predlagajo spremembe, skrbniki pa vidijo lastnika, uporabnike, zagone in porabo vsake veščine.

Ne glede na to, kaj zažene veščino, ta ne more razširiti pooblastil izvajalca: kliče le orodja znotraj izvajalčevega seznama dovoljenih orodij in bere le tisto, kar ta oseba sme odpreti (SKILL_CANNOT_WIDEN_TOOLS). Zagon brez usmeritve modela je zavrnjen, namesto da bi se ugibalo (SKILLS_ENGINE_BINDING_MISSING); usmeritev izbere razpošiljatelj iz lastnih nastavitev modelov organizacije.

O tem gumbu
O tem gumbu
Okno »O tem gumbu« prikazuje veščino, ki jo gumb UI zažene, tri vire, ki jih bere, kdo jo je napisal in pregledal ter kaj je spremenila zadnja različica. Izklop gumba ga hkrati odstrani povsod; veščina in vsi pretekli odgovori pa ostanejo.

Praktični primer: povzetek dodelitve privezov za Harrow

Načrtovalci pri Harrowu so na svojem seznamu dovoljenih orodij že imeli dve orodji samo za branje iz lastnega vtičnika za načrtovanje privezov Harrow: berth-plan.read vrne načrt za določen datum, vessel-call.read pa vrne postanek ladje z njenim časovnim oknom prihoda in dolžino. Veščina ne potrebuje ničesar drugega. Nikoli ne zapisuje, zato nikoli ne potrebuje dveh odobriteljev.

---
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.

Datoteka skill.yaml ob njej daje knjižnici prikazno ime, kategorijo in ubeseditve, ki naj jih usklajevalnik usmeri sem:

# 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 *"

Nato sledijo ukazi iz korenskega imenika skladišča:

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 je v ustvarjalniku dodal šest testnih primerov: običajen dan, dan z zamudo pri prihodu, ki je premaknila dva postanka, dan z dejanskim prekrivanjem, datum, za katerega načrta še ni, ladjo, ki je predolga za svoj privez, in zahtevo, ki je poskušala pripraviti veščino do tega, da predlaga nov privez (česar ne sme, saj nima orodja za zapisovanje). Poskusni zagon je v senci poustvaril dvajset preteklih načrtov. Ko so bili primeri uspešno opravljeni, je pregledovalec v pisarni za načrtovanje veščino odobril in šla je v živo za ekipo načrtovalcev. Asistent zdaj na vprašanje vsakič odgovori v enaki obliki, gumb UI načrtovalcev na strani z načrtom privezov pa zažene isto veščino.

2. del: manifestne veščine

Veščina v manifestu je računska enota, ki jo objavi vtičnik. Deklarirana je v polju skills[] manifesta, ob zagonu create-nexus-plugin validate jo preveri SDK (komplet za razvoj programske opreme), compileRegistry jo prevede v telo registra, nato pa se sinhronizira z registrom veščin. Kode SQL za register nikoli ne pišete ročno, zato se vrstica, ki jo platforma razpošlje, in deskriptor, ki ste ga deklarirali, ne moreta razhajati.

Vsaka veščina v manifestu potrebuje id, displayName, description, tier, classification, inputSchema in outputSchema. Deklarirajte tudi timeoutMs: to je celo število od 1.000 do 21.600.000 (od ene sekunde do šestih ur), vrednost zunaj tega razpona pa je zavrnjena z TIMEOUT_OUT_OF_BOUNDS. dataResidency je any, eu ali us, pri čemer je any privzeta vrednost.

id je v zapisu lower_snake, ključ za razpošiljanje v registru pa je vrsta opravila z imenskim prostorom <plugin name>.<skill id>, tako da imata lahko dva vtičnika veščino summarise brez spora. Tukaj je ena veščina iz predloge, skrajšana:

{
  "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
}

Pet ravni

Raven ni le oznaka. Vsaka raven ima svoja polja in polje, ki pripada drugi ravni, je zavrnjeno z FIELD_NOT_FOR_TIER, namesto da bi bilo tiho izpuščeno.

Raven Zahteva Doseže model Kdo jo izvaja
host_callback hostCallback: vaš Service, njegova vrata, pot in obe omejitvi bajtov Ne Platforma pošlje (POST) vhodne podatke vašemu lastnemu viru Service znotraj vašega imenskega prostora
plugin_queue queueName, zapisano kot <plugin name>.<name> Ne Vaš delavec (worker), ki jemlje iz vaše čakalne vrste
tool_using systemPrompt in tools[]; zaupanje core ali verified Da Platforma prek usmerjevalnika ponudnikov UI (AI Provider Router); vsak klic orodja se izvede prek izvajalca s seznama dovoljenih
llm_only systemPrompt; zaupanje core ali verified Da Platforma, en klic prek usmerjevalnika ponudnikov UI
map map.perItemJobType, ki imenuje drugo veščino istega manifesta, ki ni preslikava (map) Samo prek svojega cilja Platforma zažene cilj enkrat za vsak element in zbere rezultate

Nobena od ravni modela ne imenuje ponudnika ali modela. Usmerjevalnik izbere oboje iz lastnega nabora organizacije, ki razpošilja. Orodje v veščini tool_using imenuje enega od šestih izvajalcev: standing_service_call (vaš lastni Service), graphrag, graphrag_query, graphrag_search, h3 ali web_search. Kateri koli drug je zavrnjen z EXECUTOR_NOT_PERMITTED. Trije izvajalci grafa znanja sprejmejo le imeni orodij graphrag_query in graphrag_search, ker izvajalec izvede tisto operacijo, po kateri je orodje poimenovano.

V registru obstajata dve ravni, ki ju vtičnik ne more deklarirati: verige in veščine, ki se izvajajo same, zapisuje le platforma. Sinhronizacija, ki imenuje katero izmed njiju, je v celoti zavrnjena.

Katero raven uporabiti

  • host_callback, kadar je delo funkcija vhodnih podatkov, ki jo izračuna vaša lastna koda: ocena, izračun, poizvedba v vaši lastni shemi. Je najpreprostejša za testiranje in privzeta v predlogi. Zaščitite povratno pot (callback route): pot v manifestu ni skrivnost, zato mora pot preveriti klic platforme in iz njega prevzeti organizacijo, nikoli iz telesa zahteve. Deklarirajte jo kot auth: internal in nanjo namestite requireService (Fastify) ali serviceMiddleware (Express). Zaščita zavrne žeton, izdan za kogar koli drugega. Odgovorite hitro in poskrbite, da bo morebitna druga dostava istega opravila neškodljiva.
  • plugin_queue za daljše delo, na katerega oseba čaka in pri katerem življenjski cikel upravlja vaš delavec. Delavec mora ob začetku premakniti zagon v running in ob zaključku v končno stanje; delavec, ki le objavi svoj rezultat, pusti zagon za vedno prikazan kot queued.
  • llm_only, ko delo opravi en klic modela z nespremenljivim sistemskim pozivom in ima vaš vtičnik raven zaupanja core ali verified.
  • tool_using, ko mora model klicati orodja v zanki, prav tako le pri core ali verified.
  • map, ko želite, da platforma eno izmed vaših drugih veščin razprši čez seznam.

Moja veščina za propagacijo orbite pri Corrán Orbital je host_callback. Naš vtičnik je community, zato ravni z modeli nikoli niso bile možnost, pa jih tudi ne pogrešam: propagator, ki bi v torek dal drugačen odgovor, bi bil slabši kot neuporaben.

Odobritev pred vsakim zagonom

Veščina v manifestu, ki se nikoli ne sme zagnati zgolj na podlagi odločitve stroja, to deklarira:

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

required je vedno true; veščina, ki ne potrebuje odobritve, ta blok izpusti. reason je tisto, kar vidi odobritelj, od 1 do 500 znakov po odstranitvi presledkov, vsaka druga oblika pa je zavrnjena z APPROVAL_INVALID. Razpošiljanje veščine je nato zadržano: razpošiljanje odgovori 202 z status: "awaiting_approval" in waitpointId, sprosti pa ga šele odobritev imenovane osebe, in sicer enkratno. Paketno razpošiljanje, razpošiljanje s preslikavo ali verižno razpošiljanje zadržane veščine je zavrnjeno z SKILL_APPROVAL_NOT_HOLDABLE, ker razpršitev ne more zadržati svojih posameznih elementov. Prikažite zadržani odgovor in pustite odobritelju, da odloči; ne razpošljite in šele nato prosite za soglasje.

Sinhronizacija z registrom

Vsaka sinhronizacija je deklarativna in preverjena kot celota. Vsakič pošljite celoten nabor veščin: veščina, ki jo izpustite, je onemogočena, njena zgodovina zagonov pa ostane. Ena neustrezna veščina zavrne celotno sinhronizacijo z SYNC_CONTRACT_VIOLATION, pri čemer so vse kršitve navedene skupaj in nič ni zapisano, tako da vtičnik ni nikoli posodobljen le napol. Poglavje 2.22, Izvajalno okolje vtičnikov, obravnava klic sinhronizacije in način, kako platforma ve, kateri vtičnik kliče.

Veščine v okolju IDE in Claude Code
Veščine v IDE in orodju Claude Code
Slika »Veščine v okolju IDE in Claude Code« prikazuje iste korake preverjanja, nalaganja in objave iz razvijalčevega lastnega terminala, pri čemer je osnutek zadržan za odobritev, ker avtorica ne more odobriti lastne spremembe.

Izbira med obema vrstama

Če je naloga »povej to vsakič na enak način«, gre za veščino pogona Skills Engine. Če je naloga »zaženi mojo kodo in mi podaj njen odgovor«, gre za veščino v manifestu. Večina resničnega dela na koncu vključuje oboje: povzetek privezov za Harrow je veščina pogona Skills Engine, katere orodja prihajajo iz vtičnika, sama orodja vtičnika pa so deklarirana v njegovem manifestu. Veščino pogona Skills Engine je ceneje spremeniti, kar je dober razlog, da ubeseditev in presojo ohranite tam, aritmetiko pa v vtičniku.

Strošek je v vsakem primeru resničen. Veščina pogona Skills Engine ni končana, ko se SKILL.md lepo bere; končana je, ko so njeni testni primeri uspešno opravljeni, ko se njen poskusni zagon ujema z odločitvami ljudi in ko jo odobri nekdo drug, ne vi. Za veščino, ki zapisuje, predvidite en teden, od tega večino časa za fazo kanarčka.