Kirjaudu sisäänVaraa esittely

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

17 minuutin lukuaika

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.

Uusi taito · 2 Ohjeet ja työkalut
Uusi taito · 2 Ohjeet ja työkalut
Luontityökalun toisessa vaiheessa näkyy 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-summary

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

Uusi taito · 4 Julkaise
Uusi taito · 4 Julkaise
Julkaisunäkymä näyttää, miksi taito on pidätettynä, kenen on annettava suostumus ja miten se etenee tuotantoon: hyväksytty, varjotilassa, kanarianjulkaisuna nimettyjen porttien takana ja lopuksi kaikille. Ehdottaja ei voi hyväksyä omaa muutostaan, ja edellinen versio pysyy valmiina palautusta varten.

Missä taidot näkyvät

Sama julkaistu taito tavoittaa käyttäjät viidessä paikassa.

  1. Avustaja yhdistää pyynnön taitoon sen kuvauksen, herätteiden ja kyselymallien perusteella sekä noudattaa taidon ohjeita.
  2. Agentit ja työnkulut kutsuvat taitoja vaiheina. Työnkulun vaihe nimeää taidon; ajo tallentaa tiedon siitä, mitä versiota se käytti.
  3. 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.
  4. 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_job ja sync_skills_local. Jokainen kutsu suoritetaan sen käynnistäneen henkilön oikeuksilla, hänen sallittujen listansa puitteissa.
  5. 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ä.

Tietoja tästä painikkeesta
Tietoja tästä painikkeesta
Tietoja tästä painikkeesta -näkymä näyttää, mitä taitoa tekoälypainike suorittaa, mitkä kolme lähdettä se lukee, kuka sen on kirjoittanut ja katselmoinut sekä mitä uusimmassa versiossa on muutettu. Painikkeen poistaminen käytöstä poistaa sen kaikkialta kerralla; taito ja kaikki aiemmat vastaukset säilyvät.

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

Tomá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 sille auth: internal ja liitä siihen requireService (Fastify) tai serviceMiddleware (Express). Suojaus hylkää kenelle tahansa muulle luodun poletin. Vastaa nopeasti ja tee saman työn toisesta toimituskerrasta harmiton.
  • plugin_queue pidempään työhön, jota käyttäjä jää odottamaan ja jossa oma taustasuorittimesi hallitsee elinkaarta. Taustasuorittimen on siirrettävä ajo tilaan running aloittaessaan ja päätöstilaan lopettaessaan; taustasuoritin, joka vain lähettää tuloksensa, jättää ajon tilaan queued pysyvästi.
  • llm_only, kun yksi mallikutsu kiinteällä järjestelmäkehotteella hoitaa työn ja lisäosasi luottamustaso on core tai verified.
  • tool_using, kun mallin on kutsuttava työkaluja silmukassa, jälleen vain tasolla core tai verified.
  • 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.

Taidot IDE:ssä ja Claude Codessa
Taidot IDE:ssä ja Claude Codessa
Taidot IDE:ssä ja Claude Codessa -näkymä näyttää samat validointi-, lataus- ja julkaisuvaiheet kehittäjän omasta päätteestä, jossa luonnos on pidätettynä hyväksyntää varten, koska sen tekijä ei voi hyväksyä omaa muutostaan.

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.