PieteiktiesPieteikt konsultāciju

2.20. nodaļa

Prasmes

Kā uzrakstīt, testēt un publicēt Skills Engine prasmi, kur tā parādās pēc publicēšanas un kā atšķiras manifesta prasmes spraudnī. Ietver izstrādātu piestātņu piešķiršanas kopsavilkuma piemēru uzņēmumam Harrow Port Authority.

Šo lapu no oriģināla angļu valodā ir tulkojis MI. Neskaidrību gadījumā par pamatu jāņem lapa angļu valodā. Lasīt šo lapu angļu valodā

17 minūšu lasīšana

Tomás Reilly, platformas inženieris organizācijā Harrow Port Authority, pagājušajā mēnesī man vaicāja, kāpēc viņa piestātņu plānotāji saņem atšķirīgu atbildi ik reizi, kad viņi asistentam uzdod jautājumu "kurš rīt ir kurā piestātnē un kas tika pārvietots?". Atbilde bija tāda, ka neviens nebija asistentam izskaidrojis, kā izskatās laba atbilde. Skills Engine prasme to atrisināja vienā pēcpusdienā: tagad plānotāji vienmēr saņem vienādu trīsdaļīgu kopsavilkumu, kurā vispirms ir piestātņu tabula, zem tās — izmaiņas kopš iepriekšējā plāna, un beigās — pārklāšanās. Šajā nodaļā šī prasme ir apskatīta no sākuma līdz beigām, un pēc tam ir aprakstīts otrs prasmju veids — tas, kas atrodas spraudņa manifestā.

Divu veidu prasmes

Nexus vārdu "prasme" izmanto divām dažādām lietām, un tās tiek veidotas atšķirīgi.

Skills Engine prasme Manifesta prasme
Kas tas ir SKILL.md pakotne prasmju bibliotēkā Tipizēta rinda spraudņa skills[] masīvā
Kas to raksta Ikviens ar attiecīgām tiesībām veidotājā vai savā redaktorā Izstrādātājs spraudņa iekšienē
Ko tā satur Instrukcijas, rīkus, ko tā drīkst izsaukt, neobligātus failus un skriptus Ievades un izvades shēmu, līmeni un šim līmenim nepieciešamos laukus
Kā tā nonāk platformā Validēta, augšupielādēta un publicēta dzinī Skills Engine Kompilēta no manifesta un sinhronizēta ar prasmju reģistru
Kas to darbina Asistents, aģenti, darbplūsmas, MI (mākslīgā intelekta) pogas, Claude Code UNO (darbplūsmas dziņa) nosūtīšana
Tipisks lietojums " Katru reizi apkopot piestātņu plānu vienādi" "Šajā pārlidojumā palaist mūsu orbītas prognozētāju"

Pārējā nodaļas daļā tās tiek nošķirtas. Ja rindkopā ir minēts vārds "prasme" bez papildinājumiem, tā ir Skills Engine prasme.

1. daļa: Skills Engine prasmes

Kas ir prasme

Prasme ir mape. Tās SKILL.md nosaka, kam prasme ir paredzēta un kā veikt uzdevumu; tai blakus atrodas visi uzdevumam nepieciešamie faili un visi skripti, ko tā izpilda. Dzinis prasmi ielādē trīs slāņos: nosaukumu un aprakstu — vienmēr, instrukcijas — kad uzdevumam ir nepieciešama šī prasme, un failus — tikai tad, kad tie ir nepieciešami kādam solim. Tieši tāpēc instalācija var saturēt divsimt prasmju un par tām gandrīz neko netērēt, līdz kāda no tām tiek izmantota.

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

Direktorija nosaukumam ir jāsakrīt ar prasmes īsceļu (slug). Neatbilstība rada validācijas brīdinājumu, un to ir vērts izlabot, jo tieši pēc īsceļa bibliotēka sasaista augšupielādi ar esošu prasmi.

