HyniRezervoni një prezantim

Kapitulli 2.20

Aftësitë

Si të shkruani, testoni dhe publikoni një aftësi të Skills Engine, ku shfaqet pasi të jetë aktive dhe si ndryshojnë aftësitë e manifestit në një shtojcë. Përfshin një përmbledhje të përpunuar të caktimit të vendeve të ankorimit për Harrow Port Authority.

Kjo faqe u përkthye nga AI prej origjinalit në anglisht. Nëse diçka është e paqartë, faqja në anglisht shërben si referencë. Lexoni këtë faqe në anglisht

17 minuta lexim

Tomás Reilly, inxhinieri i platformës në Harrow Port Authority, më pyeti muajin e kaluar pse planifikuesit e tij të vendeve të ankorimit merrnin një përgjigje të ndryshme sa herë që e pyesnin asistentin "kush është në cilin vend ankorimi nesër, dhe çfarë ka lëvizur?". Përgjigjja ishte se askush nuk i kishte treguar asistentit se si duket një përgjigje e mirë. Një aftësi e Skills Engine e zgjidhi këtë brenda një pasditeje: planifikuesit tani marrin të njëjtën përmbledhje me tri pjesë çdo herë, me tabelën e vendeve të ankorimit në fillim, ndryshimet që nga plani i fundit poshtë saj, dhe përplasjet në fund. Ky kapitull e ndjek atë aftësi nga fillimi në fund, dhe më pas trajton llojin tjetër të aftësisë, atë që gjendet në manifestin e një shtojce.

Dy lloje aftësish

Nexus përdor fjalën "aftësi" (skill) për dy gjëra të ndryshme, dhe ato ndërtohen ndryshe.

Aftësi e Skills Engine Aftësi e manifestit
Çfarë është Një paketë SKILL.md në bibliotekën e aftësive Një rresht i tipizuar në vargun skills[] të një shtojce
Kush e shkruan Kushdo që ka të drejtën, në krijues ose në redaktorin e vet Një zhvillues, brenda një shtojce
Çfarë përmban Udhëzime, mjetet që mund të thërrasë, skedarë dhe skripte opsionale Një skemë hyrëse dhe dalëse, një nivel (tier), dhe fushat që kërkon ai nivel
Si mbërrin në platformë E vlefshmëruar, e ngarkuar dhe e publikuar në Skills Engine E kompiluar nga manifesti dhe e sinkronizuar me regjistrin e aftësive
Çfarë e ekzekuton Asistenti, agjentët, rrjedhat e punës, butonat e AI (inteligjencës artificiale), Claude Code Dërgimi nga UNO (motori i rrjedhës së punës)
Përdorimi tipik "Përmblidh planin e vendeve të ankorimit në të njëjtën mënyrë çdo herë" "Ekzekuto përhapësin tonë të orbitës në këtë kalim"

Pjesa tjetër e kapitullit i mban ato të ndara. Nëse një paragraf thotë vetëm "aftësi", bëhet fjalë për një aftësi të Skills Engine.

Pjesa 1: aftësitë e Skills Engine

Çfarë është një aftësi

Një aftësi është një dosje. SKILL.md e saj tregon se për çfarë shërben aftësia dhe si ta kryejë punën; krahas saj qëndrojnë çdo skedar që i nevojitet punës dhe çdo skript që ajo ekzekuton. Motori e ngarkon një aftësi në tri shtresa: emrin dhe përshkrimin gjithmonë, udhëzimet kur një detyrë e kërkon aftësinë, dhe skedarët vetëm kur një hap ka nevojë për to. Kjo është arsyeja pse një instalim mund të mbajë dyqind aftësi dhe të mos paguajë pothuajse asgjë për to derisa të përdoret njëra.

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

Emri i direktorisë duhet të jetë i barabartë me identifikuesin (slug) të aftësisë. Një mospërputhje është një paralajmërim vlefshmërimi dhe ia vlen të rregullohet, sepse përmes këtij identifikuesi biblioteka përputh një ngarkim me një aftësi ekzistuese.

