PrisijungtiUžsisakyti pristatymą

2.20 skyrius

Įgūdžiai

Kaip parašyti, išbandyti ir paskelbti Skills Engine įgūdį, kur jis rodomas tapęs aktyvus ir kuo skiriasi manifesto įgūdžiai įskiepyje. Apima išsamų krantinių paskirstymo suvestinės pavyzdį, skirtą Harrow Port Authority.

Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

17 min. skaitymo

Tomás Reilly, Harrow Port Authority platformos inžinierius, praėjusį mėnesį manęs paklausė, kodėl jo krantinių planuotojai kiekvieną kartą gauna skirtingą atsakymą, kai paklausia asistento „kas rytoj prie kurios krantinės ir kas pasikeitė?“. Atsakymas buvo toks: niekas asistentui nebuvo nurodęs, kaip atrodo geras atsakymas. Skills Engine įgūdis tai sutvarkė per vieną popietę: dabar planuotojai kiekvieną kartą gauna tą pačią trijų dalių santrauką, kurioje pirmiausia pateikiama krantinių lentelė, po ja – pakeitimai nuo paskutinio plano, o paskiausiai – konfliktai. Šiame skyriuje šis įgūdis aptariamas nuo pradžios iki galo, o vėliau aprašoma kita įgūdžių rūšis – ta, kuri yra papildinio manifeste.

Dviejų rūšių įgūdžiai

Nexus žodį „įgūdis“ vartoja dviem skirtingiems dalykams, ir jie kuriami skirtingai.

Skills Engine įgūdis Manifesto įgūdis
Kas tai yra SKILL.md paketas įgūdžių bibliotekoje Tipizuota eilutė papildinio skills[] masyve
Kas jį rašo Bet kas, turintis teisę, kūrimo vedlyje arba savo redaktoriuje Kūrėjas, papildinio viduje
Ką jis apima Instrukcijas, įrankius, kuriuos jis gali kviesti, pasirenkamus failus ir scenarijus Įvesties ir išvesties schemą, pakopą ir laukus, kurių ta pakopa reikalauja
Kaip jis patenka į platformą Patikrinamas, įkeliamas ir paskelbiamas Skills Engine Sukompiliuojamas iš manifesto ir sinchronizuojamas su įgūdžių registru
Kas jį vykdo Asistentas, agentai, darbo eigos, DI (dirbtinio intelekto) mygtukai, Claude Code UNO (darbo eigų variklio) paskirstymas
Įprastas naudojimas „Kiekvieną kartą vienodai apibendrinti krantinių planą“ „Paleisti mūsų orbitos propagatorių šiam praskridimui“

Likusioje skyriaus dalyje jie atskiriami. Jei pastraipoje rašoma tiesiog „įgūdis“, turimas omenyje Skills Engine įgūdis.

1 dalis: Skills Engine įgūdžiai

Kas yra įgūdis

Įgūdis yra aplankas. Jo SKILL.md nurodo, kam skirtas įgūdis ir kaip atlikti užduotį; šalia yra visi užduočiai reikalingi failai ir visi jos vykdomi scenarijai. Variklis įgūdį įkelia trimis sluoksniais: pavadinimą ir aprašymą – visada, instrukcijas – kai užduočiai reikia įgūdžio, o failus – tik kai jų reikia kuriam nors žingsniui. Todėl diegime gali būti du šimtai įgūdžių, o jie beveik nieko nekainuoja, kol vienas iš jų nepanaudojamas.

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

Katalogo pavadinimas turi sutapti su įgūdžio slug. Neatitikimas sukelia patikros įspėjimą, ir jį verta ištaisyti, nes pagal slug biblioteka susieja įkėlimą su esamu įgūdžiu.

SKILL.md antraštinė dalis

Antraštinė dalis – tai YAML tarp dviejų --- eilučių failo viršuje. Formatas reikalauja trijų laukų. Pati patikra blokuoja tik keletą dalykų: trūkstamą pavadinimą ar aprašymą ir jau užimtą slug ar užduoties tipą. Visa kita ji praneša kaip įspėjimą.

