Versioon 1.0.0-alpha.1uusim
Peatükk 2.20
Oskused (Skills)
Kuidas kirjutada, testida ja avaldada Skills Engine-i oskust, kus see pärast avaldamist ilmub ja kuidas pistikprogrammi manifestioskused sellest erinevad. Sisaldab läbitöötatud kaikohtade jaotuse kokkuvõtet Harrow Port Authority näitel.
Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

Harrow Port Authority platvormiinsener Tomás Reilly küsis minult eelmisel kuul, miks tema sildumisplaneerijad said iga kord erineva vastuse, kui nad küsisid assistendilt: „kes on homme millisel sildumiskohal ja mis on muutunud?“. Vastus oli see, et keegi polnud assistendile öelnud, milline üks hea vastus välja näeb. Üks Skills Engine'i oskus lahendas selle ühe pärastlõunaga: planeerijad saavad nüüd iga kord sama kolmeosalise kokkuvõtte, kus esimesena on sildumiskohtade tabel, selle all muudatused võrreldes viimase plaaniga ja viimasena konfliktid. See peatükk vaatab selle oskuse algusest lõpuni läbi ning käsitleb seejärel teist tüüpi oskust – seda, mis asub plugina manifestis.
Kahte liiki oskused
Nexus kasutab sõna „oskus“ (skill) kahe erineva asja kohta ja need on üles ehitatud erinevalt.
| Skills Engine'i oskus | Manifesti oskus | |
|---|---|---|
| Mis see on | SKILL.md pakett oskuste teegis |
Tüpiseeritud rida plugina skills[] massiivis |
| Kes selle kirjutab | Igaüks, kellel on vastav õigus, kas loojas või oma redaktoris | Arendaja, plugina sees |
| Mida see sisaldab | Juhiseid, tööriistu, mida see võib välja kutsuda, valikulisi faile ja skripte | Sisend- ja väljundskeemi, taset (tier) ning välju, mida see tase vajab |
| Kuidas see platvormile jõuab | Valideeritakse, laaditakse üles ja avaldatakse Skills Engine'is | Kompileeritakse manifestist ja sünkroonitakse oskuste registriga |
| Mis seda käivitab | Assistent, agendid, töövood, AI (tehisintellekti) nupud, Claude Code | UNO (töövoomootori) suunamine (dispatch) |
| Tüüpiline kasutus | „Võta sildumisplaan iga kord samamoodi kokku“ | „Käivita sellel ülelennul meie orbiidi propagaator“ |
Ülejäänud peatükk hoiab need kaks lahus. Kui lõigus on kirjas lihtsalt „oskus“, on mõeldud Skills Engine'i oskust.
1. osa: Skills Engine-i oskused
Mis on oskus
Oskus on kaust. Selle SKILL.md ütleb, milleks oskus on mõeldud ja kuidas tööd teha; selle kõrval asuvad kõik failid, mida töö vajab, ja skriptid, mida see käivitab. Mootor laadib oskuse kolmes kihis: nime ja kirjelduse alati, juhised siis, kui ülesanne oskust nõuab, ning failid ainult siis, kui mõni samm neid vajab. Seetõttu võib paigaldus sisaldada kahtsadat oskust ja nende eest ei maksta peaaegu midagi, kuni mõnda neist kasutatakse.
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
Kausta nimi peab võrduma oskuse püsilüliga (slug). Mittevastavus annab valideerimishoiatuse ja see tasub parandada, sest püsilüli abil sobitab teek üleslaadimise olemasoleva oskusega.
SKILL.md päis (frontmatter)
Päis on YAML-kood faili alguses kahe --- rea vahel. Vorming nõuab kolme välja. Valideerimine ise blokeerib protsessi vaid mõne asja tõttu: puuduv nimi või kirjeldus ning püsilüli või töötüüp, mis on juba kasutusel. Kõigest muust teatab see hoiatusena.
| Väli | Tüüp | Kohustuslik | Mida see sisaldab |
|---|---|---|---|
name |
sõne | jah | Unikaalne identifikaator kebab-case-vormingus |
description |
sõne | jah | Mida oskus teeb, kuni 500 tähemärki. Teek ja sobitaja (matcher) loevad seda, seega kirjutage see lugejale, kes otsustab, kas see on õige oskus |
allowed-tools |
string või loend | jah | Tööriistad, mida oskus võib välja kutsuda. See saab käivitaja lubatud nimekirja (allow-list) ainult kitsendada |
triggers |
loend | ei | Kaldkriipsukäsud, mis kutsuvad oskuse otse välja |
capabilities |
loend | ei | Struktureeritud võimekused, igaühel name, description ning valikuliselt input_schema, output_schema ja examples |
version |
sõne | ei | Semantiline versioon; puudumisel 1.0.0 |
visibility |
sõne | ei | private, team või public |
status |
sõne | ei | draft, testing või published |
Hoidke juhised alla umbes 5,000 tokeni. Olge täpne ja tooge näiteid. Iga oskus peaks tegema ühte tööd hästi; kui avastate end kirjutamas „ja lisaks“, on teil ilmselt kaks oskust.
skill.yaml
skill.yaml sisaldab seda, mida mootor vajab tuvastamiseks ja teegi jaoks, et SKILL.md jääks loetavaks. Väljad, mida mootor loeb, on muu hulgas name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools ja capabilities. Võimekus võib sisaldada välja query_patterns – sõnastusi, mille sobitaja peaks sellele suunama. Lisaks on olemas vihjed mootori enda eelarvestamise jaoks: complexity, estimated_tokens ja required_services.
scripts/
Kõik, mis asub kaustas scripts/, pakitakse muutmata kujul oskusega komponendina kaasa. Skript käivitatakse, seda ei loeta kunagi mudeli konteksti ja see töötab liivakastis. Kasutage seda siis, kui mõni samm nõuab aritmeetikat või parsimist, mida mudel ei peaks peast tegema.
Nähtavus ja olek
Nähtavus määrab, kes saab oskuse leida: private olete teie, team on teie meeskond ja public on kõik organisatsioonis, mida teek teenindab. Konsoolis on samad valikud „Ainult mina“, meeskond nagu „Tollilaud“ või kogu organisatsioon, ning oskust saab jagada ka valdkonnapaketti selle paketi enda ülevaatuse kaudu.
Olek näitab, millises elutsükli etapis oskus on.
| Olek | Tähendus |
|---|---|
draft |
Töö pooleli; pole leitav |
testing |
Valideerimisel, piiratud juurdepääsuga |
published |
Üldiseks kasutamiseks saadaval |
deprecated |
Asendatud; teel kasutusest kõrvaldamisele |
Kui versioon on avaldatud, ei muutu see enam kunagi. Konsoolis on „live“, „canary“ ja „shadow“ versioonide sildid ning varasemale versioonile tagasilülitamine liigutab silti. Pooleliolevad käivitused lõpetavad tööd selle versiooniga, millega need alustasid.
SKILL.md mustandit, selle kõrval olevaid faile ja nende laadimise aega ning tööriistu, mida oskus võib välja kutsuda. Kontrollivale oskusele ei pakuta ühtegi kirjutavat tööriista ning oskus saab käivitaja lubatud nimekirja ainult kitsendada.Kaustast avaldatud oskuseni
Viis npm skripti Skills Engine'i hoidlas viivad oskuse teie redaktorist teeki ja tõestavad, et see jõudis kohale.
| Käsk | Mida see teeb |
|---|---|
npm run skill:validate skills/<slug> |
Kontrollib paketti (lint). Avaldamiseks ei tohi olla ühtegi viga |
npm run skill:upload skills/<slug> |
Valideerib ja avaldab ühe sammuga; idempotentne |
npm run skill:upload skills/<slug> --dry-run |
Valideerib ja prindib plaani ilma midagi kirjutamata |
npm run skill:publish -- --dry-run skills/<slug> |
Madalama taseme avaldamine üleslaadimise taga, sama konveier |
npm run skill:reconcile |
Võrdleb teie hoidlas olevaid oskusi sellega, mis on teegis ja oskuste registris |
npm run skill:live:verify |
Kontrollib avaldatud oskust töötavas paigalduses algusest lõpuni |
Avaldamine kirjutab kaks kirjet ja mõlemad on olulised. Üks on oskus ise koos oma SKILL.md sisu, võimekuste, komponentide ja kvaliteedikirjega; seda loevad teek, tuvastamine ja sobitamine. Teine on registrikirje, mille vastu töövoomootor suunamise lahendab. Oskus, mis jõudis ainult registrisse, küll töötab, kuid on teegis nähtamatu, kuni te selle üles laadite.
Avaldamine on idempotentne. Muutmata oskus ei tee midagi (no-op) ning olemasolev oskus sobitatakse selle püsilüli järgi ja uuendatakse kohapeal, mitte ei looda uuesti. Kui laadite üles samad baidid nagu juba avaldatud versioonil, saate tagasi tolle versiooni koos teatega CONTENT_HASH_ALREADY_PUBLISHED, mitte duplikaadi.
skill:reconcile võrdleb teie hoidla oskusi teegi, registri ja töövoomootori inventuuriga ning annab teada kõigest, mis eksisteerib ühes kohas, kuid mitte teises. skill:live:verify läheb töötavas paigalduses kaugemale: mõlemad kirjed eksisteerivad ja viitavad teineteisele sama sisuräsiga, oskuse töötüübi proovisuunamine (dry-run dispatch) võetakse vastu, oskus on näha teegi loendis ja detailvaates, seda saab välja kutsuda ning kontrolljälg seob avaldamise, suunamise ja käivituse püsilüli ning päringu ID alusel kokku.
Tööjaamast jõuab üleslaadimine paigalduse teadmusteenusesse nexus-graphrag pordiedastuse (port-forward) kaudu ja see vajab keskkonnas Skills Engine'i teenusevõtit. Laadige võti ilma seda ekraanil kuvamata:
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-summaryKlastri sees, konveieri töös, lahendub vaikeaadress ise ja GRAPHRAG_URL pole vajalik. Hankige võti oma organisatsiooni saladuste halduse protsessi kaudu. See ei tohi kunagi sattuda hoidlasse, teie kesta (shell) ajalukku ega käsu väljundisse.
Testid, kinnitamine ja kasutuselevõtt
Oskus jõuab teeki mustandina ja looja hoiab seda seal, kuni kolm tingimust on täidetud.
| Kontroll | Mida see teeb |
|---|---|
| Testjuhud | Iga testjuht peab läbima enne, kui oskuse saab kinnitamisele saata. Testjuhu saab eemaldada ainult koos põhjendusega, mida kinnitajad näevad. |
| Proovikäivitus varirežiimis (shadow) | Oskust käitatakse varasema töö peal, kus keegi vastuseid ei näe, ja selle tulemusi võrreldakse sellega, mida inimene omal ajal otsustas. |
| Pimeülevaatus teise perekonna mudeli poolt | See otsib vahelejäänud kontrolle, väljamõeldud allikaid ja peidetud juhiseid, mida oskus järgis, kuigi poleks tohtinud. |
Seejärel kinnitamine. Oskust, mis lisab kirjutava tööriista, hoitakse kinni, kuni kaks inimest kinnitavad selle oma pääsuvõtmetega (passkey), ning ettepaneku tegija ei saa olla üks neist (PUBLISH_NEEDS_APPROVAL). Seejärel läheb see käiku varirežiimis (shadow), siis kanaarirežiimis (canary) ühe üksuse jaoks nimeliste lävendite taga ja seejärel kõigile. Kui kanaarilävendit ei täideta, peatub kanaarirežiim ise ja kõik jäävad eelmise versiooni juurde; selle varasem saatmine kõigile nõuab põhjendust ja teist kinnitajat (CANARY_GATE_NOT_MET).
Community väljaandes on looja, teek, versioonid ja testid kõik olemas ning omanik avaldab oskuse üksi kohe, kui testid on läbitud. Kanaarirežiim, kahe inimese kinnitus, pluginate sünkroonimine ja duplikaatide liitmine tulevad kaasa Enterprise'i väljaandega.
Kus oskused on nähtavad
Sama avaldatud oskus jõuab inimesteni viies kohas.
- Assistent sobitab päringu oskusega selle kirjelduse, päästikute ja päringumustrite järgi ning järgib oskuse juhiseid.
- Agendid ja töövood kutsuvad oskusi välja sammudena. Töövookäik nimetab oskuse; käivitus salvestab, millist versiooni see kasutas.
- AI-nupud ekraanidel käivitavad igaüks ühe oskuse. Administraator saab avada „Teave selle nupu kohta“, et näha, millist oskust nupp käivitab, mida see loeb ja kes seda viimati muutis, ning saab nupu välja lülitada ilma oskust puutumata.
- Teie IDE (integreeritud arenduskeskkond) ja Claude Code jõuavad teegini läbi Workbenchi ja kolmeteistkümne MCP (Model Context Protocol) tööriista: nende hulgas
list_skills,get_skill,match_prompt,discover_skills,invoke_skill,record_execution,create_skill,import_skill,get_generation_jobjasync_skills_local. Iga väljakutse töötab selle algatanud isiku õigustes ja tema lubatud nimekirja piires. - Oskuste teek ise, kus inimesed sirvivad ja käivitavad oskusi ning teevad neile muudatusettepanekuid, ja administraatorid näevad iga oskuse omanikku, kasutajaid, käivitusi ja kulu.
Ükskõik mis oskust käivitab, ei saa oskus laiendada seda, mida käivitaja tohib teha: see kutsub välja ainult käivitaja lubatud nimekirjas olevaid tööriistu ja loeb ainult seda, mida see isik tohib avada (SKILL_CANNOT_WIDEN_TOOLS). Käivitus ilma mudeli marsruudita lükatakse tagasi, mitte ei hakata seda oletama (SKILLS_ENGINE_BINDING_MISSING); suunaja valib marsruudi organisatsiooni enda mudeliseadistusest.
Praktiline näide: sildumiskohtade jaotuse kokkuvõte Harrow jaoks
Harrow planeerijatel oli oma lubatud nimekirjas juba kaks kirjutuskaitstud tööriista Harrow enda sildumisplaneerimise pluginast: berth-plan.read tagastab kuupäeva plaani ja vessel-call.read tagastab laevakülastuse koos saabumisakna ja pikkusega. Oskus ei vaja midagi muud. See ei kirjuta kunagi, seega ei vaja see kunagi kahte kinnitajat.
---
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.Selle kõrval olev skill.yaml annab teegile kuvatava nime, kategooria ja sõnastused, mille sobitaja peaks siia suunama:
# 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 *"Seejärel käsud hoidla juurkaustast:
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-summaryTomás lisas loojas kuus testjuhtu: tavaline päev, hilise saabumisega päev, mis nihutas kahte külastust, tõelise konfliktiga päev, kuupäev, millel pole veel plaani, sildumiskoha jaoks liiga pikk laev ja päring, mis üritas panna oskust uut sildumiskohta välja pakkuma (seda ei tohiks teha; sel pole kirjutavat tööriista). Proovikäivitus mängis varirežiimis läbi kakskümmend varasemat plaani. Kui testjuhud olid läbitud, kinnitas planeerimislaua ülevaataja selle ja see läks planeerimismeeskonna jaoks käiku. Assistent vastab nüüd küsimusele iga kord samal kujul ja planeerijate AI-nupp sildumisplaani lehel käivitab sedasama oskust.
2. osa: manifestioskused
Manifesti oskus on arvutusühik, mille plugin avaldab. See deklareeritakse manifesti väljal skills[], valideeritakse SDK (tarkvaraarenduskomplekti) poolt, kui käivitate create-nexus-plugin validate, kompileeritakse registri sisuks käsuga compileRegistry ja sünkroonitakse oskuste registriga. Te ei kirjuta kunagi registri SQL-i käsitsi, seega rida, mida platvorm suunab, ja kirjeldaja, mille te deklareerisite, ei saa omavahel lahkneda.
Iga manifesti oskus vajab välju id, displayName, description, tier, classification, inputSchema ja outputSchema. Deklareerige ka timeoutMs: see on täisarv vahemikus 1,000 kuni 21,600,000 (üks sekund kuni kuus tundi) ning sellest vahemikust väljapoole jääv väärtus lükatakse tagasi veaga TIMEOUT_OUT_OF_BOUNDS. dataResidency on any, eu või us ning any on vaikeväärtus.
id on lower_snake-vormingus ja registri suunamisvõti on nimeruumiga töötüüp <plugin name>.<skill id>, nii et kahel pluginal võib mõlemal olla oskus summarise ilma konfliktita. Siin on malli üks oskus lühendatud kujul:
{
"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
}Viis taset
Tase (tier) ei ole pelgalt silt. Igal tasemel on oma väljad ja teisele tasemele kuuluv väli lükatakse tagasi veaga FIELD_NOT_FOR_TIER, mitte ei jäeta vaikselt kõrvale.
| Tase | Nõuab | Pöördub mudeli poole | Kes seda käivitab |
|---|---|---|---|
host_callback |
hostCallback: teie Service, selle port, asukoht (path) ja mõlemad baidipiirangud |
Ei | Platvorm saadab sisendi POST-päringuga teie enda Service'ile teie nimeruumi sees |
plugin_queue |
queueName, kirjapildiga <plugin name>.<name> |
Ei | Teie tööline (worker), võttes töö teie järjekorrast |
tool_using |
systemPrompt ja tools[]; usaldustase core või verified |
Jah | Platvorm, läbi AI Provider Routeri; iga tööriista väljakutse käib läbi lubatud nimekirjas oleva täituri (executor) |
llm_only |
systemPrompt; usaldustase core või verified |
Jah | Platvorm, üks väljakutse läbi AI Provider Routeri |
map |
map.perItemJobType, nimetades sama manifesti teist oskust, mis ei ole vastendus (map) |
Ainult läbi oma sihtmärgi | Platvorm käivitab sihtmärgi üks kord iga elemendi kohta ja kogub tulemused kokku |
Kumbki mudelitase ei nimeta teenusepakkujat ega mudelit. Ruuter valib mõlemad suunava organisatsiooni enda varust. Tööriist tool_using oskuses nimetab ühte kuuest täiturist: standing_service_call (teie enda Service), graphrag, graphrag_query, graphrag_search, h3 või web_search. Kõik muud lükatakse tagasi veaga EXECUTOR_NOT_PERMITTED. Kolm teadmusgraafi täiturit aktsepteerivad ainult tööriistanimesid graphrag_query ja graphrag_search, sest täitur käivitab selle toimingu, mille järgi tööriist on nimetatud.
Registris eksisteerib kaks taset, mida plugin ei saa deklareerida: ahelaid ja iseseisvalt töötavaid oskusi kirjutab ainult platvorm. Sünkroonimine, mis nimetab mõnda neist, lükatakse tervikuna tagasi.
Millist taset kasutada
host_callback, kui töö on sisendi funktsioon, mida arvutab teie enda kood: skoor, arvutus, otsing teie enda skeemist. Seda on kõige lihtsam testida ja see on malli vaikeväärtus. Kaitske tagasihelistamise (callback) marsruuti: asukoht manifestis ei ole saladus ning marsruut peab kontrollima platvormi väljakutset ja võtma organisatsiooni sellest, mitte kunagi päringu kehast. Deklareerige seeauth: internalja ühendage sellegarequireService(Fastify) võiserviceMiddleware(Express). Kaitse lükkab tagasi kõigi teiste jaoks vermitud tõendi (token). Vastake kiiresti ja muutke sama töö teistkordne edastamine kahjutuks.plugin_queuepikema töö jaoks, mille järel inimene ootab ja kus elutsüklit haldab teie tööline. Tööline peab viima käivituse alustades olekusserunningja lõpetades lõppolekusse; tööline, mis ainult postitab oma tulemuse, jätab käivituse igaveseks olekussequeued.llm_only, kui töö teeb ära üks mudeli väljakutse fikseeritud süsteemiviibaga ning teie plugin oncorevõiverified.tool_using, kui mudel peab tööriistu tsüklis välja kutsuma, jällegi ainult tasemelcorevõiverified.map, kui soovite, et platvorm jaotaks mõne teie teise oskuse üle loendi laiali (fan out).
Minu orbiidi propagatsiooni oskus Corrán Orbitalis on host_callback. Meie plugin on community, seega polnud mudelitasemed kunagi valikus ja ma ei tunne neist puudust: propagaator, mis annaks teisipäeval teistsuguse vastuse, oleks hullem kui kasutu.
Kinnitamine enne iga käivitust
Manifesti oskus, mis ei tohi kunagi käivituda pelgalt masina otsusel, deklareerib selle nii:
"approval": { "required": true, "reason": "Re-planning a pass needs the flight dynamics lead." }required on alati true; oskus, mis kinnitust ei vaja, jätab selle ploki ära. reason on see, mida kinnitaja näeb, 1 kuni 500 tähemärki pärast tühikute kärpimist, ja mis tahes muu kuju lükatakse tagasi veaga APPROVAL_INVALID. Oskuse suunamine pannakse seejärel ootele: suunamine vastab koodiga 202 koos olekuga status: "awaiting_approval" ja väljaga waitpointId, ning ainult nimelise isiku kinnitus vabastab selle üheks korraks. Ootel oleva oskuse pakk- (batch), vastendus- (map) või ahelsuunamine (chain) lükatakse tagasi veaga SKILL_APPROVAL_NOT_HOLDABLE, sest laialijaotus ei saa oma elemente ootel hoida. Kuvage ootel olev vastus ja laske kinnitajal otsustada; ärge suunake tööd enne ja küsige nõusolekut alles seejärel.
Sünkroonimine registriga
Iga sünkroonimine on deklaratiivne ja seda kontrollitakse tervikuna. Saatke iga kord kogu oskuste komplekt: oskus, mille välja jätate, keelatakse, kuid selle käivitusajalugu jääb alles. Üks vigane oskus lükkab kogu sünkroonimise tagasi veaga SYNC_CONTRACT_VIOLATION, kusjuures kõik rikkumised loetletakse koos ja midagi ei kirjutata, nii et plugin ei jää kunagi poolikult uuendatuks. Peatükk 2.22, Plugina käituskeskkond, käsitleb sünkroonimise väljakutset ja seda, kuidas platvorm teab, milline plugin välja kutsub.
Valik kahe liigi vahel
Kui ülesanne on „ütle seda iga kord samamoodi“, on tegu Skills Engine'i oskusega. Kui ülesanne on „käivita minu kood ja anna mulle selle vastus“, on tegu manifesti oskusega. Enamik päris tööst on lõpuks mõlemat: Harrow sildumiskokkuvõte on Skills Engine'i oskus, mille tööriistad pärinevad pluginast, ja plugina tööriistad on omakorda deklareeritud selle manifestis. Skills Engine'i oskust on neist kahest odavam muuta, mis on hea põhjus hoida sõnastus ja otsustusloogika seal ning aritmeetika pluginas.
Kulu on reaalne mõlemal juhul. Skills Engine'i oskus ei ole valmis siis, kui SKILL.md on hästi loetav; see on valmis siis, kui selle testjuhud läbivad, selle proovikäivitus ühtib inimeste otsustega ja keegi, kes ei ole teie, on selle kinnitanud. Arvestage kirjutava oskuse jaoks nädalaga, millest enamik kulub kanaarirežiimile.