SKILL.md priekšdati

Priekšdati (frontmatter) ir YAML kods starp divām --- rindām faila augšdaļā. Formāts pieprasa trīs laukus. Pati validācija bloķē darbību tikai dažos gadījumos: ja trūkst nosaukuma vai apraksta, vai arī ja īsceļš vai uzdevuma veids jau ir aizņemts. Par visu pārējo tā ziņo kā par brīdinājumu.

Lauks Tips Obligāts Ko tas satur
name virkne jā Unikālais identifikators kebab-case formātā
description virkne jā Ko prasme dara, ne vairāk kā 500 rakstzīmju. To lasa bibliotēka un saskaņotājs, tāpēc rakstiet to lasītājam, kurš lemj, vai šī ir īstā prasme
allowed-tools virkne vai saraksts jā Rīki, ko prasme drīkst izsaukt. Tā var tikai sašaurināt tās personas atļauto rīku sarakstu, kura to izpilda
triggers saraksts nē Slīpsvītras komandas, kas tieši izsauc prasmi
capabilities saraksts nē Strukturētas iespējas, katra ar name, description un pēc izvēles ar input_schema, output_schema un examples
version virkne nē Semantiskā versija; 1.0.0, ja nav norādīta
visibility virkne nē private, team vai public
status virkne nē draft, testing vai published

Iekļaujiet instrukcijas aptuveni 5,000 tokenu apjomā. Esiet konkrēti un sniedziet piemērus. Katrai prasmei ir labi jāveic viens uzdevums; ja pieķerat sevi rakstām "un vēl", jums, visticamāk, ir divas prasmes.

skill.yaml

skill.yaml satur to, kas dzinim ir nepieciešams atklāšanai un bibliotēkai, lai SKILL.md paliktu viegli lasāms. Lauki, ko dzinis lasa, ietver name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools un capabilities. Iespēja var saturēt query_patterns — formulējumus, kas saskaņotājam uz to jānosūta. Ir arī norādes paša dziņa budžeta plānošanai: complexity, estimated_tokens un required_services.

scripts/

Viss, kas atrodas zem scripts/, tiek bez izmaiņām pievienots prasmei kā komponents. Skripts tiek izpildīts, tas nekad netiek ielasīts modeļa kontekstā, un tas darbojas smilškastē. Izmantojiet to, ja solis ir aritmētisks aprēķins vai parsēšana, ko modelim nevajadzētu veikt galvā.

Redzamība un statuss

Redzamība nosaka, kurš var atrast prasmi: private esat jūs, team ir jūsu komanda, un public ir ikviens organizācijā, ko apkalpo bibliotēka. Konsolē šī pati izvēle ir redzama kā "Tikai es", komanda, piemēram, "Muitas nodaļa", vai visa organizācija, un prasmi var arī kopīgot domēna pakotnē, izmantojot šīs pakotnes pārskatīšanas procesu.

Statuss norāda, kurā dzīves cikla posmā prasme atrodas.

Statuss Nozīme
draft Izstrādes procesā; nav atklājama
testing Tiek validēta, ar ierobežotu piekļuvi
published Pieejama vispārējai lietošanai
deprecated Aizstāta; ceļā uz izņemšanu no aprites

Kad versija ir publicēta, tā vairs nekad nemainās. Konsolē "live", "canary" un "shadow" ir versiju iezīmes, un pārslēgšanās atpakaļ uz agrāku versiju pārvieto iezīmi. Jau sāktās izpildes tiek pabeigtas ar to versiju, ar kuru tās tika sāktas.

Jauna prasme · 2 Instrukcijas un rīki
Jauna prasme · 2 Instrukcijas un rīki
Veidotāja otrajā solī ir redzams SKILL.md melnraksts, tam blakus esošie faili un katra faila ielādes laiks, kā arī rīki, ko prasme drīkst izsaukt. Pārbaudes prasmei netiek piedāvāts neviens rīks, kas veic ierakstīšanu, un prasme var tikai sašaurināt izpildītāja atļauto rīku sarakstu.

