InnskráningBóka kynningu

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

17 mínútna lestur

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

Ný færni · 2 Fyrirmæli og verkfæri
Ný færni · 2 Fyrirmæli og verkfæri
Annað skref smiðsins sýnir drögin að 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-summary

Inni í 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.

Ný færni · 4 Gefa út
Ný færni · 4 Gefa út
Útgáfuferlið sýnir hvers vegna færni er haldið aftur af, hverjir verða að samþykkja og hvernig hún fer í loftið: samþykkt, í skuggaham, í tilraunaham á bak við nefnd hlið, og síðan fyrir alla. Sá sem leggur til breytinguna getur ekki samþykkt hana sjálfur, og síðasta útgáfa er áfram tilbúin ef skipta þarf aftur til baka.

Hvar færnieiningar birtast

Sama útgefna færnin nær til fólks á fimm stöðum.

  1. Aðstoðarforritið parar beiðni við færni eftir lýsingu hennar, kveikjum og fyrirspurnarmynstrum, og fylgir fyrirmælum færninnar.
  2. Erindrekar og verkferlar kalla á færnieiningar sem skref. Skref í verkferli nefnir færnina; keyrslan skráir hvaða útgáfu hún notaði.
  3. 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.
  4. Þ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_job og sync_skills_local eru þar á meðal. Hvert kall keyrir í nafni þess sem ræsti það, innan leyfislista viðkomandi.
  5. 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.

Um þennan hnapp
Um þennan hnapp
Um þennan hnapp sýnir hvaða færni gervigreindarhnappur keyrir, þrjár heimildir sem hún les, hver skrifaði hana og fór yfir hana, og hverju nýjasta útgáfan breytti. Að slökkva á hnappnum fjarlægir hann alls staðar í einu; færnin og öll fyrri svör halda sér.

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

Tomá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 sem auth: internal og tengdu requireService (Fastify) eða serviceMiddleware (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_queue fyrir 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öðunni queued að 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 er core eða verified.
  • tool_using þegar líkanið þarf að kalla á verkfæri í lykkju, aftur aðeins á trauststigi core eða verified.
  • 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.

Færni í þróunarumhverfinu (IDE) og Claude Code
Færni í þróunarumhverfinu og Claude Code
Færni í þróunarumhverfinu (IDE) og Claude Code sýnir sömu sannprófunar-, upphleðslu- og útgáfuskref úr eigin skipanalínu forritara, þar sem drögunum er haldið í bið eftir samþykki vegna þess að höfundurinn getur ekki samþykkt eigin breytingu.

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