Të dhënat ballore të SKILL.md

Të dhënat ballore (frontmatter) janë në formatin YAML midis dy rreshtave --- në krye të skedarit. Formati kërkon tri fusha. Vetë vlefshmërimi bllokon vetëm për disa gjëra: një emër ose përshkrim që mungon, dhe një identifikues (slug) ose lloj pune që është zënë tashmë. Çdo gjë tjetër e raporton si paralajmërim.

Fusha Lloji E detyrueshme Çfarë mban
name varg (string) po Identifikuesi unik, në formatin kebab-case
description varg (string) po Çfarë bën aftësia, më së shumti 500 karaktere. Biblioteka dhe përputhësi e lexojnë atë, prandaj shkruajeni për një lexues që po vendos nëse kjo është aftësia e duhur
allowed-tools varg ose listë po Mjetet që aftësia mund të thërrasë. Ajo mund vetëm të ngushtojë listën e lejuar të kujtdo që e ekzekuton atë
triggers listë jo Komandat me vijë të pjerrët (slash commands) që thërrasin aftësinë drejtpërdrejt
capabilities listë jo Kapacitete të strukturuara, secila me një name, një description dhe opsionalisht input_schema, output_schema dhe examples
version varg (string) jo Një version semantik; 1.0.0 kur lihet jashtë
visibility varg (string) jo private, team ose public
status varg (string) jo draft, testing ose published

Mbajini udhëzimet nën rreth 5,000 tokenë. Jini specifikë dhe jepni shembuj. Çdo aftësi duhet të bëjë një punë mirë; nëse e gjeni veten duke shkruar "dhe gjithashtu", me siguri keni dy aftësi.

skill.yaml

skill.yaml mbart atë që i nevojitet motorit për zbulimin dhe bibliotekën, në mënyrë që SKILL.md të mbetet i lexueshëm. Fushat që lexon motori përfshijnë name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools dhe capabilities. Një kapacitet mund të mbartë query_patterns, formulimet që përputhësi duhet t'i dërgojë atij. Ka gjithashtu sinjale ndihmëse për vetë buxhetimin e motorit: complexity, estimated_tokens dhe required_services.

scripts/

Çdo gjë nën scripts/ paketohet fjalë për fjalë me aftësinë si një komponent. Një skript ekzekutohet, nuk lexohet kurrë në kontekstin e modelit, dhe ekzekutohet në një mjedis të izoluar (sandbox). Përdorni një të tillë kur një hap është aritmetikë ose analizim sintaksor (parsing) që një model nuk duhet ta bëjë me mend.

Dukshmëria dhe statusi

Dukshmëria tregon se kush mund ta gjejë aftësinë: private jeni ju, team është ekipi juaj, dhe public është çdokush në organizatën të cilës i shërben biblioteka. Në konsolë e njëjta zgjedhje lexohet "Vetëm unë", një ekip si "Zyra e doganës", ose e gjithë organizata, dhe një aftësi mund të ndahet gjithashtu në një paketë domeni përmes rishikimit të vetë asaj pakete.

Statusi tregon se ku ndodhet aftësia në ciklin e saj të jetës.

Statusi Kuptimi
draft Punë në vazhdim; e pazbulueshme
testing Po vlefshmërohet, me qasje të kufizuar
published E disponueshme për përdorim të përgjithshëm
deprecated E zëvendësuar; drejt heqjes nga përdorimi

Pasi një version publikohet, ai nuk ndryshon kurrë. Në konsolë, "live", "canary" dhe "shadow" janë etiketa mbi versione, dhe kthimi pas në një version më të hershëm lëviz një etiketë. Ekzekutimet në proces përfundojnë me versionin me të cilin kanë filluar.