Laukas Tipas Privalomas Kas jame saugoma
name eilutė taip Unikalus identifikatorius, kebab-case formatu
description eilutė taip Ką įgūdis daro, ne daugiau kaip 500 simbolių. Jį skaito biblioteka ir atitikmenų paieška, todėl rašykite jį skaitytojui, sprendžiančiam, ar tai tinkamas įgūdis
allowed-tools eilutė arba sąrašas taip Įrankiai, kuriuos įgūdis gali kviesti. Jis gali tik susiaurinti jį vykdančiojo leidžiamųjų sąrašą
triggers sąrašas ne Pasvirojo brūkšnio komandos, tiesiogiai iškviečiančios įgūdį
capabilities sąrašas ne Struktūrizuoti gebėjimai, kurių kiekvienas turi name, description ir pasirinktinai input_schema, output_schema bei examples
version eilutė ne Semantinė versija; jei nenurodyta – 1.0.0
visibility eilutė ne private, team arba public
status eilutė ne draft, testing arba published

Instrukcijų apimtis turėtų neviršyti maždaug 5,000 žetonų. Būkite konkretūs ir pateikite pavyzdžių. Kiekvienas įgūdis turėtų gerai atlikti vieną užduotį; jei pastebite, kad rašote „ir dar“, tikriausiai turite du įgūdžius.

skill.yaml

skill.yaml pateikia tai, ko varikliui reikia paieškai ir bibliotekai, kad SKILL.md išliktų lengvai skaitomas. Variklio skaitomi laukai yra name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools ir capabilities. Gebėjimas gali turėti query_patterns – formuluotes, kurias atitikmenų paieška turėtų nukreipti į jį. Taip pat yra užuominų paties variklio biudžeto planavimui: complexity, estimated_tokens ir required_services.

scripts/

Viskas, kas yra scripts/, pažodžiui supakuojama su įgūdžiu kaip komponentas. Scenarijus vykdomas, niekada neįkeliamas į modelio kontekstą, ir vykdomas izoliuotoje aplinkoje. Naudokite jį, kai žingsnis yra aritmetika ar analizė, kurios modelis neturėtų atlikti „mintinai“.

Matomumas ir būsena

Matomumas nurodo, kas gali rasti įgūdį: private – jūs, team – jūsų komanda, o public – visi organizacijos, kuriai tarnauja biblioteka, nariai. Konsolėje tas pats pasirinkimas rodomas kaip „Tik aš“, komanda, pavyzdžiui, „Muitinės skyrius“, arba visa organizacija, be to, įgūdžiu galima pasidalyti srities pakete, atlikus to paketo peržiūrą.

Būsena nurodo, kuriame gyvavimo etape yra įgūdis.

Būsena Reikšmė
draft Kuriamas; nerandamas paieškoje
testing Tikrinamas, prieiga ribota
published Prieinamas bendram naudojimui
deprecated Pakeistas nauju; ruošiamas nutraukti

Paskelbta versija niekada nesikeičia. Konsolėje „live“, „canary“ ir „shadow“ yra versijų žymos, o grįžimas prie ankstesnės versijos perkelia žymą. Vykdomi paleidimai baigiami su ta versija, su kuria buvo pradėti.

Naujas įgūdis · 2 Instrukcijos ir įrankiai
Naujas įgūdis · 2 Instrukcijos ir įrankiai
Antrajame kūrimo vedlio žingsnyje rodomas SKILL.md juodraštis, šalia esantys failai ir kada kiekvienas jų įkeliamas, taip pat įrankiai, kuriuos įgūdis gali kviesti. Tikrinimo įgūdžiui nesiūlomas joks rašantis įrankis, o įgūdis gali tik susiaurinti vykdančiojo leidžiamųjų sąrašą.

Nuo aplanko iki veikiančio įgūdžio

Penki npm scenarijai Skills Engine saugykloje perkelia įgūdį iš jūsų redaktoriaus į biblioteką ir patvirtina, kad jis ten pateko.

Komanda Ką daro
npm run skill:validate skills/<slug> Patikrina paketą. Skelbimui reikia nulio klaidų
npm run skill:upload skills/<slug> Patikrina ir paskelbia vienu žingsniu; idempotentiška
npm run skill:upload skills/<slug> --dry-run Patikrina ir išveda planą nieko neįrašydama
npm run skill:publish -- --dry-run skills/<slug> Žemesnio lygio skelbimas, kuriuo grindžiamas įkėlimas, tas pats procesas
npm run skill:reconcile Palygina jūsų saugyklos įgūdžius su tuo, kas yra bibliotekoje ir įgūdžių registre
npm run skill:live:verify Patikrina paskelbtą įgūdį nuo pradžios iki galo veikiančiame diegime