No mapes līdz aktīvai prasmei

Pieci npm skripti Skills Engine repozitorijā nogādā prasmi no jūsu redaktora uz bibliotēku un apliecina, ka tā tur ir nonākusi.

Komanda Ko tas dara
npm run skill:validate skills/<slug> Pārbauda pakotnes kodu (linting). Publicēšanai ir nepieciešams nulles kļūdu skaits
npm run skill:upload skills/<slug> Validē un publicē vienā solī; idempotenta darbība
npm run skill:upload skills/<slug> --dry-run Validē un izdrukā plānu, neko neierakstot
npm run skill:publish -- --dry-run skills/<slug> Zemāka līmeņa publicēšana aiz augšupielādes, tā pati konveijera plūsma
npm run skill:reconcile Salīdzina jūsu repozitorijā esošās prasmes ar to, kas atrodas bibliotēkā un prasmju reģistrā
npm run skill:live:verify Pilnībā pārbauda publicēto prasmi darbojošajā instalācijā

Publicēšana izveido divus ierakstus, un abi ir svarīgi. Viens ir pati prasme ar tās SKILL.md saturu, iespējām, komponentiem un kvalitātes ierakstu; to lasa bibliotēka, atklāšana un saskaņošana. Otrs ir reģistra ieraksts, pret kuru darbplūsmas dzinis atrisina nosūtīšanu. Prasme, kas ir nonākusi tikai reģistrā, darbojas, taču tā nav redzama bibliotēkā, kamēr to neaugšupielādējat.

Publicēšana ir idempotenta. Nemainīta prasme neizraisa nekādu darbību, un esoša prasme tiek saskaņota pēc tās īsceļa un atjaunināta uz vietas, nevis izveidota no jauna. Augšupielādējiet tos pašus baitus kā versijai, kas jau ir publicēta, un jūs saņemsiet atpakaļ šo versiju ar CONTENT_HASH_ALREADY_PUBLISHED, nevis dublikātu.

skill:reconcile salīdzina jūsu repozitorija prasmes ar bibliotēku, reģistru un darbplūsmas dziņa inventāru un ziņo par visu, kas pastāv vienā vietā, bet ne citā. skill:live:verify darbojošajā instalācijā iet vēl tālāk: abi ieraksti pastāv un norāda viens uz otru ar vienu un to pašu satura jaucējkodu, tiek pieņemta prasmes uzdevuma veida testa nosūtīšana, prasme tiek rādīta bibliotēkas sarakstā un detalizētajā skatā, to var izsaukt, un audita pieraksti sasaista publicēšanu, nosūtīšanu un izpildi pēc īsceļa un pieprasījuma id.

No darbstacijas augšupielāde sasniedz instalācijas zināšanu pakalpojumu nexus-graphrag, izmantojot portu pāradresāciju, un tai vidē ir nepieciešama Skills Engine pakalpojuma atslēga. Ielādējiet atslēgu, neatspoguļojot to ekrānā:

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

Klastera iekšienē, konveijera uzdevumā, noklusējuma adrese tiek atrisināta pati un GRAPHRAG_URL nav nepieciešams. Iegūstiet atslēgu, izmantojot savas organizācijas noslēpumu pārvaldības procesu. Tā nekad nedrīkst nonākt repozitorijā, jūsu čaulas vēsturē vai komandas izvadē.

Testi, apstiprināšana un nodošana ekspluatācijā

Prasme nonāk bibliotēkā kā melnraksts, un veidotājs to tur aiztur, līdz tiek izpildīti trīs nosacījumi.