Aftësi e re · 2 Udhëzimet dhe mjetet
Aftësi e re · 2 Udhëzimet dhe mjetet
Hapi i dytë i krijuesit shfaq draftin SKILL.md, skedarët krahas tij dhe kur ngarkohet secili, si dhe mjetet që aftësia mund të thërrasë. Një aftësie kontrolluese nuk i ofrohet asnjë mjet që shkruan, dhe një aftësi mund vetëm të ngushtojë listën e lejuar të ekzekutuesit.

Nga një dosje në një aftësi aktive (live)

Pesë skripte npm në depon (repository) e Skills Engine e marrin një aftësi nga redaktori juaj në bibliotekë dhe vërtetojnë se ajo ka mbërritur.

Komanda Çfarë bën
npm run skill:validate skills/<slug> Kontrollon kodin e paketës (linting). Publikimi kërkon zero gabime
npm run skill:upload skills/<slug> Vlefshmëron dhe publikon në një hap të vetëm; idempotent
npm run skill:upload skills/<slug> --dry-run Vlefshmëron dhe printon planin pa shkruar asgjë
npm run skill:publish -- --dry-run skills/<slug> Publikimi i nivelit më të ulët pas ngarkimit, i njëjti proces (pipeline)
npm run skill:reconcile Krahason aftësitë në depon tuaj me atë që mbajnë biblioteka dhe regjistri i aftësive
npm run skill:live:verify Kontrollon një aftësi të publikuar nga fillimi në fund në instalimin në ekzekutim

Publikimi shkruan dy hyrje, dhe të dyja kanë rëndësi. Njëra është vetë aftësia, me trupin e saj SKILL.md, kapacitetet, komponentët dhe regjistrin e cilësisë; biblioteka, zbulimi dhe përputhja e lexojnë atë. Tjetra është hyrja e regjistrit kundrejt së cilës motori i rrjedhës së punës zgjidh një dërgim. Një aftësi që ka mbërritur vetëm në regjistër ekzekutohet, por është e padukshme në bibliotekë derisa ta ngarkoni atë.

Publikimi është idempotent. Një aftësi e pandryshuar nuk kryen asnjë veprim (no-op), dhe një aftësi ekzistuese përputhet me anë të identifikuesit të saj (slug) dhe përditësohet në vend, nuk rikrijohet kurrë. Ngarkoni të njëjtët bajtë si një version që është publikuar tashmë dhe do të merrni mbrapsht atë version me CONTENT_HASH_ALREADY_PUBLISHED, jo një dublikatë.

skill:reconcile kontrollon aftësitë e depos suaj kundrejt bibliotekës, regjistrit dhe inventarit të motorit të rrjedhës së punës, dhe raporton çdo gjë që ekziston në një vend dhe jo në një tjetër. skill:live:verify shkon më tej në instalimin në ekzekutim: të dyja hyrjet ekzistojnë dhe tregojnë drejt njëra-tjetrës me të njëjtin hash përmbajtjeje, një dërgim prove (dry-run) i llojit të punës së aftësisë pranohet, aftësia shfaqet në listën dhe detajet e bibliotekës, ajo mund të thirret, dhe gjurma e auditimit lidh publikimin, dërgimin dhe ekzekutimin së bashku sipas identifikuesit (slug) dhe ID-së së kërkesës.

Nga një stacion pune, ngarkimi mbërrin në shërbimin e njohurive të instalimit, nexus-graphrag, përmes një përcjelljeje porte (port-forward), dhe ka nevojë për çelësin e shërbimit të Skills Engine në mjedis. Ngarkoni çelësin pa e shfaqur atë:

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

Brenda klasterit, në një punë të procesit (pipeline job), adresa e parazgjedhur zgjidhet vetë dhe GRAPHRAG_URL nuk nevojitet. Merrni çelësin përmes procesit të fshehtësisë së vetë organizatës suaj. Ai nuk shkon kurrë në depo, në historikun tuaj të shell-it ose në rezultatin e një komande.

Testet, miratimi dhe kalimi në prodhim (live)

Një aftësi mbërrin në bibliotekë si draft, dhe krijuesi e mban aty derisa të kalojnë tri gjëra.