Skelbiant sukuriami du įrašai, ir abu svarbūs. Vienas – pats įgūdis su SKILL.md turiniu, gebėjimais, komponentais ir kokybės įrašu; jį skaito biblioteka, paieška ir atitikmenų nustatymas. Kitas – registro įrašas, pagal kurį darbo eigų variklis nustato paskirstymą. Įgūdis, patekęs tik į registrą, veikia, tačiau bibliotekoje nematomas, kol jo neįkelsite.

Skelbimas yra idempotentiškas. Nepakeistas įgūdis nesukelia jokio veiksmo, o esamas įgūdis susiejamas pagal slug ir atnaujinamas vietoje, niekada nekuriamas iš naujo. Jei įkelsite tuos pačius baitus kaip jau paskelbtą versiją, gausite tą versiją su CONTENT_HASH_ALREADY_PUBLISHED, o ne dublikatą.

skill:reconcile palygina jūsų saugyklos įgūdžius su biblioteka, registru ir darbo eigų variklio inventoriumi ir praneša apie viską, kas yra vienoje vietoje, bet nėra kitoje. skill:live:verify veikiančiame diegime eina toliau: abu įrašai egzistuoja ir rodo vienas į kitą su ta pačia turinio maiša, bandomasis įgūdžio užduoties tipo paskirstymas priimamas, įgūdis rodomas bibliotekos sąraše ir išsamiame rodinyje, jį galima iškviesti, o audito žurnalas susieja paskelbimą, paskirstymą ir paleidimą pagal slug ir užklausos id.

Iš darbo stoties įkėlimas pasiekia diegimo žinių tarnybą nexus-graphrag per prievado persiuntimą, o aplinkoje turi būti Skills Engine tarnybos raktas. Įkelkite raktą jo neišvesdami:

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

Klasterio viduje, konvejerio užduotyje, numatytasis adresas nustatomas savaime ir GRAPHRAG_URL nereikia. Raktą gaukite per savo organizacijos slaptųjų duomenų procesą. Jis niekada nededamas į saugyklą, apvalkalo istoriją ar komandos išvestį.

Testai, patvirtinimas ir paleidimas

Įgūdis patenka į biblioteką kaip juodraštis, ir kūrimo vedlys jį ten laiko, kol bus įvykdytos trys sąlygos.

Patikra Ką daro
Testiniai atvejai Kiekvienas atvejis turi būti sėkmingas, kad įgūdį būtų galima teikti tvirtinti. Atvejį galima pašalinti tik nurodžius priežastį, kurią mato tvirtintojai.
Bandomasis paleidimas šešėliniu režimu Įgūdis vykdomas su ankstesniais darbais, kurių atsakymų niekas nemato, o jo rezultatai palyginami su tuo, ką tuo metu nusprendė žmogus.
Aklas kitos šeimos modelio vertinimas Jis ieško praleisto patikrinimo, išgalvoto šaltinio ir įterptos instrukcijos, kurios įgūdis paklausė, nors neturėjo.

Tada – patvirtinimas. Įgūdis, pridedantis rašantį įrankį, sulaikomas, kol jį savo prieigos raktais patvirtina du žmonės, ir jį pasiūlęs asmuo negali būti vienas iš jų (PUBLISH_NEEDS_APPROVAL). Tada jis paleidžiamas šešėliniu režimu, vėliau – canary režimu vienam padaliniui už įvardytų vartų, o tada – visiems. Jei canary vartų sąlyga neįvykdoma, canary sustabdomas automatiškai ir visi lieka su ankstesne versija; norint anksčiau laiko išleisti jį visiems, reikia priežasties ir antrojo tvirtintojo (CANARY_GATE_NOT_MET).

Community versijoje yra kūrimo vedlys, biblioteka, versijos ir testai, o savininkas skelbia vienas, kai testai sėkmingi. Canary, dviejų asmenų patvirtinimas, papildinių sinchronizavimas ir dublikatų suliejimas pateikiami su Enterprise.

Naujas įgūdis · 4 Paskelbimas
Naujas įgūdis · 4 Publikavimas
Skelbimo žingsnyje rodoma, kodėl įgūdis sulaikytas, kas turi pritarti ir kaip jis bus paleistas: patvirtintas, šešėliniu režimu, canary režimu už įvardytų vartų, tada visiems. Siūlytojas negali patvirtinti savo paties pakeitimo, o paskutinė versija lieka paruošta grįžimui.

