Logi sisseBroneerige tutvustus

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

17 minutit lugemist

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.

Uus oskus · 2 Juhised ja tööriistad
Uus oskus · 2 Juhised ja tööriistad
Looja teine samm näitab 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-summary

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

Uus oskus · 4 Avaldamine
Uus oskus · 4 Avaldamine
Avaldamine näitab, miks oskust kinni hoitakse, kes peab nõustuma ja kuidas see käiku läheb: kinnitatud, varirežiimis, kanaarirežiimis nimeliste lävendite taga, seejärel kõigile. Ettepaneku tegija ei saa omaenda muudatust kinnitada ja viimane versioon jääb valmis tagasilülitamiseks.

Kus oskused on nähtavad

Sama avaldatud oskus jõuab inimesteni viies kohas.

  1. Assistent sobitab päringu oskusega selle kirjelduse, päästikute ja päringumustrite järgi ning järgib oskuse juhiseid.
  2. Agendid ja töövood kutsuvad oskusi välja sammudena. Töövookäik nimetab oskuse; käivitus salvestab, millist versiooni see kasutas.
  3. 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.
  4. 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_job ja sync_skills_local. Iga väljakutse töötab selle algatanud isiku õigustes ja tema lubatud nimekirja piires.
  5. 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.

Selle nupu teave
Selle nupu teave
„Teave selle nupu kohta“ näitab oskust, mida AI-nupp käivitab, kolme allikat, mida see loeb, kes selle kirjutas ja üle vaatas, ning mida viimane versioon muutis. Nupu väljalülitamine eemaldab selle korraga kõikjalt; oskus ja kõik varasemad vastused jäävad alles.

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

Tomá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 see auth: internal ja ühendage sellega requireService (Fastify) või serviceMiddleware (Express). Kaitse lükkab tagasi kõigi teiste jaoks vermitud tõendi (token). Vastake kiiresti ja muutke sama töö teistkordne edastamine kahjutuks.
  • plugin_queue pikema töö jaoks, mille järel inimene ootab ja kus elutsüklit haldab teie tööline. Tööline peab viima käivituse alustades olekusse running ja lõpetades lõppolekusse; tööline, mis ainult postitab oma tulemuse, jätab käivituse igaveseks olekusse queued.
  • llm_only, kui töö teeb ära üks mudeli väljakutse fikseeritud süsteemiviibaga ning teie plugin on core või verified.
  • tool_using, kui mudel peab tööriistu tsüklis välja kutsuma, jällegi ainult tasemel core või verified.
  • 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.

Oskused IDE-s ja Claude Code'is
Oskused IDE-s ja Claude Code'is
„Oskused IDE-s ja Claude Code'is“ näitab samu valideerimis-, üleslaadimis- ja avaldamissamme arendaja enda terminalist, kus mustand on kinnituse ootel, kuna selle autor ei saa omaenda muudatust kinnitada.

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.