Kontrolli Çfarë bën
Rastet e testimit Çdo rast duhet të kalojë përpara se aftësia të mund të shkojë për miratim. Një rast mund të hiqet vetëm me një arsye, të cilën miratuesit e shohin.
Një ekzekutim prove në hije (shadow) Aftësia ekzekutohet mbi punët e kaluara, ku askush nuk i sheh përgjigjet, dhe rezultatet e saj krahasohen me atë që ka vendosur një person në atë kohë.
Një rishikim i verbër nga një model i një familjeje tjetër Ai kërkon për një kontroll të humbur, një burim të sajuar dhe një udhëzim të fshehur që aftësia e ka ndjekur kur nuk duhej.

Më pas miratimi. Një aftësi që shton një mjet i cili shkruan mbahet pezull derisa dy persona ta miratojnë atë me çelësat e tyre të kalimit (passkeys), dhe personi që e ka propozuar nuk mund të jetë njëri prej tyre (PUBLISH_NEEDS_APPROVAL). Më pas ajo kalon aktive në hije (shadow), pastaj në fazën eksperimentale (canary) për një njësi pas portave të emërtuara, dhe pastaj për të gjithë. Nëse një portë canary nuk plotësohet, canary ndalon vetë dhe të gjithë qëndrojnë në versionin e mëparshëm; dërgimi i saj tek të gjithë më herët kërkon një arsye dhe një miratues të dytë (CANARY_GATE_NOT_MET).

Në versionin Community krijuesi, biblioteka, versionet dhe testet janë të gjitha aty, dhe pronari publikon i vetëm pasi kalojnë testet. Canary, miratimi nga dy persona, sinkronizimi i shtojcave dhe bashkimi i dublikatave vijnë me versionin Enterprise.

Aftësi e re · 4 Publiko
Aftësi e re · 4 Publiko
Publikimi tregon pse një aftësi mbahet pezull, kush duhet të bjerë dakord dhe si kalon ajo aktive: e miratuar, në hije (shadow), në canary pas portave të emërtuara, pastaj për të gjithë. Propozuesi nuk mund të miratojë ndryshimin e vet, dhe versioni i fundit qëndron gati për t'u rikthyer.

Ku shfaqen aftësitë

E njëjta aftësi e publikuar mbërrin te njerëzit në pesë vende.

  1. Asistenti përputh një kërkesë me një aftësi sipas përshkrimit, nxitësve (triggers) dhe modeleve të pyetjeve të saj, dhe ndjek udhëzimet e aftësisë.
  2. Agjentët dhe rrjedhat e punës thërrasin aftësitë si hapa. Një hap i rrjedhës së punës emërton aftësinë; ekzekutimi regjistron se cilin version ka përdorur.
  3. Butonat e AI në ekrane ekzekutojnë secili nga një aftësi. Një administrator mund të hapë "Rreth këtij butoni" për të parë aftësinë që ekzekuton një buton, çfarë lexon ai dhe kush e ka ndryshuar i fundit, dhe mund ta çaktivizojë butonin pa prekur aftësinë.
  4. IDE-ja juaj (mjedisi i integruar i zhvillimit) dhe Claude Code mbërrijnë në bibliotekë përmes Workbench dhe trembëdhjetë mjeteve MCP (Model Context Protocol): list_skills, get_skill, match_prompt, discover_skills, invoke_skill, record_execution, create_skill, import_skill, get_generation_job dhe sync_skills_local ndër to. Çdo thirrje ekzekutohet si personi që e ka nisur atë, brenda listës së tij të lejuar.
  5. Vetë biblioteka e aftësive, ku njerëzit shfletojnë, ekzekutojnë dhe sugjerojnë ndryshime në aftësi, dhe administratorët shohin pronarin, përdoruesit, ekzekutimet dhe shpenzimet e çdo aftësie.