Kur pasirodo įgūdžiai

Tas pats paskelbtas įgūdis pasiekia žmones penkiose vietose.

  1. Asistentas susieja užklausą su įgūdžiu pagal jo aprašymą, paleidiklius ir užklausų šablonus ir vykdo įgūdžio instrukcijas.
  2. Agentai ir darbo eigos kviečia įgūdžius kaip žingsnius. Darbo eigos žingsnis nurodo įgūdį; paleidimas įrašo, kuri versija buvo naudota.
  3. DI mygtukai ekranuose vykdo po vieną įgūdį. Administratorius gali atidaryti „Apie šį mygtuką“ ir pamatyti, kokį įgūdį vykdo mygtukas, ką jis skaito ir kas jį paskutinis keitė, taip pat gali išjungti mygtuką neliesdamas įgūdžio.
  4. Jūsų IDE (integruota kūrimo aplinka) ir Claude Code pasiekia biblioteką per Workbench ir trylika MCP (Model Context Protocol) įrankių, tarp jų list_skills, get_skill, match_prompt, discover_skills, invoke_skill, record_execution, create_skill, import_skill, get_generation_job ir sync_skills_local. Kiekvienas iškvietimas vykdomas jį pradėjusio asmens vardu, jo leidžiamųjų sąrašo ribose.
  5. Pati įgūdžių biblioteka, kurioje žmonės naršo, vykdo įgūdžius ir siūlo jų pakeitimus, o administratoriai mato kiekvieno įgūdžio savininką, naudotojus, paleidimus ir išlaidas.

Kad ir kas vykdytų įgūdį, įgūdis negali išplėsti to, ką vykdantysis gali daryti: jis kviečia tik vykdančiojo leidžiamųjų sąraše esančius įrankius ir skaito tik tai, ką tas asmuo gali atidaryti (SKILL_CANNOT_WIDEN_TOOLS). Paleidimas be modelio maršruto atmetamas, o ne spėliojamas (SKILLS_ENGINE_BINDING_MISSING); maršrutą parenka paskirstytuvas pagal pačios organizacijos modelių sąranką.

Apie šį mygtuką
Apie šį mygtuką
„Apie šį mygtuką“ rodo, kokį įgūdį vykdo DI mygtukas, tris jo skaitomus šaltinius, kas jį parašė ir peržiūrėjo bei ką pakeitė naujausia versija. Išjungus mygtuką, jis iš karto pašalinamas visur; įgūdis ir visi ankstesni atsakymai išlieka.

Išsamus pavyzdys: Harrow krantinių paskirstymo santrauka

Harrow planuotojų leidžiamųjų sąraše jau buvo du tik skaitymo įrankiai iš paties Harrow krantinių planavimo papildinio: berth-plan.read grąžina konkrečios datos planą, o vessel-call.read grąžina laivo atplaukimą su jo atvykimo laiko langu ir ilgiu. Įgūdžiui daugiau nieko nereikia. Jis niekada nerašo, todėl jam niekada nereikia dviejų tvirtintojų.

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

Šalia esantis skill.yaml suteikia bibliotekai rodomą pavadinimą, kategoriją ir formuluotes, kurias atitikmenų paieška turėtų nukreipti čia:

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

Tada komandos iš saugyklos šakninio katalogo:

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 kūrimo vedlyje pridėjo šešis testinius atvejus: įprastą dieną, dieną su vėluojančiu atvykimu, dėl kurio perkelti du atplaukimai, dieną su tikru konfliktu, datą, kuriai dar nėra plano, laivą, per ilgą savo krantinei, ir užklausą, kuria bandyta priversti įgūdį pasiūlyti naują krantinę (jis neturėtų to daryti; jis neturi rašančio įrankio). Bandomasis paleidimas šešėliniu režimu pakartojo dvidešimt ankstesnių planų. Kai atvejai buvo sėkmingi, planavimo skyriaus peržiūrėtojas jį patvirtino, ir jis buvo paleistas planavimo komandai. Dabar asistentas kiekvieną kartą į klausimą atsako ta pačia forma, o planuotojų DI mygtukas krantinių plano puslapyje vykdo tą patį įgūdį.

