Útgáfa 1.0.0-alpha.1nýjast
Kafli 2.20
Færniþættir
Hvernig á að skrifa, prófa og gefa út færniþátt í Skills Engine, hvar hann birtist þegar hann er orðinn virkur og hvernig færniþættir í yfirlýsingaskrá í viðbót eru ólíkir. Inniheldur útfærða samantekt á úthlutun leguplássa fyrir Harrow Port Authority.
Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

Tomás Reilly, kerfisverkfræðingur hjá Harrow Port Authority, spurði mig í síðasta mánuði hvers vegna viðleguskipuleggjendur hans fengju mismunandi svar í hvert skipti sem þeir spurðu aðstoðarforritið „hver er við hvaða viðlegukant á morgun, og hvað færðist til?“. Svarið var að enginn hafði sagt aðstoðarforritinu hvernig gott svar lítur út. Færni í Skills Engine leysti þetta á einu síðdegi: skipuleggjendurnir fá nú sömu þrískiptu samantektina í hvert skipti, með töflu yfir viðlegukanta fyrst, breytingum frá síðustu áætlun þar fyrir neðan, og árekstrum síðast. Þessi kafli fer í gegnum þá færni frá upphafi til enda, og fjallar síðan um hina tegund færni, þá sem býr í lýsiskrá (manifest) viðbótar.
Tvær tegundir af færniþáttum
Nexus notar orðið „færni“ (skill) yfir tvo ólíka hluti, og þeir eru smíðaðir á ólíkan hátt.
| Skills Engine-færni | Færni í lýsiskrá | |
|---|---|---|
| Hvað það er | SKILL.md-pakki í færnisafninu |
Tagsett röð í skills[]-fylki viðbótar |
| Hver skrifar hana | Hver sá sem hefur réttindi til þess, í smiðnum eða eigin ritli | Forritari, inni í viðbót |
| Hvað hún inniheldur | Fyrirmæli, verkfærin sem hún má kalla á, valkvæðar skrár og skriftur | Inntaks- og úttaksskema, þrep (tier) og reitina sem það þrep þarf |
| Hvernig hún berst kerfinu | Sannreynd, hlaðið upp og gefin út í Skills Engine | Þýdd úr lýsiskránni og samstillt við færniskrána |
| Hvað keyrir hana | Aðstoðarforritið, erindrekar (agents), verkferlar, gervigreindarhnappar (AI buttons), Claude Code | Ræsing úr UNO (verkferlavélinni) |
| Dæmigerð notkun | „Dragðu saman viðleguáætlunina á sama hátt í hvert skipti“ | „Keyrðu brautarreikninn okkar á þessa yfirferð“ |
Í restinni af kaflanum er þeim haldið aðskildum. Ef málsgrein nefnir „færni“ eitt og sér, þá er átt við færni í Skills Engine.
Hluti 1: færniþættir í Skills Engine
Hvað færni er
Færni er mappa. SKILL.md-skrá hennar segir til hvers færnin er og hvernig eigi að vinna verkið; við hlið hennar eru allar skrár sem verkið þarf og allar skriftur sem það keyrir. Vélin hleður færni í þremur lögum: nafni og lýsingu alltaf, fyrirmælum þegar verkefni kallar á færnina, og skrám aðeins þegar skref þarf á þeim að halda. Þess vegna getur uppsetning geymt tvö hundruð færnieiningar og kostað nánast ekkert fyrr en ein þeirra er notuð.
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
Heiti möppunnar verður að vera það sama og vefslóðarheiti (slug) færninnar. Misræmi veldur viðvörun við sannprófun og það borgar sig að laga það, því vefslóðarheitið er það sem safnið notar til að para upphleðslu við færni sem þegar er til.
SKILL.md-forskeyti (frontmatter)
Forskeytið er YAML á milli tveggja ----lína efst í skránni. Sniðið krefst þriggja reita. Sannprófunin sjálf stöðvar ferlið aðeins vegna fárra atriða: ef nafn eða lýsingu vantar, og ef vefslóðarheiti (slug) eða verktegund er þegar í notkun. Allt annað er tilkynnt sem viðvörun.
| Reitur | Tegund | Áskilið | Hvað það geymir |
|---|---|---|---|
name |
strengur | já | Einkvæma auðkennið, í kebab-case |
description |
strengur | já | Hvað færnin gerir, að hámarki 500 stafir. Safnið og samsvörunarvélin lesa þetta, svo skrifaðu textann fyrir lesanda sem er að ákveða hvort þetta sé rétta færnin |
allowed-tools |
strengur eða listi | já | Verkfærin sem færnin má kalla á. Hún getur aðeins þrengt leyfislista þess sem keyrir hana |
triggers |
listi | nei | Skástriksskipanir sem kalla beint á færnina |
capabilities |
listi | nei | Skipulagðir eiginleikar, hver með name, description og valkvætt input_schema, output_schema og examples |
version |
strengur | nei | Merkingarfræðileg útgáfa (semantic version); 1.0.0 ef sleppt |
visibility |
strengur | nei | private, team eða public |
status |
strengur | nei | draft, testing eða published |
Haltu fyrirmælunum undir um það bil 5.000 táknum (tokens). Vertu nákvæmur og gefðu dæmi. Hver færni ætti að vinna eitt verk vel; ef þú stendur þig að því að skrifa „og einnig“, ertu líklega með tvær færnieiningar.
skill.yaml
skill.yaml geymir það sem vélin þarf fyrir leit og safnið, svo að SKILL.md haldist læsileg. Reitirnir sem vélin les eru meðal annars name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools og capabilities. Eiginleiki getur innihaldið query_patterns, orðalag sem samsvörunarvélin á að beina til hans. Einnig eru til vísbendingar fyrir kostnaðaráætlun vélarinnar sjálfrar: complexity, estimated_tokens og required_services.
scripts/
Allt undir scripts/ er pakkað óbreytt með færninni sem íhlutur. Skrifta er keyrð, aldrei lesin inn í samhengi líkansins, og hún keyrir í sandkassa. Notaðu skriftu þegar skref felur í sér reikning eða þáttun sem líkan ætti ekki að gera í huganum.
Sýnileiki og staða
Sýnileiki segir til um hver getur fundið færnina: private ert þú, team er teymið þitt, og public eru allir í fyrirtækinu sem safnið þjónar. Í stjórnborðinu birtist sami valkostur sem „Aðeins ég“, teymi eins og „Tollaborð“, eða allt fyrirtækið, og einnig er hægt að deila færni inn í fagsviðspakka (domain pack) í gegnum eigin yfirferð þess pakka.
Staða segir til um hvar færnin er stödd á líftíma sínum.
| Staða | Merking |
|---|---|
draft |
Verk í vinnslu; ekki finnanlegt |
testing |
Í sannprófun, með takmörkuðum aðgangi |
published |
Tiltækt til almennrar notkunar |
deprecated |
Úrelt; á leið úr notkun |
Þegar útgáfa hefur verið gefin út breytist hún aldrei. Í stjórnborðinu eru „live“, „canary“ og „shadow“ merkingar á útgáfum, og að skipta aftur í eldri útgáfu færir merkingu til. Keyrslur sem eru í gangi klárast á þeirri útgáfu sem þær hófust á.
SKILL.md, skrárnar við hlið hennar og hvenær hver þeirra hleðst inn, ásamt verkfærunum sem færnin má kalla á. Færni sem eingöngu athugar gögn stendur ekki til boða neitt verkfæri sem skrifar, og færni getur aðeins þrengt leyfislista þess sem keyrir hana.Úr möppu í virka færni
Fimm npm-skriftur í geymslu Skills Engine flytja færni úr ritlinum þínum í safnið og sanna að hún hafi skilað sér.
| Skipun | Hvað hann gerir |
|---|---|
npm run skill:validate skills/<slug> |
Yfirfer pakkann (lint). Útgáfa krefst þess að engar villur finnist |
npm run skill:upload skills/<slug> |
Sannprófar og gefur út í einu skrefi; endurtekin keyrsla hefur sömu áhrif og ein keyrsla (idempotent) |
npm run skill:upload skills/<slug> --dry-run |
Sannprófar og prentar áætlunina án þess að skrifa neitt |
npm run skill:publish -- --dry-run skills/<slug> |
Lægra stigs útgáfa á bak við upphleðslu, sama vinnslurás |
npm run skill:reconcile |
Ber saman færnieiningar í geymslunni þinni við það sem safnið og færniskráin geyma |
npm run skill:live:verify |
Athugar útgefna færni frá upphafi til enda á keyrandi uppsetningu |
Útgáfa skrifar tvær færslur og báðar skipta máli. Önnur er færnin sjálf, með SKILL.md-meginmáli sínu, eiginleikum, íhlutum og gæðaskrá; safnið, leitin og samsvörunarvélin lesa hana. Hin er færslan í skránni sem verkferlavélin leysir ræsingu gagnvart. Færni sem aðeins hefur ratað í skrána getur keyrt, en hún er ósýnileg í safninu þar til þú hleður henni upp.
Útgáfa er sjálfsvirk (idempotent): endurtekin útgáfa skilar alltaf sömu niðurstöðu. Óbreytt færni gerir ekkert (no-op), og færni sem þegar er til er pöruð eftir vefslóðarheiti sínu og uppfærð á staðnum, aldrei búin til upp á nýtt. Ef þér hlaðið upp sömu bætum og í útgáfu sem þegar hefur verið gefin út fáið þér þá útgáfu til baka með CONTENT_HASH_ALREADY_PUBLISHED, ekki tvítekningu.
skill:reconcile fer yfir færnieiningar geymslunnar þinnar og ber þær saman við safnið, skrána og birgðalista verkferlavélarinnar, og tilkynnir allt sem er til á einum stað en ekki öðrum. skill:live:verify gengur lengra á keyrandi uppsetningu: báðar færslur eru til og vísa hvor á aðra með sama innihaldstætigildi (content hash), prufuræsing á verktegund færninnar er samþykkt, færnin birtist á lista og í ítarupplýsingum safnsins, hægt er að kalla á hana, og aðgerðaskráin tengir saman útgáfuna, ræsinguna og keyrsluna eftir vefslóðarheiti og beiðniauðkenni.
Frá vinnustöð berst upphleðslan til þekkingarþjónustu uppsetningarinnar, nexus-graphrag, í gegnum gáttarframsendingu (port-forward), og hún þarf þjónustulykil Skills Engine í umhverfisbreytum. Hlaðið lyklinum inn án þess að birta hann á skjánum:
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-summaryInni í klasanum, í vinnslurásarverki, leysist sjálfgefna vistfangið af sjálfu sér og GRAPHRAG_URL er óþarft. Sæktu lykilinn í gegnum leyndarmálaferli fyrirtækisins þíns. Hann á aldrei heima í geymslunni, skeljarsögunni þinni eða í úttaki skipunar.
Prófanir, samþykki og virkjun
Færni kemur inn í safnið sem drög, og smiðurinn heldur henni þar þangað til þrjú atriði standast.
| Athugun | Hvað hann gerir |
|---|---|
| Prófunartilvik | Hvert tilvik verður að standast áður en hægt er að senda færnina í samþykki. Aðeins er hægt að fjarlægja tilvik ef gefin er ástæða, sem samþykkjendur sjá. |
| Prufukeyrsla í skugga (shadow) | Færnin keyrir á eldri verkefnum þar sem enginn sér svörin, og niðurstöður hennar eru bornar saman við það sem starfsmaður ákvað á sínum tíma. |
| Blind yfirferð af líkani úr annarri fjölskyldu | Hún leitar að athugun sem gleymdist, uppspunninni heimild og földum fyrirmælum sem færnin fylgdi þegar hún átti ekki að gera það. |
Síðan tekur við samþykki. Færni sem bætir við verkfæri sem skrifar er haldið aftur af þar til tveir aðilar samþykkja hana með aðgangslyklum sínum (passkeys), og sá sem lagði hana til getur ekki verið annar þeirra (PUBLISH_NEEDS_APPROVAL). Hún fer síðan í loftið í skuggaham (shadow), því næst í tilraunaham (canary) fyrir eina einingu á bak við nefnd hlið, og loks fyrir alla. Ef skilyrði tilraunahliðs eru ekki uppfyllt stöðvar tilraunakeyrslan sig sjálf og allir halda sig við fyrri útgáfu; til að senda hana til allra fyrr þarf rökstuðning og annan samþykkjanda (CANARY_GATE_NOT_MET).
Í Community-útgáfunni eru smiðurinn, safnið, útgáfurnar og prófanirnar öll til staðar, og eigandinn gefur út einn síns liðs um leið og prófanirnar standast. Tilraunakeyrslur (canary), tveggja manna samþykki, samstilling viðbóta og sameining tvítekninga fylgja Enterprise-útgáfunni.
Hvar færnieiningar birtast
Sama útgefna færnin nær til fólks á fimm stöðum.
- Aðstoðarforritið parar beiðni við færni eftir lýsingu hennar, kveikjum og fyrirspurnarmynstrum, og fylgir fyrirmælum færninnar.
- Erindrekar og verkferlar kalla á færnieiningar sem skref. Skref í verkferli nefnir færnina; keyrslan skráir hvaða útgáfu hún notaði.
- Gervigreindarhnappar á skjámyndum keyra hver sína færnina. Kerfisstjóri getur opnað „Um þennan hnapp“ til að sjá hvaða færni hnappurinn keyrir, hvað hún les og hver breytti henni síðast, og getur slökkt á hnappnum án þess að hreyfa við færninni.
- Þróunarumhverfið þitt (IDE) og Claude Code ná til safnsins í gegnum Workbench og þrettán MCP-verkfæri (Model Context Protocol):
list_skills,get_skill,match_prompt,discover_skills,invoke_skill,record_execution,create_skill,import_skill,get_generation_jobogsync_skills_localeru þar á meðal. Hvert kall keyrir í nafni þess sem ræsti það, innan leyfislista viðkomandi. - Færnisafnið sjálft, þar sem fólk vafrar, keyrir og leggur til breytingar á færnieiningum, og kerfisstjórar sjá eiganda hverrar færni, notendur, keyrslur og kostnað.
Hvað sem keyrir færni, þá getur færnin ekki rýmkað heimildir þess sem keyrir hana: hún kallar aðeins á verkfæri innan leyfislista keyrsluaðilans og les aðeins það sem sá einstaklingur má opna (SKILL_CANNOT_WIDEN_TOOLS). Keyrslu án líkanaleiðar er hafnað í stað þess að giskað sé á hana (SKILLS_ENGINE_BINDING_MISSING); ræsirinn velur leiðina út frá eigin líkanauppsetningu fyrirtækisins.
Sýnidæmi: samantekt á úthlutun viðlegukanta fyrir Harrow
Skipuleggjendur Harrow voru þegar með tvö lesverkfæri á leyfislistanum sínum úr eigin viðleguskipulagsviðbót Harrow: berth-plan.read skilar áætlun fyrir tiltekna dagsetningu, og vessel-call.read skilar skipakomum með komuglugga og lengd skips. Færnin þarf ekkert annað. Hún skrifar aldrei gögn, svo hún þarf aldrei tvo samþykkjendur.
---
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.skill.yaml-skráin við hlið hennar gefur safninu birtingarheiti, flokk og orðalagið sem samsvörunarvélin á að beina hingað:
# 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 *"Síðan skipanirnar, úr rótarmöppu geymslunnar:
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 bætti við sex prófunartilvikum í smiðnum: venjulegum degi, degi með seinkun á komu sem færði til tvær skipakomur, degi með raunverulegum árekstri, dagsetningu þar sem engin áætlun var enn tilbúin, skipi sem var of langt fyrir viðlegukantinn sinn, og beiðni sem reyndi að fá færnina til að leggja til nýjan viðlegukant (það ætti hún ekki að gera; hún hefur ekkert verkfæri sem skrifar). Prufukeyrslan endurspilaði tuttugu eldri áætlanir í skuggaham. Þegar tilvikin stóðust samþykkti yfirlesari á skipulagsborðinu færnina og hún fór í loftið fyrir skipulagsteymið. Aðstoðarforritið svarar nú spurningunni á sama formi í hvert skipti, og gervigreindarhnappur skipuleggjendanna á síðu viðleguáætlunarinnar keyrir sömu færnina.
Hluti 2: færniþættir í yfirlýsingaskrá
Færni í lýsiskrá (manifest skill) er sú reiknieining sem viðbót gefur út. Hún er skilgreind í skills[] lýsiskrárinnar, sannprófuð af þróunarbúnaðinum (SDK) þegar þú keyrir create-nexus-plugin validate, þýdd yfir í skráarmeginmál af compileRegistry, og samstillt við færniskrána. Þú skrifar aldrei SQL fyrir skrána í höndunum, þannig að röðin sem kerfið ræsir og lýsingin sem þú skilgreindir geta ekki farið á mis.
Hver færni í lýsiskrá þarf id, displayName, description, tier, classification, inputSchema og outputSchema. Skilgreindu timeoutMs líka: það er heiltala frá 1.000 til 21.600.000 (ein sekúnda til sex klukkustundir), og gildi utan þess bils er hafnað með TIMEOUT_OUT_OF_BOUNDS. dataResidency er any, eu eða us, og any er sjálfgefið.
id er í lower_snake-sniði, og ræsilykill skrárinnar er verktegundin <plugin name>.<skill id> með nafnarými, þannig að tvær viðbætur geta báðar verið með summarise-færni án árekstra. Hér er eina færni sniðmátsins, stytt:
{
"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
}Þrepin fimm
Þrepið er ekki bara merking. Hvert þrep hefur sína eigin reiti, og reit sem tilheyrir öðru þrepi er hafnað með FIELD_NOT_FOR_TIER í stað þess að honum sé sleppt þegjandi og hljóðalaust.
| Þrep | Krefst | Nær til líkans | Hver keyrir hana |
|---|---|---|---|
host_callback |
hostCallback: þín eigin Service-þjónusta, gátt hennar, slóð og bæði bætamörkin |
Nei | Kerfið sendir inntakið með POST á þína eigin Service-þjónustu, innan nafnarýmisins þíns |
plugin_queue |
queueName, stafsett <plugin name>.<name> |
Nei | Vinnsluþjónninn þinn (worker), sem sækir úr biðröðinni þinni |
tool_using |
systemPrompt og tools[]; trauststig core eða verified |
Já | Kerfið, í gegnum AI Provider Router; hvert verkfærakall keyrir í gegnum keyrslueiningu á leyfislista |
llm_only |
systemPrompt; trauststig core eða verified |
Já | Kerfið, eitt kall í gegnum AI Provider Router |
map |
map.perItemJobType, sem nefnir aðra færni í sömu lýsiskrá sem er ekki vörpun (map) |
Aðeins í gegnum markfærni sína | Kerfið keyrir markfærnina einu sinni fyrir hvert staki og safnar niðurstöðunum saman |
Hvorugt líkanaþrepið nefnir þjónustuveitu eða líkan. Beinirinn velur hvort tveggja úr eigin safni þess fyrirtækis sem ræsir. Verkfæri í tool_using-færni nefnir eina af sex keyrslueiningum: standing_service_call (þína eigin Service-þjónustu), graphrag, graphrag_query, graphrag_search, h3 eða web_search. Öllum öðrum er hafnað með EXECUTOR_NOT_PERMITTED. Þekkingarnetseiningarnar þrjár taka aðeins við verkfæraheitunum graphrag_query og graphrag_search, vegna þess að keyrslueiningin keyrir þá aðgerð sem verkfærið er nefnt eftir.
Tvö þrep eru til í skránni sem viðbót getur ekki skilgreint: keðjur og færnieiningar sem keyra sjálfstætt eru eingöngu skrifaðar af kerfinu. Samstillingu sem nefnir slíkt þrep er hafnað í heild sinni.
Hvaða þrep á að nota
host_callbackþegar verkið er fall af inntakinu sem þinn eigin kóði reiknar út: stigagjöf, útreikningur, uppfletting í þínu eigin skema. Það er einfaldast að prófa þetta og það er sjálfgefið í sniðmátinu. Verjið endurkallsslóðina (callback route): slóð í lýsiskrá er ekki leyndarmál, og slóðin verður að sannreyna kall kerfisins og sækja fyrirtækið þaðan, aldrei úr meginmálinu. Skilgreindu hana semauth: internalog tengdurequireService(Fastify) eðaserviceMiddleware(Express) við hana. Vörnin hafnar tóka sem var gefinn út fyrir einhvern annan. Svaraðu hratt, og gerðu aðra afhendingu á sama verki skaðlausa.plugin_queuefyrir lengri verk sem notandi bíður eftir, þar sem vinnsluþjónninn þinn stýrir líftímanum. Vinnsluþjónninn verður að færa keyrsluna írunningþegar hann byrjar og í lokastöðu þegar hann lýkur verkinu; vinnsluþjónn sem sendir aðeins inn niðurstöðuna sína skilur keyrsluna eftir í stöðunniqueuedað eilífu.llm_onlyþegar eitt líkanakall með föstum kerfisfyrirmælum (system prompt) dugir til að vinna verkið, og viðbótin þín ercoreeðaverified.tool_usingþegar líkanið þarf að kalla á verkfæri í lykkju, aftur aðeins á trauststigicoreeðaverified.mapþegar þú vilt að kerfið dreifi keyrslu á einni af hinum færnieiningunum þínum yfir lista.
Brautarreiknifærnin mín hjá Corrán Orbital er host_callback. Viðbótin okkar er community, þannig að líkanaþrepin komu aldrei til greina, og ég sakna þeirra ekki: brautarreiknir sem gæfi annað svar á þriðjudegi væri verri en gagnslaus.
Samþykki fyrir hverja keyrslu
Færni í lýsiskrá sem má aldrei keyra eingöngu að frumkvæði vélar lýsir því yfir:
"approval": { "required": true, "reason": "Re-planning a pass needs the flight dynamics lead." }required er alltaf true; færni sem þarf ekkert samþykki sleppir blokkinni. reason er það sem samþykkjandinn sér, 1 til 500 stafir eftir að bil hafa verið klippt af, og öllum öðrum sniðum er hafnað með APPROVAL_INVALID. Ræsingu á færninni er þá haldið aftur af: ræsingin svarar 202 með status: "awaiting_approval" og waitpointId, og aðeins samþykki tilgreinds einstaklings losar hana úr bið, í eitt skipti. Runu-, vörpunar- eða keðjuræsingu (batch, map, chain) á færni í bið er hafnað með SKILL_APPROVAL_NOT_HOLDABLE, vegna þess að útdreifing getur ekki haldið stökum sínum í bið. Birtu svarið um biðstöðu og láttu samþykkjandann úrskurða; ekki ræsa og biðja síðan um samþykki.
Samstilling við skrána
Hver samstilling er yfirlýsingabundin (declarative) og sannprófuð í heild sinni. Sendu allt færnisettið í hvert skipti: færni sem þú sleppir er gerð óvirk, en keyrslusaga hennar heldur sér. Ein gölluð færni hafnar allri samstillingunni með SYNC_CONTRACT_VIOLATION, þar sem öll brot eru talin upp saman og ekkert er skrifað, þannig að viðbót uppfærist aldrei til hálfs. Kafli 2.22, Keyrsluumhverfi viðbóta, fjallar um samstillingarkallið og hvernig kerfið veit hvaða viðbót er að kalla.
Val á milli tegundanna tveggja
Ef verkið er „segðu þetta á sama hátt í hvert skipti“, þá er það færni í Skills Engine. Ef verkið er „keyrðu kóðann minn og gefðu mér svarið hans“, þá er það færni í lýsiskrá. Flest raunveruleg verk enda sem hvort tveggja: viðlegusamantekt Harrow er færni í Skills Engine þar sem verkfærin koma úr viðbót, og verkfæri viðbótarinnar eru sjálf skilgreind í lýsiskrá hennar. Færnin í Skills Engine er ódýrari í breytingum af þessu tvennu, sem er góð ástæða til að halda orðalaginu og dómgreindinni þar en reikningnum í viðbótinni.
Kostnaðurinn er raunverulegur hvora leiðina sem farið er. Færni í Skills Engine er ekki tilbúin þegar SKILL.md lítur vel út; hún er tilbúin þegar prófunartilvikin standast, prufukeyrslan er sammála því sem fólk ákvað, og einhver annar en þú hefur samþykkt hana. Gerðu ráð fyrir viku í færni sem skrifar gögn, þar sem mestur tíminn fer í tilraunakeyrsluna (canary).