Pārbaude Ko tas dara
Testa gadījumi Pirms prasmi var nodot apstiprināšanai, visiem gadījumiem ir jābūt sekmīgiem. Gadījumu var noņemt tikai tad, ja tiek norādīts iemesls, ko redz apstiprinātāji.
Testa izpilde ēnas režīmā Prasme tiek darbināta ar pagātnes darbiem, kur neviens neredz atbildes, un tās rezultāti tiek salīdzināti ar to, ko tajā laikā nolēma cilvēks.
Aklā pārskatīšana, ko veic citas saimes modelis Tas meklē izlaistu pārbaudi, izdomātu avotu un paslēptu instrukciju, kurai prasme sekoja, lai gan tai nevajadzēja to darīt.

Pēc tam seko apstiprināšana. Prasme, kas pievieno rīku, kurš veic ierakstīšanu, tiek aizturēta, līdz to ar savām piekļuves atslēgām (passkeys) apstiprina divi cilvēki, un persona, kas to ierosināja, nevar būt viena no viņiem (PUBLISH_NEEDS_APPROVAL). Pēc tam tā kļūst aktīva ēnas režīmā (shadow), tad kanārijputniņa režīmā (canary) vienai vienībai aiz nosauktiem vārtiem, un pēc tam — visiem. Ja kanārijputniņa vārtu nosacījumi netiek izpildīti, kanārijputniņa režīms pats sevi aptur un visi paliek pie iepriekšējās versijas; lai to priekšlaicīgi nosūtītu visiem, ir nepieciešams iemesls un otrs apstiprinātājs (CANARY_GATE_NOT_MET).

Community izdevumā ir pieejams gan veidotājs, gan bibliotēka, gan versijas un testi, un īpašnieks publicē prasmi viens pats, tiklīdz testi ir sekmīgi. Kanārijputniņa režīms, divu personu apstiprināšana, spraudņu sinhronizācija un dublikātu sapludināšana ir pieejama Enterprise izdevumā.

Jauna prasme · 4 Publicēšana
Jauna prasme · 4 Publicēšana
Publicēšanas sadaļā ir redzams, kāpēc prasme tiek aizturēta, kam ir jāpiekrīt un kā tā tiek nodota ekspluatācijā: apstiprināta, ēnas režīmā, kanārijputniņa režīmā aiz nosauktiem vārtiem un pēc tam visiem. Ierosinātājs nevar apstiprināt savas izmaiņas, un pēdējā versija paliek gatava, lai uz to varētu pārslēgties atpakaļ.

Kur prasmes ir redzamas

Tā pati publicētā prasme sasniedz cilvēkus piecās vietās.

  1. Asistents saskaņo pieprasījumu ar prasmi pēc tās apraksta, trigeriem un vaicājumu paraugiem un seko prasmes instrukcijām.
  2. Aģenti un darbplūsmas izsauc prasmes kā soļus. Darbplūsmas solis nosauc prasmi; izpilde reģistrē, kuru versiju tā izmantoja.
  3. MI pogas ekrānos katra izpilda vienu prasmi. Administrators var atvērt sadaļu "Par šo pogu", lai redzētu prasmi, ko poga izpilda, ko tā lasa un kurš to pēdējais mainīja, kā arī var izslēgt pogu, neaiztiekot pašu prasmi.
  4. Jūsu IDE (integrētā izstrādes vide) un Claude Code sasniedz bibliotēku, izmantojot Workbench un trīspadsmit MCP (Model Context Protocol) rīkus, tostarp list_skills, get_skill, match_prompt, discover_skills, invoke_skill, record_execution, create_skill, import_skill, get_generation_job un sync_skills_local. Katrs izsaukums tiek izpildīts tās personas vārdā, kura to sāka, viņas atļauto rīku saraksta ietvaros.
  5. Pati prasmju bibliotēka, kur cilvēki pārlūko, izpilda un iesaka izmaiņas prasmēs, un administratori redz katras prasmes īpašnieku, lietotājus, izpildes un izmaksas.