2 dalis: manifesto įgūdžiai

Manifesto įgūdis yra papildinio skelbiamas skaičiavimo vienetas. Jis deklaruojamas manifesto skills[], patikrinamas SDK (programinės įrangos kūrimo rinkinio), kai paleidžiate create-nexus-plugin validate, sukompiliuojamas į registro turinį naudojant compileRegistry ir sinchronizuojamas su įgūdžių registru. Registro SQL niekada nerašote rankiniu būdu, todėl platformos paskirstoma eilutė ir jūsų deklaruotas aprašas negali išsiskirti.

Kiekvienam manifesto įgūdžiui reikia id, displayName, description, tier, classification, inputSchema ir outputSchema. Taip pat deklaruokite timeoutMs: tai sveikasis skaičius nuo 1,000 iki 21,600,000 (nuo vienos sekundės iki šešių valandų), o už šio intervalo esanti reikšmė atmetama su TIMEOUT_OUT_OF_BOUNDS. dataResidency yra any, eu arba us, o any yra numatytoji reikšmė.

id rašomas lower_snake formatu, o registro siuntimo raktas yra vardų sritimi pažymėtas užduoties tipas <plugin name>.<skill id>, todėl du papildiniai gali abu turėti summarise įgūdį be konflikto. Štai vienintelis šablono įgūdis, sutrumpintas:

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

Penki lygiai

Lygis nėra tik žymė. Kiekvienas lygis turi savo laukus, o laukas, priklausantis kitam lygiui, atmetamas su FIELD_NOT_FOR_TIER, o ne tyliai praleidžiamas.

Pakopa Reikalauja Pasiekia modelį Kas jį vykdo
host_callback hostCallback: jūsų Service, jos prievadas, kelias ir abi baitų ribos Ne Platforma siunčia įvestį POST užklausa į jūsų pačių Service, esančią jūsų vardų srityje
plugin_queue queueName, rašoma <plugin name>.<name> Ne Jūsų darbuotojas (worker), imantis užduotis iš jūsų eilės
tool_using systemPrompt ir tools[]; pasitikėjimas core arba verified Taip Platforma, per AI Provider Router; kiekvienas įrankio iškvietimas vykdomas per leidžiamųjų sąraše esantį vykdytoją
llm_only systemPrompt; pasitikėjimas core arba verified Taip Platforma, vienu iškvietimu per AI Provider Router
map map.perItemJobType, nurodantis kitą to paties manifesto įgūdį, kuris nėra map Tik per savo tikslą Platforma vykdo tikslą kartą kiekvienam elementui ir surenka rezultatus

Nė vienas modelio lygis nenurodo nei teikėjo, nei modelio. Maršrutizatorius parenka abu iš siunčiančios organizacijos nuosavo telkinio. tool_using įgūdžio įrankis nurodo vieną iš šešių vykdytojų: standing_service_call (jūsų pačių Service), graphrag, graphrag_query, graphrag_search, h3 arba web_search. Bet kuris kitas atmetamas su EXECUTOR_NOT_PERMITTED. Trys žinių grafo vykdytojai priima tik įrankių pavadinimus graphrag_query ir graphrag_search, nes vykdytojas atlieka tą operaciją, kurios vardu pavadintas įrankis.

Registre yra du lygiai, kurių papildinys negali deklaruoti: grandines ir savarankiškai veikiančius įgūdžius rašo tik platforma. Sinchronizavimas, nurodantis vieną iš jų, atmetamas visas.

Kurį lygį naudoti

  • host_callback, kai darbas yra įvesties funkcija, kurią apskaičiuoja jūsų pačių kodas: įvertis, skaičiavimas, paieška jūsų pačių schemoje. Jį paprasčiausia testuoti, ir tai šablono numatytasis lygis. Apsaugokite atgalinio iškvietimo maršrutą: kelias manifeste nėra paslaptis, todėl maršrutas turi patikrinti platformos iškvietimą ir paimti organizaciją iš jo, niekada ne iš užklausos turinio. Deklaruokite jį auth: internal ir prijunkite prie jo requireService (Fastify) arba serviceMiddleware (Express). Apsauga atmeta žetoną, išduotą bet kam kitam. Atsakykite greitai ir užtikrinkite, kad pakartotinis tos pačios užduoties pristatymas nepakenktų.
  • plugin_queue ilgesniam darbui, kurio laukia žmogus ir kurio gyvavimo ciklą valdo jūsų darbuotojas (worker). Darbuotojas turi perkelti vykdymą į running, kai pradeda, ir į galutinę būseną, kai baigia; darbuotojas, kuris tik paskelbia savo rezultatą, palieka vykdymą amžinai rodantį queued.
  • llm_only, kai darbą atlieka vienas modelio iškvietimas su fiksuota sistemine užklausa, o jūsų papildinys yra core arba verified.
  • tool_using, kai modeliui reikia kviesti įrankius cikle, taip pat tik esant core arba verified.
  • map, kai norite, kad platforma išskleistų vieną iš kitų jūsų įgūdžių per sąrašą.

