Versio 1.0.0-alpha.1uusin
Luku 2.20
Taidot (Skills)
Kuinka kirjoitat, testaat ja julkaiset Skills Engine -taidon, missä se näkyy julkaisun jälkeen ja kuinka lisäosan manifestitaidot eroavat siitä. Sisältää käytännön esimerkin laituripaikkojen jakamisen yhteenvedosta Harrow Port Authoritylle.
Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

Harrow Port Authorityn alustainsinööri Tomás Reilly kysyi minulta viime kuussa, miksi hänen laituripaikkasuunnittelijansa saivat joka kerta eri vastauksen kysyessään avustajalta ”kuka on milläkin laituripaikalla huomenna, ja mikä on siirtynyt?”. Vastaus oli, ettei kukaan ollut kertonut avustajalle, miltä hyvä vastaus näyttää. Skills Engine -taito korjasi asian yhdessä iltapäivässä: suunnittelijat saavat nyt joka kerta saman kolmiosaisen yhteenvedon, jossa on ensin laituripaikkataulukko, sen alla muutokset edellisen suunnitelman jälkeen ja viimeisenä päällekkäisyydet. Tässä luvussa käydään tuo taito läpi alusta loppuun ja käsitellään sitten toisenlaista taitoa, joka elää lisäosan manifestissa.
Kahdenlaisia taitoja
Nexus käyttää sanaa ”taito” (skill) kahdesta eri asiasta, ja ne rakennetaan eri tavalla.
| Skills Engine -taito | Manifestitaito | |
|---|---|---|
| Mikä se on | SKILL.md-paketti taitokirjastossa |
Tyypitetty rivi lisäosan skills[]-taulukossa |
| Kuka sen kirjoittaa | Kuka tahansa, jolla on oikeus, luontityökalussa tai omassa editorissaan | Kehittäjä, lisäosan sisällä |
| Mitä se sisältää | Ohjeet, työkalut joita se saa kutsua, valinnaiset tiedostot ja komentosarjat | Syöte- ja tulosteskeeman, tason sekä kyseisen tason tarvitsemat kentät |
| Miten se päätyy alustalle | Validoidaan, ladataan ja julkaistaan Skills Engineen | Käännetään manifestista ja synkronoidaan taitorekisteriin |
| Mikä sen suorittaa | Avustaja, agentit, työnkulut, tekoälypainikkeet (AI, artificial intelligence), Claude Code | UNO-työnkulkumoottorin (workflow engine) lähetys |
| Tyypillinen käyttö | ”Tiivistä laituripaikkasuunnitelma joka kerta samalla tavalla” | ”Suorita kiertoratapropagaattorimme tälle ylitykselle” |
Luvun loppuosassa ne pidetään erillään. Jos kappaleessa puhutaan pelkästä ”taidosta”, kyseessä on Skills Engine -taito.
Osa 1: Skills Engine -taidot
Mikä taito on
Taito on kansio. Sen SKILL.md kertoo, mitä varten taito on ja miten työ tehdään; sen rinnalla ovat työn tarvitsemat tiedostot ja sen suorittamat komentosarjat. Moottori lataa taidon kolmessa kerroksessa: nimen ja kuvauksen aina, ohjeet kun tehtävä kutsuu taitoa, ja tiedostot vain silloin, kun jokin vaihe tarvitsee niitä. Siksi asennuksessa voi olla kaksisataa taitoa lähes ilman kustannuksia, kunnes yhtä niistä käytetään.
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
Hakemiston nimen on vastattava taidon polkutunnusta (slug). Poikkeama aiheuttaa validointivaroituksen, ja se kannattaa korjata, sillä kirjasto yhdistää latauksen olemassa olevaan taitoon polkutunnuksen perusteella.
SKILL.md-tiedoston etumääritteet
Etumääritteet (frontmatter) ovat YAML-muotoista tietoa kahden ----rivin välissä tiedoston alussa. Muoto vaatii kolme kenttää. Itse validointi pysähtyy vain muutamaan asiaan: puuttuvaan nimeen tai kuvaukseen sekä polkutunnukseen tai työtyyppiin, joka on jo varattu. Kaikesta muusta se ilmoittaa varoituksena.
| Kenttä | Tyyppi | Pakollinen | Mitä se sisältää |
|---|---|---|---|
name |
merkkijono | kyllä | Yksilöllinen tunniste kebab-case-muodossa |
description |
merkkijono | kyllä | Mitä taito tekee, enintään 500 merkkiä. Kirjasto ja kohdistin lukevat sen, joten kirjoita se lukijalle, joka päättää, onko tämä oikea taito |
allowed-tools |
merkkijono tai lista | kyllä | Työkalut, joita taito saa kutsua. Se voi vain kaventaa suorittajansa sallittujen listaa |
triggers |
lista | ei | Vinoviivakomennot, jotka kutsuvat taitoa suoraan |
capabilities |
lista | ei | Rakenteiset kyvykkyydet, joista jokaisella on name, description ja valinnaisesti input_schema, output_schema ja examples |
version |
merkkijono | ei | Semanttinen versio; 1.0.0 jos jätetään pois |
visibility |
merkkijono | ei | private, team tai public |
status |
merkkijono | ei | draft, testing tai published |
Pidä ohjeet alle noin 5 000 sanakkeen (token) pituisina. Ole täsmällinen ja anna esimerkkejä. Jokaisen taidon tulisi tehdä yksi työ hyvin; jos huomaat kirjoittavasi ”ja lisäksi”, sinulla on luultavasti käsissäsi kaksi taitoa.
skill.yaml
skill.yaml sisältää sen, mitä moottori tarvitsee etsintään ja kirjastoon, jotta SKILL.md pysyy luettavana. Moottorin lukemia kenttiä ovat name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools ja capabilities. Kyvykkyys voi sisältää kentän query_patterns, eli ilmaisut, jotka kohdistimen tulisi ohjata sille. Mukana on myös vihjeitä moottorin omaa budjetointia varten: complexity, estimated_tokens ja required_services.
scripts/
Kaikki scripts/-kansion alla oleva pakataan sellaisenaan taidon mukaan komponentiksi. Komentosarja suoritetaan, eikä sitä koskaan lueta mallin kontekstiin, ja se ajetaan hiekkalaatikossa. Käytä komentosarjaa, kun vaihe sisältää laskentaa tai jäsennystä, jota mallin ei pitäisi tehdä päässään.
Näkyvyys ja tila
Näkyvyys määrittää, kuka voi löytää taidon: private tarkoittaa sinua, team tiimiäsi ja public kaikkia siinä organisaatiossa, jota kirjasto palvelee. Konsolissa sama valinta näkyy muodossa ”Vain minä”, tiiminä kuten ”Tullauspiste” tai koko organisaationa, ja taito voidaan myös jakaa toimialapakettiin kyseisen paketin oman katselmoinnin kautta.
Tila kertoo, missä elinkaarensa vaiheessa taito on.
| Tila | Merkitys |
|---|---|
draft |
Keskeneräinen; ei löydettävissä |
testing |
Validoitavana, rajoitettu pääsy |
published |
Yleisesti käytettävissä |
deprecated |
Korvattu; poistumassa käytöstä |
Kun versio on julkaistu, se ei muutu koskaan. Konsolissa ”live”, ”canary” ja ”shadow” ovat versioiden tunnisteita, ja aiempaan versioon palaaminen siirtää tunnistetta. Käynnissä olevat ajot suoritetaan loppuun sillä versiolla, jolla ne aloitettiin.
SKILL.md-luonnos, sen rinnalla olevat tiedostot ja niiden latausajankohta sekä työkalut, joita taito saa kutsua. Tarkistavalle taidolle ei tarjota kirjoittavia työkaluja, ja taito voi vain kaventaa suorittajan sallittujen listaa.Kansiosta julkaistuksi taidoksi
Viisi Skills Enginen tietovarastossa olevaa npm-komentosarjaa vievät taidon editoristasi kirjastoon ja todistavat sen saapuneen perille.
| Komento | Mitä se tekee |
|---|---|
npm run skill:validate skills/<slug> |
Tarkistaa paketin. Julkaisu vaatii nolla virhettä |
npm run skill:upload skills/<slug> |
Validoi ja julkaisee yhdessä vaiheessa; idempotentti |
npm run skill:upload skills/<slug> --dry-run |
Validoi ja tulostaa suunnitelman kirjoittamatta mitään |
npm run skill:publish -- --dry-run skills/<slug> |
Latauksen taustalla oleva alemman tason julkaisu, sama putki |
npm run skill:reconcile |
Vertaa tietovarastosi taitoja kirjaston ja taitorekisterin sisältöön |
npm run skill:live:verify |
Tarkistaa julkaistun taidon alusta loppuun käynnissä olevassa asennuksessa |
Julkaiseminen kirjoittaa kaksi tietuetta, ja molemmilla on merkitystä. Toinen on itse taito, joka sisältää SKILL.md-rungon, kyvykkyydet, komponentit ja laatutietueen; kirjasto, etsintä ja kohdistus lukevat sitä. Toinen on rekisteritietue, jota vasten työnkulkumoottori selvittää lähetyksen. Taito, joka on päätynyt vain rekisteriin, voidaan suorittaa, mutta se on näkymätön kirjastossa, kunnes lataat sen sinne.
Julkaiseminen on idempotentti toimenpide. Muuttumaton taito ei aiheuta toimenpiteitä, ja olemassa oleva taito tunnistetaan sen polkutunnuksesta ja päivitetään paikoilleen, eikä sitä koskaan luoda uudelleen. Jos lataat samat tavut kuin jo julkaistussa versiossa, saat kyseisen version takaisin tilalla CONTENT_HASH_ALREADY_PUBLISHED, etkä kaksoiskappaletta.
skill:reconcile käy läpi tietovarastosi taidot ja vertaa niitä kirjastoon, rekisteriin ja työnkulkumoottorin inventaarioon sekä raportoi kaiken, mikä on olemassa yhdessä paikassa mutta ei toisessa. skill:live:verify menee pidemmälle käynnissä olevassa asennuksessa: molemmat tietueet ovat olemassa ja osoittavat toisiinsa samalla sisältötiivisteellä, taidon työtyypin kuiva-ajolähetys hyväksytään, taito näkyy kirjaston listassa ja tiedoissa, sitä voidaan kutsua, ja kirjausketju sitoo julkaisun, lähetyksen ja ajon yhteen polkutunnuksen ja pyyntötunnisteen avulla.
Työasemalta lataus tavoittaa asennuksen tietämyspalvelun, nexus-graphrag, porttiohjauksen kautta, ja se vaatii ympäristömuuttujaksi Skills Enginen palveluavaimen. Lataa avain tulostamatta sitä näytölle:
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-summaryKlusterin sisällä, putkityössä, oletusosoite selviää itsestään eikä muuttujaa GRAPHRAG_URL tarvita. Hae avain organisaatiosi oman salaisuuksien hallintaprosessin kautta. Sitä ei saa koskaan tallentaa tietovarastoon, komentotulkin historiaan tai komennon tulosteeseen.
Testit, hyväksyntä ja käyttöönotto
Taito saapuu kirjastoon luonnoksena, ja luontityökalu pitää sen siellä, kunnes kolme asiaa on läpäisty.
| Tarkistus | Mitä se tekee |
|---|---|
| Testitapaukset | Jokaisen tapauksen on mentävä läpi, ennen kuin taito voi edetä hyväksyttäväksi. Tapauksen voi poistaa vain perustelulla, jonka hyväksyjät näkevät. |
| Kuiva-ajo varjotilassa | Taitoa ajetaan aiemmalla työllä niin, ettei kukaan näe vastauksia, ja sen tuloksia verrataan siihen, mitä ihminen aikanaan päätti. |
| Sokkokatselmointi toisen malliperheen mallilla | Se etsii ohitettua tarkistusta, keksittyä lähdettä ja ujutettua ohjetta, jota taito noudatti vaikka ei olisi pitänyt. |
Sitten seuraa hyväksyntä. Taito, joka lisää kirjoittavan työkalun, pidätetään, kunnes kaksi henkilöä hyväksyy sen pääsyavaimillaan (passkey), eikä ehdotuksen tekijä voi olla toinen heistä (PUBLISH_NEEDS_APPROVAL). Sen jälkeen se otetaan käyttöön varjotilassa, sitten kanarianjulkaisuna yhdelle yksikölle nimettyjen porttien takana ja lopuksi kaikille. Jos kanarianjulkaisun porttiehto ei täyty, kanarianjulkaisu pysäyttää itsensä ja kaikki pysyvät edellisessä versiossa; sen jakaminen kaikille etuajassa vaatii perustelun ja toisen hyväksyjän (CANARY_GATE_NOT_MET).
Community-versiossa luontityökalu, kirjasto, versiot ja testit ovat kaikki käytettävissä, ja omistaja julkaisee taidon yksin heti, kun testit menevät läpi. Kanarianjulkaisu, kahden henkilön hyväksyntä, lisäosien synkronointi ja kaksoiskappaleiden yhdistäminen tulevat Enterprise-version mukana.
Missä taidot näkyvät
Sama julkaistu taito tavoittaa käyttäjät viidessä paikassa.
- Avustaja yhdistää pyynnön taitoon sen kuvauksen, herätteiden ja kyselymallien perusteella sekä noudattaa taidon ohjeita.
- Agentit ja työnkulut kutsuvat taitoja vaiheina. Työnkulun vaihe nimeää taidon; ajo tallentaa tiedon siitä, mitä versiota se käytti.
- Näyttöjen tekoälypainikkeet suorittavat kukin yhden taidon. Pääkäyttäjä voi avata ”Tietoja tästä painikkeesta” -näkymän nähdäkseen, mitä taitoa painike suorittaa, mitä se lukee ja kuka sitä viimeksi muutti, ja voi poistaa painikkeen käytöstä koskematta itse taitoon.
- IDE-kehitysympäristösi (integrated development environment) ja Claude Code käyttävät kirjastoa Workbenchin ja kolmentoista MCP-työkalun (Model Context Protocol) kautta, joiden joukossa ovat
list_skills,get_skill,match_prompt,discover_skills,invoke_skill,record_execution,create_skill,import_skill,get_generation_jobjasync_skills_local. Jokainen kutsu suoritetaan sen käynnistäneen henkilön oikeuksilla, hänen sallittujen listansa puitteissa. - Itse taitokirjasto, jossa käyttäjät selaavat ja suorittavat taitoja sekä ehdottavat niihin muutoksia, ja jossa pääkäyttäjät näkevät kunkin taidon omistajan, käyttäjät, ajot ja kulutuksen.
Riippumatta siitä, mikä taitoa suorittaa, taito ei voi laajentaa suorittajan valtuuksia: se kutsuu vain suorittajan sallittujen listalla olevia työkaluja ja lukee vain sitä, minkä kyseinen henkilö saa avata (SKILL_CANNOT_WIDEN_TOOLS). Ajo, jolla ei ole mallireittiä, hylätään arvaamisen sijaan (SKILLS_ENGINE_BINDING_MISSING); lähettäjä valitsee reitin organisaation omasta mallimäärityksestä.
Käytännön esimerkki: laituripaikkavarauksen yhteenveto Harrow'lle
Harrow'n suunnittelijoilla oli jo sallittujen listallaan kaksi vain luku -työkalua Harrow'n omasta laituripaikkasuunnittelulisäosasta: berth-plan.read palauttaa tietyn päivämäärän suunnitelman, ja vessel-call.read palauttaa aluskäynnin saapumisikkunoineen ja pituuksineen. Taito ei tarvitse muuta. Se ei koskaan kirjoita, joten se ei koskaan tarvitse kahta hyväksyjää.
---
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.Sen rinnalla oleva skill.yaml antaa kirjastolle näyttönimen, kategorian ja ilmaisut, jotka kohdistimen tulisi ohjata tänne:
# 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 *"Sitten komennot tietovaraston juuresta:
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 lisäsi luontityökalussa kuusi testitapausta: tavallinen päivä, päivä jolloin myöhästynyt saapuminen siirsi kahta aluskäyntiä, päivä jolloin oli aito päällekkäisyys, päivämäärä jolle ei vielä ollut suunnitelmaa, laituripaikalleen liian pitkä alus sekä pyyntö, joka yritti saada taidon ehdottamaan uutta laituripaikkaa (sen ei pitäisi; sillä ei ole kirjoittavaa työkalua). Kuiva-ajo toisti kaksikymmentä aiempaa suunnitelmaa varjotilassa. Kun tapaukset menivät läpi, suunnittelupisteen katselmoija hyväksyi taidon, ja se otettiin käyttöön suunnittelutiimille. Avustaja vastaa nyt kysymykseen joka kerta samassa muodossa, ja suunnittelijoiden tekoälypainike laituripaikkasuunnitelmasivulla suorittaa samaa taitoa.
Osa 2: manifestitaidot
Manifestitaito on laskentayksikkö, jonka lisäosa julkaisee. Se määritellään manifestin skills[]-osassa, validoidaan SDK-kehityspaketilla (software development kit) kun suoritat komennon create-nexus-plugin validate, käännetään rekisterirungoksi komennolla compileRegistry ja synkronoidaan taitorekisteriin. Et koskaan kirjoita rekisterin SQL-koodia käsin, joten alustan lähettämä rivi ja määrittelemäsi kuvaus eivät voi erkaantua toisistaan.
Jokainen manifestitaito tarvitsee kentät id, displayName, description, tier, classification, inputSchema ja outputSchema. Määrittele myös timeoutMs: se on kokonaisluku väliltä 1 000 – 21 600 000 (yhdestä sekunnista kuuteen tuntiin), ja kyseisen alueen ulkopuolinen arvo hylätään virheellä TIMEOUT_OUT_OF_BOUNDS. dataResidency on any, eu tai us, ja any on oletusarvo.
id on lower_snake-muodossa, ja rekisterin lähetysavain on nimiavaruudellinen työtyyppi <plugin name>.<skill id>, joten kahdella lisäosalla voi molemmilla olla summarise-taito ilman törmäystä. Tässä on mallipohjan ainoa taito tiivistettynä:
{
"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
}Viisi tasoa
Taso ei ole pelkkä tunniste. Jokaisella tasolla on omat kenttänsä, ja toiselle tasolle kuuluva kenttä hylätään virheellä FIELD_NOT_FOR_TIER sen sijaan, että se jätettäisiin hiljaisesti huomiotta.
| Taso | Vaatii | Kutsuu mallia | Kuka sen suorittaa |
|---|---|---|---|
host_callback |
hostCallback: oma Service-palvelusi, sen portti, polku ja molemmat tavurajat |
Ei | Alusta lähettää syötteen POST-pyyntönä omaan Service-palveluusi, oman nimiavaruutesi sisällä |
plugin_queue |
queueName, kirjoitettuna muodossa <plugin name>.<name> |
Ei | Oma taustasuorittimesi (worker), joka hakee työt omasta jonostasi |
tool_using |
systemPrompt ja tools[]; luottamustaso core tai verified |
Kyllä | Alusta, AI Provider Router -reitittimen kautta; jokainen työkalukutsu ajetaan sallittujen listalla olevan suorittimen kautta |
llm_only |
systemPrompt; luottamustaso core tai verified |
Kyllä | Alusta, yksi kutsu AI Provider Router -reitittimen kautta |
map |
map.perItemJobType, joka nimeää toisen saman manifestin taidon, joka ei ole map-tyyppinen |
Vain kohteensa kautta | Alusta suorittaa kohteen kerran kutakin alkiota kohden ja kokoaa tulokset |
Kumpikaan mallitaso ei nimeä palveluntarjoajaa tai mallia. Reititin valitsee molemmat lähettävän organisaation omasta varannosta. tool_using-taidon työkalu nimeää yhden kuudesta suorittimesta: standing_service_call (oma Service-palvelusi), graphrag, graphrag_query, graphrag_search, h3 tai web_search. Mikä tahansa muu hylätään virheellä EXECUTOR_NOT_PERMITTED. Kolme tietämysverkoston suoritinta hyväksyvät vain työkalunimet graphrag_query ja graphrag_search, koska suoritin ajaa sen operaation, jonka mukaan työkalu on nimetty.
Rekisterissä on kaksi tasoa, joita lisäosa ei voi määritellä: ketjut ja itsenäisesti suoritettavat taidot ovat vain alustan kirjoittamia. Synkronointi, joka nimeää jommankumman, hylätään kokonaisuudessaan.
Mitä tasoa tulisi käyttää
host_callback, kun työ on syötteen funktio, jonka oma koodisi laskee: pisteytys, laskutoimitus tai haku omasta skeemastasi. Se on yksinkertaisin testata ja mallipohjan oletusarvo. Suojaa takaisinkutsureitti: manifestissa oleva polku ei ole salaisuus, ja reitin on varmennettava alustan kutsu ja otettava organisaatio siitä, ei koskaan pyynnön rungosta. Määrittele silleauth: internalja liitä siihenrequireService(Fastify) taiserviceMiddleware(Express). Suojaus hylkää kenelle tahansa muulle luodun poletin. Vastaa nopeasti ja tee saman työn toisesta toimituskerrasta harmiton.plugin_queuepidempään työhön, jota käyttäjä jää odottamaan ja jossa oma taustasuorittimesi hallitsee elinkaarta. Taustasuorittimen on siirrettävä ajo tilaanrunningaloittaessaan ja päätöstilaan lopettaessaan; taustasuoritin, joka vain lähettää tuloksensa, jättää ajon tilaanqueuedpysyvästi.llm_only, kun yksi mallikutsu kiinteällä järjestelmäkehotteella hoitaa työn ja lisäosasi luottamustaso oncoretaiverified.tool_using, kun mallin on kutsuttava työkaluja silmukassa, jälleen vain tasollacoretaiverified.map, kun haluat alustan hajauttavan jonkin toisen taidoistasi listan alkioille.
Oma kiertoradan propagointitaitoni Corrán Orbitalilla on host_callback. Lisäosamme on community, joten mallitasot eivät koskaan olleet vaihtoehto, enkä kaipaa niitä: propagaattori, joka antaisi tiistaina eri vastauksen, olisi pahempi kuin hyödytön.
Hyväksyntä ennen jokaista ajoa
Manifestitaito, jota ei saa koskaan suorittaa pelkästään koneen päätöksellä, määrittelee sen näin:
"approval": { "required": true, "reason": "Re-planning a pass needs the flight dynamics lead." }required on aina true; taito, joka ei vaadi hyväksyntää, jättää lohkon pois. reason on teksti, jonka hyväksyjä näkee, pituudeltaan 1–500 merkkiä tyhjien merkkien poiston jälkeen, ja mikä tahansa muu muoto hylätään virheellä APPROVAL_INVALID. Taidon lähetys jää tällöin pidätetyksi: lähetys vastaa koodilla 202 sekä arvoilla status: "awaiting_approval" ja waitpointId, ja vain nimetyn henkilön hyväksyntä vapauttaa sen, yhden kerran. Pidätetyn taidon erä-, map- tai ketjulähetys hylätään virheellä SKILL_APPROVAL_NOT_HOLDABLE, koska hajautus ei voi pidättää yksittäisiä alkioitaan. Esitä pidätetty vastaus käyttöliittymässä ja anna hyväksyjän päättää; älä lähetä taitoa ja pyydä suostumusta vasta sen jälkeen.
Synkronointi rekisteriin
Jokainen synkronointi on deklaratiivinen ja tarkistetaan kokonaisuutena. Lähetä koko taitojoukko joka kerta: pois jättämäsi taito poistetaan käytöstä, ja sen ajohistoria säilyy. Yksikin virheellinen taito hylkää koko synkronoinnin koodilla SYNC_CONTRACT_VIOLATION, jolloin kaikki rikkomukset listataan yhdessä eikä mitään kirjoiteta, joten lisäosa ei koskaan päivity vain puoliksi. Luku 2.22, Lisäosan ajonaikainen ympäristö, käsittelee synkronointikutsua ja sitä, miten alusta tietää, mikä lisäosa kutsuu.
Valinta kahden tyypin välillä
Jos tehtävänä on ”sano tämä joka kerta samalla tavalla”, kyseessä on Skills Engine -taito. Jos tehtävänä on ”suorita koodini ja anna minulle sen vastaus”, kyseessä on manifestitaito. Suurin osa oikeasta työstä päätyy olemaan molempia: Harrow'n laituripaikkayhteenveto on Skills Engine -taito, jonka työkalut tulevat lisäosasta, ja lisäosan työkalut on puolestaan määritelty sen manifestissa. Skills Engine -taito on näistä kahdesta edullisempi muuttaa, mikä on hyvä syy pitää sanamuodot ja harkinta siellä ja laskenta lisäosassa.
Kustannus on joka tapauksessa todellinen. Skills Engine -taito ei ole valmis silloin, kun SKILL.md on sujuvasti kirjoitettu; se on valmis, kun sen testitapaukset menevät läpi, sen kuiva-ajo täsmää ihmisten tekemien päätösten kanssa ja joku muu kuin sinä itse on hyväksynyt sen. Varaa kirjoittavalle taidolle viikko, josta suurin osa kuluu kanarianjulkaisuun.