Neatkarīgi no tā, kas izpilda prasmi, prasme nevar paplašināt to, ko izpildītājs drīkst darīt: tā izsauc tikai rīkus, kas atrodas izpildītāja atļauto rīku sarakstā, un lasa tikai to, ko šī persona drīkst atvērt (SKILL_CANNOT_WIDEN_TOOLS). Izpilde bez modeļa maršruta tiek noraidīta, nevis minēta (SKILLS_ENGINE_BINDING_MISSING); maršrutu izvēlas nosūtītājs no organizācijas pašas modeļu iestatījumiem.

Par šo pogu
Par šo pogu
Sadaļā "Par šo pogu" ir redzama prasme, ko izpilda MI poga, trīs avoti, ko tā lasa, kurš to uzrakstīja un pārskatīja, un ko mainīja jaunākā versija. Izslēdzot pogu, tā tiek noņemta visur vienlaikus; prasme un katra iepriekšējā atbilde saglabājas.

Praktisks piemērs: piestātņu piešķiršanas kopsavilkums organizācijai Harrow

Harrow plānotājiem atļauto rīku sarakstā jau bija divi tikai lasāmi rīki no pašas organizācijas Harrow piestātņu plānošanas spraudņa: berth-plan.read atgriež plānu noteiktam datumam, un vessel-call.read atgriež kuģa ienākšanu ar tā ierašanās logu un garumu. Prasmei nekas cits nav nepieciešams. Tā nekad neveic ierakstīšanu, tāpēc tai nekad nav nepieciešami divi apstiprinātāji.

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

Tai blakus esošais skill.yaml sniedz bibliotēkai parādāmo nosaukumu, kategoriju un formulējumus, kas saskaņotājam ir jānovirza uz šejieni:

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

Pēc tam komandas no repozitorija saknes direktorija:

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 veidotājā pievienoja sešus testa gadījumus: parasta diena, diena ar kavētu ierašanos, kas pārcēla divas kuģu ienākšanas, diena ar reālu pārklāšanos, datums, kuram vēl nav plāna, kuģis, kas ir pārāk garš savai piestātnei, un pieprasījums, kas mēģināja panākt, lai prasme piedāvā jaunu piestātni (tai to nevajadzētu darīt; tai nav rīka, kas veic ierakstīšanu). Testa izpilde ēnas režīmā atkārtoja divdesmit iepriekšējos plānus. Kad gadījumi bija sekmīgi izpildīti, plānošanas nodaļas recenzents to apstiprināja, un tā kļuva aktīva plānošanas komandai. Tagad asistents vienmēr atbild uz jautājumu vienādā formā, un plānotāju MI poga piestātņu plāna lapā izpilda to pašu prasmi.

2. daļa: manifesta prasmes

Manifesta prasme ir skaitļošanas vienība, ko publicē spraudnis. Tā tiek deklarēta manifesta laukā skills[], to validē SDK (programmatūras izstrādes komplekts), kad izpildāt create-nexus-plugin validate, reģistra saturā to kompilē compileRegistry, un tā tiek sinhronizēta ar prasmju reģistru. Jūs nekad nerakstāt reģistra SQL ar roku, tāpēc rinda, ko platforma nosūta, un aprakstītājs, ko deklarējāt, nevar atšķirties.

Katrai manifesta prasmei ir nepieciešams id, displayName, description, tier, classification, inputSchema un outputSchema. Deklarējiet arī timeoutMs: tas ir vesels skaitlis no 1,000 līdz 21,600,000 (no vienas sekundes līdz sešām stundām), un vērtība ārpus šī diapazona tiek noraidīta ar TIMEOUT_OUT_OF_BOUNDS. dataResidency ir any, eu vai us, un any ir noklusējuma vērtība.