Çfarëdo që e ekzekuton një aftësi, aftësia nuk mund të zgjerojë atë që mund të bëjë ekzekutuesi: ajo thërret vetëm mjete brenda listës së lejuar të ekzekutuesit dhe lexon vetëm atë që ai person mund të hapë (SKILL_CANNOT_WIDEN_TOOLS). Një ekzekutim pa një rrugë modeli refuzohet në vend që të hamendësohet (SKILLS_ENGINE_BINDING_MISSING); dispeçeri zgjedh rrugën, nga konfigurimi i modeleve të vetë organizatës.

Rreth këtij butoni
Rreth këtij butoni
Rreth këtij butoni tregon aftësinë që ekzekuton një buton AI, tri burimet që ai lexon, kush e ka shkruar dhe rishikuar atë, dhe çfarë ka ndryshuar versioni i fundit. Çaktivizimi i butonit e heq atë kudo menjëherë; aftësia dhe çdo përgjigje e kaluar mbeten.

Shembull praktik: një përmbledhje e caktimit të vendeve të ankorimit për Harrow

Planifikuesit e Harrow kishin tashmë dy mjete vetëm për lexim në listën e tyre të lejuar nga vetë shtojca e planifikimit të vendeve të ankorimit të Harrow: berth-plan.read kthen planin për një datë, dhe vessel-call.read kthen një ndalesë anijeje me dritaren e saj të mbërritjes dhe gjatësinë. Aftësia nuk ka nevojë për asgjë tjetër. Ajo nuk shkruan kurrë, kështu që nuk ka kurrë nevojë për dy miratues.

---
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 krahas tij i jep bibliotekës një emër shfaqjeje, një kategori dhe formulimet që përputhësi duhet t'i drejtojë këtu:

# 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 *"

Më pas komandat, nga rrënja e depos:

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 shtoi gjashtë raste testimi në krijues: një ditë të zakonshme, një ditë me një mbërritje të vonuar që lëvizi dy ndalesa, një ditë me një përplasje të vërtetë, një datë ende pa plan, një anije shumë të gjatë për vendin e saj të ankorimit, dhe një kërkesë që u përpoq ta shtynte aftësinë të propozonte një vend të ri ankorimi (nuk duhet ta bëjë; nuk ka mjet që shkruan). Ekzekutimi i provës riluajti njëzet plane të kaluara në hije (shadow). Pasi rastet kaluan, një rishikues në zyrën e planifikimit e miratoi atë, dhe ajo kaloi aktive për ekipin e planifikimit. Asistenti tani i përgjigjet pyetjes në të njëjtën formë çdo herë, dhe butoni AI i planifikuesve në faqen e planit të vendeve të ankorimit ekzekuton të njëjtën aftësi.

Pjesa 2: aftësitë e manifestit

Një aftësi e manifestit është njësia e llogaritjes që publikon një shtojcë. Ajo deklarohet në skills[] të manifestit, vlefshmërohet nga SDK-ja (paketa e zhvillimit të softuerit) kur ekzekutoni create-nexus-plugin validate, kompilohet në trupin e regjistrit nga compileRegistry, dhe sinkronizohet me regjistrin e aftësive. Ju nuk shkruani kurrë SQL regjistri me dorë, kështu që rreshti që dërgon platforma dhe përshkruesi që keni deklaruar nuk mund të largohen nga njëri-tjetri.

Çdo aftësi e manifestit ka nevojë për id, displayName, description, tier, classification, inputSchema dhe outputSchema. Deklaroni edhe timeoutMs: është një numër i plotë nga 1,000 deri në 21,600,000 (një sekondë deri në gjashtë orë), dhe një vlerë jashtë këtij diapazoni refuzohet me TIMEOUT_OUT_OF_BOUNDS. dataResidency është any, eu ose us, dhe any është vlera e parazgjedhur.

id është në formatin lower_snake, dhe çelësi i dërgimit të regjistrit është lloji i punës me hapësirë emri (namespaced) <plugin name>.<skill id>, kështu që dy shtojca mund të kenë të dyja një aftësi summarise pa u përplasur. Ja ku është aftësia e vetme e shabllonit, e shkurtuar:

{
  "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
}

Pesë nivelet (tiers)

Niveli nuk është një etiketë. Çdo nivel ka fusha të vetat, dhe një fushë që i përket një niveli tjetër refuzohet me FIELD_NOT_FOR_TIER në vend që të hiqet në heshtje.

Niveli Kërkon Mbërrin te një model Kush e ekzekuton
host_callback hostCallback: Service juaj, porta e tij, një shteg dhe të dy kufijtë e bajtëve Jo Platforma dërgon me POST të dhënat hyrëse në Service tuaj, brenda hapësirës suaj të emrit (namespace)
plugin_queue queueName, e shkruar <plugin name>.<name> Jo Punëtori (worker) juaj, duke tërhequr nga radha (queue) juaj
tool_using systemPrompt dhe tools[]; besueshmëria core ose verified Po Platforma, përmes AI Provider Router; çdo thirrje mjeti ekzekutohet përmes një ekzekutuesi në listën e lejuar
llm_only systemPrompt; besueshmëria core ose verified Po Platforma, një thirrje përmes AI Provider Router
map map.perItemJobType, duke emërtuar një aftësi tjetër të të njëjtit manifest që nuk është një hartë (map) Vetëm përmes objektivit të saj Platforma ekzekuton objektivin një herë për çdo artikull dhe mbledh rezultatet

Asnjëri nivel modeli nuk emërton një ofrues ose një model. Ruteri i zgjedh të dyja nga grupi i vetë organizatës dërguese. Një mjet në një aftësi tool_using emërton një nga gjashtë ekzekutuesit: standing_service_call (Service juaj), graphrag, graphrag_query, graphrag_search, h3 ose web_search. Çdo tjetër refuzohet me EXECUTOR_NOT_PERMITTED. Tre ekzekutuesit e grafit të njohurive pranojnë vetëm emrat e mjeteve graphrag_query dhe graphrag_search, sepse ekzekutuesi kryen çfarëdo veprimi sipas të cilit është emërtuar mjeti.

Në regjistër ekzistojnë dy nivele që një shtojcë nuk mund t'i deklarojë: zinxhirët (chains) dhe aftësitë që ekzekutohen vetë shkruhen vetëm nga platforma. Një sinkronizim që emërton një të tillë refuzohet i tëri.

Cilin nivel të përdorni

  • host_callback kur puna është një funksion i të dhënave hyrëse që kodi juaj e llogarit: një rezultat, një përllogaritje, një kërkim në skemën tuaj. Është më i thjeshti për t'u testuar dhe vlera e parazgjedhur e shabllonit. Mbroni rrugën e kthimit të thirrjes (callback): një shteg në një manifest nuk është sekret, dhe rruga duhet të verifikojë thirrjen e platformës dhe të marrë organizatën prej saj, kurrë nga trupi i kërkesës. Deklarojeni atë auth: internal dhe montoni requireService (Fastify) ose serviceMiddleware (Express) mbi të. Mbrojtësi refuzon një token të prerë për këdo tjetër. Përgjigjuni shpejt, dhe bëjeni të padëmshëm një dorëzim të dytë të së njëjtës punë.
  • plugin_queue për punë më të gjata që një person i pret, ku punëtori (worker) juaj zotëron ciklin e jetës. Punëtori duhet ta kalojë ekzekutimin në running kur fillon dhe në një status përfundimtar kur mbaron; një punëtor që vetëm poston rezultatin e tij e lë ekzekutimin duke shfaqur queued përgjithmonë.
  • llm_only kur një thirrje e vetme modeli me një kërkesë sistemi (system prompt) fikse e kryen punën, dhe shtojca juaj është core ose verified.
  • tool_using kur modeli ka nevojë të thërrasë mjete në një cikël (loop), përsëri vetëm në core ose verified.
  • map kur dëshironi që platforma të shpërndajë njërën nga aftësitë tuaja të tjera mbi një listë.