Mano orbitų skaičiavimo įgūdis Corrán Orbital yra host_callback. Mūsų papildinys yra community, todėl modelių lygiai niekada nebuvo galimybė, ir aš jų nepasigendu: skaičiuoklė, antradienį pateikusi kitokį atsakymą, būtų blogiau nei nenaudinga.

Patvirtinimas prieš kiekvieną vykdymą

Manifesto įgūdis, kuris niekada neturi būti vykdomas vien mašinos nurodymu, tai deklaruoja:

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

required visada yra true; įgūdis, kuriam patvirtinimo nereikia, šio bloko nenurodo. reason yra tai, ką mato tvirtintojas, nuo 1 iki 500 simbolių po apkarpymo, o bet kokia kita forma atmetama su APPROVAL_INVALID. Tada įgūdžio siuntimas sulaikomas: siuntimas atsako 202 su status: "awaiting_approval" ir waitpointId, ir tik įvardyto asmens patvirtinimas jį išleidžia, vieną kartą. Sulaikyto įgūdžio paketinis, map ar grandinės siuntimas atmetamas su SKILL_APPROVAL_NOT_HOLDABLE, nes išskleidimas negali sulaikyti savo elementų. Atvaizduokite sulaikytą atsakymą ir leiskite tvirtintojui nuspręsti; neprašykite sutikimo jau atlikę siuntimą.

Sinchronizavimas su registru

Kiekvienas sinchronizavimas yra deklaratyvus ir tikrinamas visas. Kiekvieną kartą siųskite visą įgūdžių rinkinį: įgūdis, kurį praleidžiate, išjungiamas, o jo vykdymų istorija išlieka. Vienas blogas įgūdis atmeta visą sinchronizavimą su SYNC_CONTRACT_VIOLATION, visi pažeidimai išvardijami kartu ir niekas neįrašoma, todėl papildinys niekada nebūna atnaujintas tik iš dalies. 2.22 skyriuje „Papildinių vykdymo aplinka“ aprašomas sinchronizavimo iškvietimas ir tai, kaip platforma žino, kuris papildinys kviečia.

Įgūdžiai IDE ir Claude Code
Įgūdžiai IDE aplinkoje ir „Claude Code“
Skyriuje „Įgūdžiai IDE ir Claude Code“ parodomi tie patys tikrinimo, įkėlimo ir publikavimo veiksmai iš paties kūrėjo terminalo, kai juodraštis sulaikomas patvirtinimui, nes jo autorė negali patvirtinti savo pačios pakeitimo.

Pasirinkimas tarp šių dviejų rūšių

Jei užduotis yra „pasakyk tai kiekvieną kartą vienodai“, tai Skills Engine įgūdis. Jei užduotis yra „paleisk mano kodą ir pateik jo atsakymą“, tai manifesto įgūdis. Dauguma realių darbų galiausiai yra abu: Harrow prieplaukos santrauka yra Skills Engine įgūdis, kurio įrankiai gaunami iš papildinio, o papildinio įrankiai patys deklaruoti jo manifeste. Skills Engine įgūdį pakeisti pigiau iš jų dviejų, todėl tai gera priežastis formuluotes ir sprendimus laikyti ten, o aritmetiką – papildinyje.

Kaina bet kuriuo atveju reali. Skills Engine įgūdis nėra baigtas, kai SKILL.md skamba gerai; jis baigtas, kai praeina jo atvejai, jo bandomasis vykdymas sutampa su tuo, ką nusprendė žmonės, ir jį patvirtino kas nors kitas nei jūs. Įgūdžiui, kuris rašo, skirkite savaitę, didžiąją jos dalį – kanarėliniam diegimui.