id ir lower_snake formātā, un reģistra nosūtīšanas atslēga ir nosaukumvietas uzdevuma veids <plugin name>.<skill id>, tāpēc diviem spraudņiem var būt summarise prasme bez konfliktiem. Šeit ir veidnes vienīgā prasme saīsinātā veidā:

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

Pieci līmeņi

Līmenis nav tikai iezīme. Katram līmenim ir savi lauki, un lauks, kas pieder citam līmenim, tiek noraidīts ar FIELD_NOT_FOR_TIER, nevis klusi atmests.

Līmenis Pieprasa Sasniedz modeli Kas to izpilda
host_callback hostCallback: jūsu Service, tā ports, ceļš un abi baitu ierobežojumi Nē Platforma nosūta (POST) ievadi jūsu pašu pakalpojumam Service jūsu nosaukumvietas iekšienē
plugin_queue queueName, rakstīts kā <plugin name>.<name> Nē Jūsu darbinieks (worker), paņemot no jūsu rindas
tool_using systemPrompt un tools[]; uzticamības līmenis core vai verified Jā Platforma, izmantojot AI Provider Router; katrs rīka izsaukums tiek izpildīts caur atļauto sarakstā iekļautu izpildītāju
llm_only systemPrompt; uzticamības līmenis core vai verified Jā Platforma, viens izsaukums caur AI Provider Router
map map.perItemJobType, nosaucot citu tā paša manifesta prasmi, kas nav karte (map) Tikai caur tās mērķi Platforma izpilda mērķi vienu reizi katram vienumam un apkopo rezultātus

Neviens no modeļu līmeņiem nenosauc pakalpojumu sniedzēju vai modeli. Maršrutētājs izvēlas abus no nosūtītājas organizācijas paša pūla. Rīks tool_using prasmē nosauc vienu no sešiem izpildītājiem: standing_service_call (jūsu pašu Service), graphrag, graphrag_query, graphrag_search, h3 vai web_search. Jebkurš cits tiek noraidīts ar EXECUTOR_NOT_PERMITTED. Trīs zināšanu grafa izpildītāji pieņem tikai rīku nosaukumus graphrag_query un graphrag_search, jo izpildītājs veic to darbību, kuras vārdā rīks ir nosaukts.

Reģistrā pastāv divi līmeņi, kurus spraudnis nevar deklarēt: ķēdes un prasmes, kas darbojas pašas par sevi, raksta tikai platforma. Sinhronizācija, kurā ir nosaukts kāds no tiem, tiek noraidīta pilnībā.

Kuru līmeni izmantot

  • host_callback, ja darbs ir ievades funkcija, ko aprēķina jūsu pašu kods: novērtējums, aprēķins, uzmeklēšana jūsu pašu shēmā. To ir visvienkāršāk testēt, un tā ir veidnes noklusējuma vērtība. Aizsargājiet atpakaļizsaukuma maršrutu: ceļš manifestā nav noslēpums, un maršrutam ir jāverificē platformas izsaukums un jāpaņem organizācija no tā, nekad no pamatteksta. Deklarējiet to kā auth: internal un pievienojiet tam requireService (Fastify) vai serviceMiddleware (Express). Aizsargs noraida tokenu, kas izveidots jebkuram citam. Atbildiet ātri un padariet tā paša uzdevuma otrreizēju piegādi nekaitīgu.
  • plugin_queue ilgākam darbam, ko cilvēks gaida un kur dzīves ciklu pārvalda jūsu darbinieks (worker). Darbiniekam ir jāpārvieto izpilde uz running, kad tas sāk darbu, un uz beigu statusu, kad tas pabeidz darbu; darbinieks, kas tikai nosūta savu rezultātu, atstāj izpildi rādām queued uz visiem laikiem.
  • llm_only, ja uzdevumu paveic viens modeļa izsaukums ar fiksētu sistēmas uzvedni un jūsu spraudnis ir core vai verified.
  • tool_using, ja modelim ir jāizsauc rīki ciklā, atkal tikai līmenī core vai verified.
  • map, ja vēlaties, lai platforma izplatītu kādu no jūsu citām prasmēm visam sarakstam.

