Verzió 1.0.0-alpha.1legújabb
2.20. fejezet
Képességek (Skills)
Hogyan írjon meg, teszteljen és tegyen közzé egy Skills Engine képességet (skill), hol jelenik meg az élesítés után, és miben különböznek a beépülő modulok (plugin) manifesztumában szereplő képességek. Tartalmaz egy kidolgozott kikötőhely-kiosztási összefoglalót a Harrow Port Authority számára.
Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

Tomás Reilly, a Harrow Port Authority platformmérnöke a múlt hónapban megkérdezte tőlem, hogy a kikötőhely-tervezői miért kapnak minden alkalommal más választ, amikor megkérdezik az asszisztenst, hogy „ki melyik kikötőhelyen lesz holnap, és mi változott?”. A válasz az volt, hogy senki sem mondta meg az asszisztensnek, hogyan néz ki egy jó válasz. Egy Skills Engine képesség (skill) egy délután alatt megoldotta a problémát: a tervezők mostantól minden alkalommal ugyanazt a háromrészes összefoglalót kapják, legfelül a kikötőhely-táblázattal, alatta a legutóbbi terv óta történt változásokkal, legvégül pedig az ütközésekkel. Ez a fejezet elejétől a végéig bemutatja ezt a képességet, majd kitér a másik fajta képességre, amely egy bővítmény (plugin) manifesztjében él.
Kétféle képesség
A Nexus a „skill” (képesség) szót két különböző dologra használja, és ezek felépítése is eltérő.
| Skills Engine-képesség | Manifesztképesség | |
|---|---|---|
| Mi ez | Egy SKILL.md csomag a képességtárban |
Egy típusos sor a bővítmény skills[] tömbjében |
| Ki írja | Bárki, akinek van hozzá jogosultsága, a szerkesztőfelületen (creator) vagy a saját szövegszerkesztőjében | Egy fejlesztő, egy bővítményen belül |
| Mit tartalmaz | Utasításokat, a meghívható eszközöket, valamint opcionális fájlokat és szkripteket | Bemeneti és kimeneti sémát, egy szintet (tier), valamint az adott szint által igényelt mezőket |
| Hogyan jut el a platformra | Validálva, feltöltve és közzétéve a Skills Engine-ben | A manifesztből lefordítva és szinkronizálva a képességregiszterbe (skill registry) |
| Mi futtatja | Az asszisztens, ügynökök, munkafolyamatok, AI (mesterséges intelligencia) gombok, Claude Code | UNO (a munkafolyamat-motor) üzenetküldés (dispatch) |
| Tipikus használat | „Minden alkalommal ugyanúgy foglald össze a kikötőhely-tervet” | „Futtasd a pályapropagátorunkat ezen az áthaladáson” |
A fejezet további része különválasztja őket. Ha egy bekezdés önmagában a „képesség” (skill) szót használja, az egy Skills Engine képességre vonatkozik.
1. rész: Skills Engine képességek
Mi az a képesség
A képesség egy mappa. A benne lévő SKILL.md mondja meg, mire való a képesség és hogyan kell elvégezni a feladatot; mellette találhatók a feladathoz szükséges fájlok és a futtatandó szkriptek. A motor három rétegben tölti be a képességet: a nevet és a leírást mindig, az utasításokat akkor, amikor egy feladat igényli a képességet, a fájlokat pedig csak akkor, amikor egy lépésnek szüksége van rájuk. Ezért képes egy telepítés kétszáz képességet tárolni úgy, hogy szinte semmilyen terhelést nem jelentenek, amíg valamelyiket nem használják.
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
A könyvtár nevének meg kell egyeznie a képesség egyedi azonosítójával (slug). Az eltérés validálási figyelmeztetést eredményez, amit érdemes kijavítani, mert a tár a slug alapján párosítja a feltöltést egy már meglévő képességgel.
SKILL.md előlap (frontmatter)
Az előlap a fájl tetején található két --- sor közötti YAML-blokk. A formátum három mezőt ír elő kötelezőként. Maga a validálás csak néhány dolognál akad el: ha hiányzik a név vagy a leírás, illetve ha a slug vagy a feladattípus (job type) már foglalt. Minden egyebet figyelmeztetésként jelez.
| Mező | Típus | Kötelező | Mit tartalmaz |
|---|---|---|---|
name |
string | igen | Az egyedi azonosító, kebab-case formátumban |
description |
string | igen | Mit csinál a képesség, legfeljebb 500 karakterben. A tár és a párosító (matcher) ezt olvassa be, ezért olyan olvasónak írja, aki ez alapján dönti el, hogy ez-e a megfelelő képesség |
allowed-tools |
string vagy list | igen | A képesség által meghívható eszközök. Ez csak szűkítheti a futtató fél engedélyezési listáját (allow-list) |
triggers |
list | nem | Perjeles parancsok (slash commands), amelyek közvetlenül meghívják a képességet |
capabilities |
list | nem | Strukturált funkciók (capabilities), mindegyik egy name, egy description, valamint opcionálisan input_schema, output_schema és examples mezővel |
version |
string | nem | Szemantikus verziószám; elhagyása esetén 1.0.0 |
visibility |
string | nem | private, team vagy public |
status |
string | nem | draft, testing vagy published |
Az utasítások hossza maradjon körülbelül 5000 token alatt. Fogalmazzon pontosan, és adjon meg példákat. Minden képesség egyetlen feladatot végezzen el jól; ha azon kapja magát, hogy azt írja: „és emellett”, akkor valószínűleg két külön képességről van szó.
skill.yaml
A skill.yaml hordozza mindazt, amire a motornak a felderítéshez és a tárhoz szüksége van, így a SKILL.md olvasható marad. A motor által beolvasott mezők közé tartozik a name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools és a capabilities. Egy funkció (capability) tartalmazhat query_patterns elemeket, azaz olyan megfogalmazásokat, amelyeket a párosítónak hozzá kell irányítania. Vannak továbbá a motor saját erőforrás-keretének kezelését segítő útmutatások is: complexity, estimated_tokens és required_services.
scripts/
A scripts/ alatt található összes elem változtatás nélkül, komponensként kerül becsomagolásra a képességgel. A szkripteket a rendszer futtatja, soha nem olvassa be őket a modell kontextusába, és mindig egy izolált környezetben (sandbox) futnak. Akkor használjon ilyet, ha egy lépés olyan számtani műveletet vagy elemzést (parsing) igényel, amelyet a modellnek nem „fejben” kellene elvégeznie.
Láthatóság és állapot
A láthatóság határozza meg, hogy ki találhatja meg a képességet: a private csak Ön, a team az Ön csapata, az public pedig mindenki abban a szervezetben, amelyet a tár kiszolgál. A konzolon ugyanez a választási lehetőség „Csak én”, egy csapat (például „Vámcsoport”) vagy a teljes szervezet formájában jelenik meg, emellett a képesség egy szakterületi csomagba (domain pack) is megosztható az adott csomag saját jóváhagyási folyamatán keresztül.
Az állapot azt mutatja meg, hogy a képesség hol tart az életciklusában.
| Állapot | Jelentés |
|---|---|
draft |
Folyamatban lévő munka; nem felderíthető |
testing |
Validálás alatt, korlátozott hozzáféréssel |
published |
Általános használatra elérhető |
deprecated |
Meghaladott; kivezetés alatt áll |
Miután egy verziót közzétettek, az többé nem változik. A konzolon az „éles” (live), a „kanári” (canary) és az „árnyék” (shadow) címkék a verziókhoz tartoznak, és egy korábbi verzióra való visszaváltás csupán áthelyezi a címkét. A folyamatban lévő futások azon a verzión fejeződnek be, amelyiken elindultak.
SKILL.md vázlatot, a mellette lévő fájlokat és azok betöltési idejét, valamint a képesség által meghívható eszközöket. Egy ellenőrző képesség nem kap írásra képes eszközt, és egy képesség mindig csak szűkítheti a futtató engedélyezési listáját.A mappától az éles képességig
A Skills Engine adattárában (repository) található öt npm szkript eljuttatja a képességet az Ön szerkesztőjéből a tárba, és igazolja is a megérkezését.
| Parancs | Mit csinál |
|---|---|
npm run skill:validate skills/<slug> |
Ellenőrzi (linteli) a csomagot. A közzétételhez nulla hibára van szükség |
npm run skill:upload skills/<slug> |
Egy lépésben validál és közzétesz; idempotens |
npm run skill:upload skills/<slug> --dry-run |
Validál és kiírja a tervet anélkül, hogy bármit is írna |
npm run skill:publish -- --dry-run skills/<slug> |
A feltöltés mögött álló alacsonyabb szintű közzététel, ugyanazzal a folyamattal (pipeline) |
npm run skill:reconcile |
Összehasonlítja az adattárában lévő képességeket a tárban és a képességregiszterben tárolt adatokkal |
npm run skill:live:verify |
Elejétől a végéig ellenőrzi a közzétett képességet a futó telepítésen |
A közzététel két bejegyzést ír, és mindkettő számít. Az egyik maga a képesség a SKILL.md törzzsel, a funkciókkal, a komponensekkel és a minőségi rekorddal; a tár, a felderítés és a párosítás ezt olvassa. A másik a regiszterbejegyzés, amely alapján a munkafolyamat-motor feloldja a hívást (dispatch). Egy olyan képesség, amely csak a regiszterig jutott el, lefut ugyan, de a tárban mindaddig láthatatlan marad, amíg fel nem tölti.
A közzététel idempotens. A változatlan képesség nem vált ki műveletet (no-op), a meglévő képességet pedig a rendszer a slug alapján azonosítja, és helyben frissíti, soha nem hozza létre újra. Ha pontosan ugyanazokat a bájtokat tölti fel, mint egy már közzétett verzió esetében, akkor duplikátum helyett ugyanazt a verziót kapja vissza CONTENT_HASH_ALREADY_PUBLISHED válasszal.
A skill:reconcile összeveti az Ön adattárában lévő képességeket a tárral, a regiszterrel és a munkafolyamat-motor készletével, és jelent minden olyan elemet, amely az egyik helyen létezik, a másikon viszont nem. A skill:live:verify még tovább megy a futó telepítésen: ellenőrzi, hogy mindkét bejegyzés létezik-e és ugyanazzal a tartalom-hash-sel egymásra mutat-e, hogy a képesség feladattípusának tesztfuttatási (dry-run) hívását elfogadja-e a rendszer, hogy a képesség megjelenik-e a tár listájában és részletes nézetében, hogy meghívható-e, valamint hogy az auditnapló a slug és a kérésazonosító alapján összekapcsolja-e a közzétételt, a hívást és a futást.
Munkaállomásról történő indításkor a feltöltés porttovábbításon (port-forward) keresztül éri el a telepítés tudásszolgáltatását, a nexus-graphrag-et, és szüksége van a Skills Engine szolgáltatáskulcsára a környezeti változók között. Töltse be a kulcsot anélkül, hogy kiírná a képernyőre:
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-summaryA klaszteren belül, egy pipeline-feladatban az alapértelmezett cím magától feloldódik, és nincs szükség a GRAPHRAG_URL használatára. A kulcsot a szervezet saját titokkezelési folyamatán keresztül szerezze be. A kulcs soha nem kerülhet be az adattárba, a parancssori előzményekbe (shell history) vagy egy parancs kimenetébe.
Tesztelés, jóváhagyás és élesítés
A képesség vázlatként érkezik a tárba, és a szerkesztőfelület mindaddig ott tartja, amíg három feltétel nem teljesül.
| Ellenőrzés | Mit csinál |
|---|---|
| Tesztesetek | Minden tesztesetnek sikeresen le kell futnia, mielőtt a képesség jóváhagyásra küldhető. Egy tesztesetet csak indoklással lehet eltávolítani, amelyet a jóváhagyók is látnak. |
| Tesztfuttatás árnyék (shadow) módban | A képesség korábbi feladatokon fut le úgy, hogy a válaszokat senki sem látja, az eredményeit pedig a rendszer összehasonlítja azzal, ahogyan egy ember döntött az adott időpontban. |
| Vak ellenőrzés egy másik modellcsaládba tartozó modell által | Olyan kihagyott ellenőrzéseket, kitalált forrásokat vagy elrejtett utasításokat keres, amelyeket a képesség követett, pedig nem kellett volna. |
Ezután következik a jóváhagyás. Az olyan képességet, amely írásra képes eszközt ad hozzá, a rendszer visszatartja, amíg két személy a saját passkey-ével jóvá nem hagyja, és a javaslattevő nem lehet egyikük sem (PUBLISH_NEEDS_APPROVAL). Ezután a képesség először árnyék (shadow) módban élesedik, majd kanári (canary) módban egyetlen egység számára, megnevezett kapuk (gates) mögött, végül pedig mindenki számára. Ha egy kanári kapu feltétele nem teljesül, a kanári futás magától leáll, és mindenki az előző verzión marad; a mindenki számára történő korai kiadáshoz indoklásra és egy második jóváhagyóra van szükség (CANARY_GATE_NOT_MET).
A Community kiadásban a szerkesztőfelület, a tár, a verziók és a tesztek mind elérhetők, és a tulajdonos egyedül teszi közzé a képességet, amint a tesztek sikeresen lefutottak. A kanári mód, a kétszemélyes jóváhagyás, a bővítményszinkronizálás és a duplikátumok összevonása az Enterprise kiadás része.
Hol jelennek meg a képességek
Ugyanaz a közzétett képesség öt helyen jut el a felhasználókhoz.
- Az asszisztens a leírás, a triggerek és a lekérdezési minták alapján párosítja a kérést a képességgel, és követi a képesség utasításait.
- Az ügynökök és munkafolyamatok lépésekként hívják meg a képességeket. A munkafolyamat-lépés megnevezi a képességet; a futás pedig rögzíti, hogy melyik verziót használta.
- Az AI-gombok a képernyőkön egyenként egy-egy képességet futtatnak. Az adminisztrátor a „A gombról” (About this button) panel megnyitásával megnézheti, hogy a gomb melyik képességet futtatja, az mit olvas be, és ki módosította utoljára, valamint kikapcsolhatja a gombot anélkül, hogy magához a képességhez hozzányúlna.
- Az Ön IDE-je (integrált fejlesztői környezete) és a Claude Code a Workbench-en és tizenhárom MCP (Model Context Protocol) eszközön keresztül éri el a tárat, amelyek között szerepel a
list_skills,get_skill,match_prompt,discover_skills,invoke_skill,record_execution,create_skill,import_skill,get_generation_jobés async_skills_local. Minden hívás az azt elindító személy nevében és az ő engedélyezési listáján belül fut le. - Maga a képességtár, ahol a felhasználók böngészhetik és futtathatják a képességeket, illetve módosításokat javasolhatnak hozzájuk, az adminisztrátorok pedig láthatják az egyes képességek tulajdonosát, felhasználóit, futásait és költségeit.
Bármi is futtat egy képességet, a képesség nem bővítheti ki a futtató jogosultságait: kizárólag a futtató engedélyezési listáján szereplő eszközöket hívhatja meg, és csak azt olvashatja be, amit az adott személy megnyithat (SKILL_CANNOT_WIDEN_TOOLS). A modellútvonal nélküli futást a rendszer nem próbálja meg kitalálni, hanem elutasítja (SKILLS_ENGINE_BINDING_MISSING); az útvonalat az üzenetküldő (dispatcher) választja ki a szervezet saját modellbeállításai alapján.
Kidolgozott példa: kikötőhely-kiosztási összefoglaló a Harrow számára
A Harrow tervezőinek engedélyezési listáján már szerepelt két, csak olvasható eszköz a Harrow saját kikötőhely-tervező bővítményéből: a berth-plan.read visszaadja egy adott dátum tervét, a vessel-call.read pedig visszaad egy hajóérkezést (vessel call) az érkezési időablakkal és a hajó hosszával együtt. A képességnek semmi másra nincs szüksége. Soha nem végez írási műveletet, így soha nincs szüksége két jóváhagyóra.
---
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.A mellette lévő skill.yaml adja meg a tár számára a megjelenítendő nevet, a kategóriát és azokat a megfogalmazásokat, amelyeket a párosítónak ide kell irányítania:
# 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 *"Ezután következnek a parancsok, az adattár gyökérkönyvtárából kiadva:
npm run skill:validate skills/berth-allocation-summary
npm run skill:upload skills/berth-allocation-summary --dry-run
npm run skill:upload skills/berth-allocation-summaryTomás hat tesztesetet adott hozzá a szerkesztőfelületen: egy átlagos napot, egy olyan napot, ahol egy késői érkezés két másik hajóérkezést elmozdított, egy valódi ütközést tartalmazó napot, egy olyan dátumot, amelyhez még nincs terv, egy olyan hajót, amely túl hosszú a kikötőhelyéhez, valamint egy olyan kérést, amely megpróbálta rávenni a képességet, hogy javasoljon új kikötőhelyet (amit nem tehet meg, mivel nincs írásra képes eszköze). A tesztfuttatás húsz korábbi tervet játszott vissza árnyék módban. Miután a tesztesetek sikeresen lefutottak, a tervezési csoport egyik ellenőre jóváhagyta a képességet, és az élesedett a tervezőcsapat számára. Az asszisztens mostantól minden alkalommal ugyanolyan formában válaszolja meg a kérdést, és a tervezők kikötőhely-terv oldalán található AI-gombja is ugyanezt a képességet futtatja.
2. rész: manifesztum-képességek
A manifesztképesség a bővítmény által közzétett számítási egység. A manifeszt skills[] részében deklarálják, az SDK (szoftverfejlesztő készlet) validálja a create-nexus-plugin validate futtatásakor, a compileRegistry fordítja le a regisztertörzsbe, majd a rendszer szinkronizálja a képességregiszterbe. Soha nem kell kézzel regiszter-SQL-t írnia, így a platform által meghívott sor és az Ön által deklarált leíró nem csúszhat el egymástól.
Minden manifesztképességhez szükséges a id, displayName, description, tier, classification, inputSchema és a outputSchema. Deklarálja a timeoutMs mezőt is: ez egy 1000 és 21 600 000 közötti egész szám (egy másodperctől hat óráig), és a tartományon kívüli értékeket a rendszer TIMEOUT_OUT_OF_BOUNDS hibával elutasítja. A dataResidency értéke any, eu vagy us lehet, az alapértelmezett pedig a any.
A id lower_snake formátumú, a regiszter hívási kulcsa (dispatch key) pedig a névtérrel ellátott <plugin name>.<skill id> feladattípus, így két bővítménynek is lehet summarise nevű képessége anélkül, hogy ütköznének. Íme a sablon egyetlen képessége, rövidítve:
{
"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
}Az öt szint (tier)
A szint nem csupán egy címke. Minden szintnek megvannak a saját mezői, és egy másik szinthez tartozó mezőt a rendszer nem hagy figyelmen kívül csendben, hanem FIELD_NOT_FOR_TIER hibával elutasítja.
| Szint | Követelmények | Modellt ér el | Ki futtatja |
|---|---|---|---|
host_callback |
hostCallback: az Ön Service-e, annak portja, egy elérési út és mindkét bájtkorlát |
Nem | A platform POST kéréssel elküldi a bemenetet az Ön saját Service-ének, az Ön névterén belül |
plugin_queue |
queueName, <plugin name>.<name> formában írva |
Nem | Az Ön worker folyamata, amely a saját várólistájáról (queue) veszi fel a feladatot |
tool_using |
systemPrompt és tools[]; megbízhatósági szint (trust): core vagy verified |
Igen | A platform, az AI Provider Routeren keresztül; minden eszközhívás egy engedélyezési listán szereplő végrehajtón (executor) keresztül fut le |
llm_only |
systemPrompt; megbízhatósági szint (trust): core vagy verified |
Igen | A platform, egyetlen hívással az AI Provider Routeren keresztül |
map |
map.perItemJobType, megnevezve ugyanannak a manifesztnek egy másik olyan képességét, amely nem map típusú |
Csak a célképességen keresztül | A platform elemenként egyszer lefuttatja a célképességet, és összegyűjti az eredményeket |
Egyik modellszint sem nevez meg szolgáltatót vagy modellt. A router mindkettőt a hívást indító szervezet saját készletéből választja ki. Egy tool_using képességben szereplő eszköz hat végrehajtó (executor) egyikét nevezi meg: standing_service_call (az Ön saját Service-e), graphrag, graphrag_query, graphrag_search, h3 vagy web_search. Bármely más értéket a rendszer EXECUTOR_NOT_PERMITTED hibával elutasít. A három tudásgráf-végrehajtó csak a graphrag_query és graphrag_search eszközneveket fogadja el, mivel a végrehajtó azt a műveletet futtatja, amelyről az eszközt elnevezték.
A regiszterben létezik két olyan szint, amelyet bővítmény nem deklarálhat: a láncokat (chains) és az önállóan futó képességeket kizárólag a platform írhatja. Az olyan szinkronizálást, amely ilyet nevez meg, a rendszer teljes egészében elutasítja.
Melyik szintet érdemes használni
host_callback, ha a feladat a bemenet olyan függvénye, amelyet az Ön saját kódja számít ki: pontszámítás, kalkuláció vagy keresés a saját sémájában. Ezt a legegyszerűbb tesztelni, és a sablonban is ez az alapértelmezett. Védje a visszahívási útvonalat (callback route): a manifesztben szereplő elérési út nem titok, ezért az útvonalnak ellenőriznie kell a platform hívását, és abból kell kiolvasnia a szervezetet, soha nem a kéréstörzsből (body). Deklaráljaauth: internalértékkel, és csatolja hozzá arequireService(Fastify) vagy aserviceMiddleware(Express) köztes szoftvert. A védelem elutasítja a más számára kibocsátott tokeneket. Válaszoljon gyorsan, és gondoskodjon arról, hogy ugyanannak a feladatnak a másodszori kézbesítése ne okozzon kárt.plugin_queueolyan hosszabb munkákhoz, amelyekre egy felhasználó várakozik, és ahol az életciklust az Ön worker folyamata kezeli. A workernek az induláskorrunningállapotba, a befejezéskor pedig valamelyik végállapotba kell léptetnie a futást; az a worker, amely csak beküldi az eredményt, örökrequeuedállapotban hagyja a futást.llm_only, ha egyetlen, rögzített rendszerprompttal végzett modellhívás elvégzi a feladatot, és a bővítményecorevagyverifiedszintű.tool_using, ha a modellnek ciklusban kell eszközöket meghívnia, szintén csakcorevagyverifiedszint esetén.map, ha azt szeretné, hogy a platform egy másik képességét párhuzamosan kiterjessze (fan out) egy lista elemeire.
A Corrán Orbitalnál használt pályapropagációs képességem egy host_callback. A bővítményünk community besorolású, így a modellszintek szóba sem jöhettek, és nem is hiányoznak: egy olyan propagátor, amely kedden más választ adna, a használhatatlannál is rosszabb lenne.
Jóváhagyás minden futtatás előtt
Az olyan manifesztképesség, amely soha nem futhat le pusztán egy gép utasítására, ezt külön deklarálja:
"approval": { "required": true, "reason": "Re-planning a pass needs the flight dynamics lead." }A required értéke mindig true; az a képesség, amely nem igényel jóváhagyást, elhagyja ezt a blokkot. A reason az a szöveg, amelyet a jóváhagyó lát – a szóközök levágása után 1 és 500 karakter közötti hosszúságú lehet –, és bármilyen más formátumot a rendszer APPROVAL_INVALID hibával elutasít. A képesség meghívását ezután a rendszer visszatartja: a hívás 202 kóddal, status: "awaiting_approval" állapottal és egy waitpointId értékkel válaszol, és csak egy megnevezett személy jóváhagyása engedélyezi a futást, egyetlen alkalommal. Egy visszatartott képesség kötegelt (batch), map vagy lánc (chain) típusú meghívását a rendszer SKILL_APPROVAL_NOT_HOLDABLE hibával elutasítja, mivel a párhuzamos kiterjesztés (fan-out) nem tudja visszatartani az egyes elemeit. Jelenítse meg a visszatartott választ, és hagyja, hogy a jóváhagyó döntsön; ne hívja meg a képességet úgy, hogy csak utána kér hozzájárulást.
Szinkronizálás a regiszterbe
Minden szinkronizálás deklaratív, és a rendszer egyben ellenőrzi az egészet. Minden alkalommal küldje el a teljes képességkészletet: a kihagyott képességeket a rendszer letiltja, de a futási előzményeik megmaradnak. Egyetlen hibás képesség miatt a rendszer a teljes szinkronizálást elutasítja SYNC_CONTRACT_VIOLATION hibával, együtt felsorolva az összes szabálysértést, és semmit sem ír be, így a bővítmény soha nem frissülhet csak félig. A 2.22. fejezet (A bővítmény-futtatókörnyezet) ismerteti a szinkronizálási hívást, valamint azt, hogy a platform honnan tudja, melyik bővítmény indítja a hívást.
Választás a két típus között
Ha a feladat az, hogy „mondd ezt minden alkalommal ugyanúgy”, akkor az egy Skills Engine képesség. Ha a feladat az, hogy „futtasd le a kódomat, és add vissza a válaszát”, akkor az egy manifesztképesség. A legtöbb valós feladat végül mindkettőt magában foglalja: a Harrow kikötőhely-összefoglalója egy olyan Skills Engine képesség, amelynek eszközei egy bővítményből származnak, maguk a bővítmény eszközei pedig a bővítmény manifesztjében vannak deklarálva. A kettő közül a Skills Engine képességet olcsóbb módosítani, ami jó ok arra, hogy a megfogalmazást és a mérlegelést ott tartsuk, a számtani műveleteket pedig a bővítményben.
A ráfordítás így is, úgy is valós. Egy Skills Engine képesség nincs kész attól, hogy a SKILL.md jól olvasható; akkor van kész, amikor a tesztesetei sikeresen lefutnak, a tesztfuttatása megegyezik azzal, ahogyan az emberek döntöttek, és valaki más – aki nem Ön – jóváhagyta. Egy írási műveletet végző képességre szánjon egy hetet, amelynek nagy részét a kanári futás teszi ki.