Aftësia ime e përhapjes së orbitës në Corrán Orbital është një host_callback. Shtojca jonë është community, kështu që nivelet e modelit nuk ishin kurrë një opsion, dhe nuk më mungojnë: një përhapës që do të jepte një përgjigje tjetër të martën do të ishte më keq se i padobishëm.

Miratimi përpara çdo ekzekutimi

Një aftësi e manifestit që nuk duhet të ekzekutohet kurrë vetëm me urdhrin e një makine e deklaron këtë:

"approval": { "required": true, "reason": "Re-planning a pass needs the flight dynamics lead." }

required është gjithmonë true; një aftësi që nuk ka nevojë për miratim e lë jashtë bllokun. reason është ajo që sheh miratuesi, 1 deri në 500 karaktere pas shkurtimit të hapësirave, dhe çdo formë tjetër refuzohet me APPROVAL_INVALID. Një dërgim i aftësisë mbahet atëherë pezull: dërgimi përgjigjet 202 me status: "awaiting_approval" dhe një waitpointId, dhe vetëm miratimi i një personi të emërtuar e çliron atë, një herë. Një dërgim në grup (batch), hartë (map) ose zinxhir (chain) i një aftësie të mbajtur pezull refuzohet me SKILL_APPROVAL_NOT_HOLDABLE, sepse një shpërndarje nuk mund t'i mbajë pezull artikujt e saj. Shfaqni përgjigjen e mbajtur pezull dhe lëreni miratuesin të vendosë; mos e dërgoni për të kërkuar më pas pëlqimin.

Sinkronizimi me regjistrin

Çdo sinkronizim është deklarativ dhe kontrollohet i tëri. Dërgoni grupin e plotë të aftësive çdo herë: një aftësi që e lini jashtë çaktivizohet, dhe historiku i saj i ekzekutimit mbetet. Një aftësi e vetme e gabuar refuzon të gjithë sinkronizimin me SYNC_CONTRACT_VIOLATION, me çdo shkelje të renditur së bashku dhe asgjë të shkruar, kështu që një shtojcë nuk përditësohet kurrë përgjysmë. Kapitulli 2.22, Mjedisi i ekzekutimit të shtojcave, mbulon thirrjen e sinkronizimit dhe mënyrën se si platforma e di se cila shtojcë po thërret.

Aftësitë në IDE dhe Claude Code
Aftësitë në IDE dhe Claude Code
Aftësitë në IDE dhe Claude Code shfaq të njëjtat hapa vlefshmërimi, ngarkimi dhe publikimi nga terminali i vetë zhvilluesit, me draftin të mbajtur pezull për miratim sepse autorja e tij nuk mund të miratojë ndryshimin e vet.

Zgjedhja midis dy llojeve

Nëse puna është "thuaje këtë në të njëjtën mënyrë çdo herë", është një aftësi e Skills Engine. Nëse puna është "ekzekuto kodin tim dhe më jep përgjigjen e tij", është një aftësi e manifestit. Shumica e punëve reale përfundojnë si të dyja: përmbledhja e vendeve të ankorimit të Harrow është një aftësi e Skills Engine mjetet e së cilës vijnë nga një shtojcë, dhe mjetet e shtojcës deklarohen vetë në manifestin e saj. Aftësia e Skills Engine është më e lira nga të dyja për t'u ndryshuar, gjë që është një arsye e mirë për të mbajtur formulimin dhe gjykimin aty, ndërsa aritmetikën në shtojcë.

Kostoja është reale në të dyja rastet. Një aftësi e Skills Engine nuk ka përfunduar kur SKILL.md lexohet bukur; ajo ka përfunduar kur rastet e saj kalojnë, ekzekutimi i saj i provës përputhet me atë që kanë vendosur njerëzit, dhe dikush që nuk jeni ju e ka miratuar atë. Planifikoni një javë për një aftësi që shkruan, ku pjesa më e madhe e saj është faza canary.