Mana orbītas prognozēšanas prasme organizācijā Corrán Orbital ir host_callback. Mūsu spraudnis ir community, tāpēc modeļu līmeņi nekad nebija opcija, un man to nepietrūkst: prognozētājs, kas otrdien sniegtu atšķirīgu atbildi, būtu sliktāks nekā bezjēdzīgs.

Apstiprināšana pirms katras izpildes

Manifesta prasme, kas nekad nedrīkst darboties tikai pēc mašīnas lēmuma, to deklarē šādi:

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

required vienmēr ir true; prasme, kurai nav nepieciešams apstiprinājums, šo bloku izlaiž. reason ir tas, ko redz apstiprinātājs, no 1 līdz 500 rakstzīmēm pēc atstarpju noņemšanas, un jebkura cita forma tiek noraidīta ar APPROVAL_INVALID. Prasmes nosūtīšana tad tiek aizturēta: nosūtīšana atbild 202 ar status: "awaiting_approval" un waitpointId, un tikai nosauktas personas apstiprinājums to atbrīvo vienu reizi. Aizturētas prasmes pakešu, kartes vai ķēdes nosūtīšana tiek noraidīta ar SKILL_APPROVAL_NOT_HOLDABLE, jo izplatīšana (fan-out) nevar aizturēt savus vienumus. Atveidojiet aizturēto atbildi un ļaujiet apstiprinātājam pieņemt lēmumu; neveiciet nosūtīšanu, lai pēc tam prasītu piekrišanu.

Sinhronizācija ar reģistru

Katra sinhronizācija ir deklaratīva un tiek pārbaudīta kopumā. Katru reizi nosūtiet pilnu prasmju kopu: prasme, ko izlaižat, tiek atspējota, un tās izpildes vēsture saglabājas. Viena nederīga prasme noraida visu sinhronizāciju ar SYNC_CONTRACT_VIOLATION, visus pārkāpumus uzskaitot kopā un neko neierakstot, tāpēc spraudnis nekad netiek atjaunināts pa pusei. 2.22. nodaļā Spraudņa izpildlaiks ir aprakstīts sinhronizācijas izsaukums un tas, kā platforma zina, kurš spraudnis veic izsaukumu.

Prasmes vidē IDE un Claude Code
Prasmes IDE vidē un Claude Code
Sadaļā "Prasmes vidē IDE un Claude Code" ir parādīti tie paši validācijas, augšupielādes un publicēšanas soļi no paša izstrādātāja termināļa, kur melnraksts tiek aizturēts apstiprināšanai, jo tā autore nevar apstiprināt savas izmaiņas.

Izvēle starp abiem veidiem

Ja uzdevums ir "katru reizi pateikt šo vienādi", tā ir Skills Engine prasme. Ja uzdevums ir "palaist manu kodu un sniegt man tā atbildi", tā ir manifesta prasme. Lielākā daļa reālā darba galu galā ietver abas: Harrow piestātņu kopsavilkums ir Skills Engine prasme, kuras rīki nāk no spraudņa, un paši spraudņa rīki ir deklarēti tā manifestā. Skills Engine prasmi ir lētāk mainīt, kas ir labs iemesls saglabāt formulējumu un spriedumus tur, bet aritmētiku — spraudnī.

Izmaksas ir reālas abos gadījumos. Skills Engine prasme nav pabeigta tad, kad SKILL.md ir labi lasāms; tā ir pabeigta tad, kad tās testa gadījumi ir sekmīgi, tās testa izpilde sakrīt ar to, ko nolēma cilvēki, un to ir apstiprinājis kāds cits, nevis jūs.Ieplānojiet nedēļu prasmei, kas veic ierakstīšanu, no kuras lielāko daļu aizņems kanārijputniņa režīms.