Verżjoni 1.0.0-alpha.1l-aħħar
Kapitlu 2.20
Ħiliet
Kif tikteb, tittestja u tippubblika ħila ta' Skills Engine, fejn tidher ladarba tkun live, u kif il-ħiliet tal-manifest fi plugin huma differenti. Jinkludi sommarju maħdum tal-allokazzjoni tal-irmiġġi għal Harrow Port Authority.
Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

Tomás Reilly, l-inġinier tal-pjattaforma f'Harrow Port Authority, staqsieni x-xahar li għadda għaliex il-pjanifikaturi tal-irmiġġ tiegħu kienu jirċievu tweġiba differenti kull darba li jistaqsu lill-assistent "min se jkun fuq liema rmiġġ għada, u x'ċaqlaq?". It-tweġiba kienet li ħadd ma kien qal lill-assistent kif tidher tweġiba tajba. Ħila ta' Skills Engine irranġat din il-kwistjoni f'wara nofsinhar wieħed: il-pjanifikaturi issa jirċievu l-istess sommarju fi tliet partijiet kull darba, bit-tabella tal-irmiġġ l-ewwel, il-bidliet mill-aħħar pjan taħtha, u l-kunflitti fl-aħħar. Dan il-kapitlu jispjega dik il-ħila mill-bidu sal-aħħar, u mbagħad ikopri t-tip l-ieħor ta' ħila, dik li tinsab fil-manifest ta' plugin.
Żewġ tipi ta' ħiliet
Nexus juża l-kelma "ħila" (skill) għal żewġ affarijiet differenti, u dawn jinbnew b'mod differenti.
| Ħila tal-Iskills Engine | Ħila tal-manifest | |
|---|---|---|
| X'inhu | Pakkett SKILL.md fil-librerija tal-ħiliet |
Ringiela bit-tip iddefinit fl-array skills[] ta' plugin |
| Min jiktibha | Kull min għandu d-dritt, fil-kreatur jew fl-editur tiegħu stess | Żviluppatur, ġewwa plugin |
| X'fiha | Istruzzjonijiet, l-għodod li tista' ssejjaħ, fajls u skripts fakultattivi | Skema ta' input u output, livell (tier), u l-oqsma li dak il-livell jeħtieġ |
| Kif tasal fil-pjattaforma | Ivvalidata, imtellgħa u ppubblikata fuq is-Skills Engine | Ikkompilata mill-manifest u ssinkronizzata mar-reġistru tal-ħiliet |
| X'iħaddimha | L-assistent, l-aġenti, il-flussi tax-xogħol, il-buttuni tal-IA (intelliġenza artifiċjali), Claude Code | It-tqassim ta' UNO (il-magna tal-fluss tax-xogħol) |
| Użu tipiku | "Agħmel sommarju tal-pjan tal-irmiġġ bl-istess mod kull darba" | "Ħaddem il-propagatur tal-orbita tagħna fuq dan il-passaġġ" |
Il-bqija tal-kapitlu jżommhom separati. Jekk paragrafu jgħid "ħila" waħdu, din tkun ħila ta' Skills Engine.
Parti 1: ħiliet ta' Skills Engine
X'inhi ħila
Ħila hija fowlder. Is-SKILL.md tagħha jgħid għalxiex inhi l-ħila u kif għandu jsir ix-xogħol; maġenbu hemm kwalunkwe fajl li x-xogħol jeħtieġ u kwalunkwe skript li jħaddem. Il-magna tgħabbi ħila fi tliet saffi: l-isem u d-deskrizzjoni dejjem, l-istruzzjonijiet meta kompitu jitlob il-ħila, u l-fajls biss meta pass ikollu bżonnhom. Huwa għalhekk li installazzjoni tista' żżomm mitejn ħila u ma tħallas kważi xejn għalihom sakemm tintuża waħda.
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
L-isem tad-direttorju jrid ikun ugwali għas-slug tal-ħila. Nuqqas ta' qbil joħloq twissija ta' validazzjoni, u ta' min jirranġah, għaliex is-slug huwa l-mod kif il-librerija tqabbel dak li jittella' ma' ħila eżistenti.
Frontmatter ta' SKILL.md
Il-frontmatter huwa YAML bejn żewġ linji --- fin-naħa ta' fuq tal-fajl. Il-format jeħtieġ tliet oqsma. Il-validazzjoni nnifisha timblokka biss fuq ftit affarijiet: isem jew deskrizzjoni nieqsa, u slug jew tip ta' xogħol li diġà huma meħuda. Kull ħaġa oħra tirrappurtaha bħala twissija.
| Qasam | Tip | Meħtieġ | X'fih |
|---|---|---|---|
name |
string | iva | L-identifikatur uniku, f'kebab-case |
description |
string | iva | X'tagħmel il-ħila, sa massimu ta' 500 karattru. Il-librerija u l-matcher jaqrawha, għalhekk iktibha għal qarrej li qed jiddeċiedi jekk din hijiex il-ħila t-tajba |
allowed-tools |
string jew lista | iva | L-għodod li l-ħila tista' ssejjaħ. Tista' biss iddejjaq il-lista ta' permessi (allow-list) ta' kull min iħaddimha |
triggers |
lista | le | Kmandi bis-slash li jinvokaw il-ħila direttament |
capabilities |
lista | le | Kapaċitajiet strutturati, kull waħda b'name, description u b'mod fakultattiv input_schema, output_schema u examples |
version |
string | le | Verżjoni semantika; 1.0.0 meta titħalla barra |
visibility |
string | le | private, team jew public |
status |
string | le | draft, testing jew published |
Żomm l-istruzzjonijiet taħt madwar 5,000 token. Kun speċifiku u agħti eżempji. Kull ħila għandha tagħmel xogħol wieħed tajjeb; jekk issib ruħek tikteb "u wkoll", probabbilment għandek żewġ ħiliet.
skill.yaml
skill.yaml iġorr dak li l-magna teħtieġ għall-iskoperta u għal-librerija, sabiex is-SKILL.md jibqa' jinqara faċilment. L-oqsma li l-magna taqra jinkludu name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools u capabilities. Kapaċità tista' ġġorr query_patterns, il-frażijiet li l-matcher għandu jibgħat lilha. Hemm ukoll ħjiel għall-ibbaġitjar tal-magna stess: complexity, estimated_tokens u required_services.
scripts/
Kull ħaġa taħt scripts/ tinġabar kelma b'kelma mal-ħila bħala komponent. Skript jitħaddem, qatt ma jinqara fil-kuntest tal-mudell, u jitħaddem f'sandbox. Uża wieħed meta pass ikun aritmetika jew parsing li mudell m'għandux jagħmel f'moħħu.
Viżibilità u status
Il-viżibilità tgħid min jista' jsib il-ħila: private huwa int, team huwa t-tim tiegħek, u public huwa kulħadd fl-organizzazzjoni li l-librerija sservi. Fil-console l-istess għażla tinqara "Jien biss", tim bħal "Uffiċċju tad-dwana", jew l-organizzazzjoni kollha, u ħila tista' wkoll tiġi kondiviża f'pakkett ta' dominju permezz tar-reviżjoni ta' dak il-pakkett stess.
L-istatus jgħid fejn tinsab il-ħila fiċ-ċiklu tal-ħajja tagħha.
| Stat | Tifsira |
|---|---|
draft |
Xogħol li għadu għaddej; ma jistax jinstab |
testing |
Qed tiġi vvalidata, b'aċċess limitat |
published |
Disponibbli għall-użu ġenerali |
deprecated |
Sostitwita; fi triqitha biex tiġi rtirata |
Ladarba verżjoni tiġi ppubblikata qatt ma tinbidel. Fil-console, "live", "canary" u "shadow" huma tikketti fuq il-verżjonijiet, u meta taqleb lura għal verżjoni preċedenti tkun qed iċċaqlaq tikketta. Eżekuzzjonijiet li jkunu għaddejjin jispiċċaw fuq il-verżjoni li bdew biha.
SKILL.md, il-fajls maġenbu u meta jitgħabba kull wieħed, u l-għodod li l-ħila tista' ssejjaħ. Ħila ta' verifika ma tiġi offruta l-ebda għodda li tikteb, u ħila tista' biss iddejjaq il-lista ta' permessi ta' min iħaddimha.Minn fowlder għal ħila attiva
Ħames skripts npm fir-repożitorju tas-Skills Engine jieħdu ħila mill-editur tiegħek sal-librerija u jippruvaw li waslet.
| Kmand | X'jagħmel |
|---|---|
npm run skill:validate skills/<slug> |
Janalizza (lints) il-pakkett. Il-pubblikazzjoni teħtieġ żero żbalji |
npm run skill:upload skills/<slug> |
Jivvalida u jippubblika f'pass wieħed; idempotenti |
npm run skill:upload skills/<slug> --dry-run |
Jivvalida u jistampa l-pjan mingħajr ma jikteb xejn |
npm run skill:publish -- --dry-run skills/<slug> |
Il-pubblikazzjoni ta' livell aktar baxx wara t-tlugħ, l-istess pipeline |
npm run skill:reconcile |
Iqabbel il-ħiliet fir-repożitorju tiegħek ma' dak li jżommu l-librerija u r-reġistru tal-ħiliet |
npm run skill:live:verify |
Jivverifika ħila ppubblikata mill-bidu sal-aħħar fuq l-installazzjoni li tkun qed taħdem |
Il-pubblikazzjoni tikteb żewġ entrati, u t-tnejn huma importanti. Waħda hija l-ħila nnifisha, bil-korp SKILL.md tagħha, il-kapaċitajiet, il-komponenti u r-rekord tal-kwalità; il-librerija, l-iskoperta u t-tqabbil jaqraw dik l-entrata. L-oħra hija l-entrata tar-reġistru li l-magna tal-fluss tax-xogħol tirriżolvi tqassim (dispatch) magħha. Ħila li waslet biss fir-reġistru taħdem, iżda tibqa' inviżibbli fil-librerija sakemm ittellagħha.
Il-pubblikazzjoni hija idempotenti. Ħila mhux mibdula ma tagħmel ebda operazzjoni (no-op), u ħila eżistenti titqabbel permezz tas-slug tagħha u tiġi aġġornata fil-post, qatt ma tinħoloq mill-ġdid. Tella' l-istess bytes bħala verżjoni li hija diġà ppubblikata u tieħu dik il-verżjoni lura b'CONTENT_HASH_ALREADY_PUBLISHED, mhux duplikat.
skill:reconcile iqabbel il-ħiliet tar-repożitorju tiegħek mal-librerija, ir-reġistru u l-inventarju tal-magna tal-fluss tax-xogħol, u jirrapporta kwalunkwe ħaġa li teżisti f'post wieħed u mhux f'ieħor. skill:live:verify imur lil hinn fuq l-installazzjoni li tkun qed taħdem: iż-żewġ entrati jeżistu u jippuntaw lejn xulxin bl-istess hash tal-kontenut, tqassim ta' prova (dry-run) tat-tip ta' xogħol tal-ħila jiġi aċċettat, il-ħila tidher fil-lista u fid-dettall tal-librerija, tista' tiġi invokata, u r-rekord tal-awditjar jorbot il-pubblikazzjoni, it-tqassim u l-eżekuzzjoni flimkien permezz tas-slug u l-id tat-talba.
Minn workstation, it-tlugħ jilħaq is-servizz tal-għarfien tal-installazzjoni, nexus-graphrag, permezz ta' port-forward, u jeħtieġ iċ-ċavetta tas-servizz tas-Skills Engine fl-ambjent. Għabbi ċ-ċavetta mingħajr ma turi l-eku tagħha:
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Ġewwa l-cluster, f'xogħol ta' pipeline, l-indirizz predefinit jirriżolvi waħdu u GRAPHRAG_URL mhuwiex meħtieġ. Ikseb iċ-ċavetta permezz tal-proċess tas-sigrieti tal-organizzazzjoni tiegħek stess. Qatt ma tidħol fir-repożitorju, fl-istorja tax-shell tiegħek jew fl-output ta' kmand.
Testijiet, approvazzjoni u tnedija (going live)
Ħila tasal fil-librerija bħala abbozz, u l-kreatur iżommha hemm sakemm jgħaddu tliet affarijiet.
| Kontroll | X'jagħmel |
|---|---|
| Każijiet ta' test | Kull każ irid jgħaddi qabel ma l-ħila tkun tista' tmur għall-approvazzjoni. Każ jista' jitneħħa biss b'raġuni, li jarawha l-approvaturi. |
| Prova (dry run) f'shadow | Il-ħila titħaddem fuq xogħol tal-passat, fejn ħadd ma jara t-tweġibiet, u r-riżultati tagħha jitqabblu ma' dak li ddeċidiet persuna dak iż-żmien. |
| Reviżjoni għamja minn mudell minn familja oħra | Tfittex għal verifika maqbuża, sors ivvintat u istruzzjoni mħawla li l-ħila segwiet meta ma kellhiex tagħmel dan. |
Imbagħad l-approvazzjoni. Ħila li żżid għodda li tikteb tinżamm sakemm żewġ persuni japprovawha bil-passkeys tagħhom, u l-persuna li pproponietha ma tistax tkun waħda minnhom (PUBLISH_NEEDS_APPROVAL). Imbagħad issir attiva f'shadow, imbagħad f'canary għal unità waħda wara gradi msemmija, imbagħad għal kulħadd. Jekk grada ta' canary ma tintlaħaqx, il-canary jwaqqaf lilu nnifsu u kulħadd jibqa' fuq il-verżjoni preċedenti; li tintbagħat lil kulħadd kmieni jeħtieġ raġuni u t-tieni approvatur (CANARY_GATE_NOT_MET).
Fuq Community il-kreatur, il-librerija, il-verżjonijiet u t-testijiet huma kollha hemm, u s-sid jippubblika waħdu ladarba jgħaddu t-testijiet. Canary, l-approvazzjoni minn żewġ persuni, is-sinkronizzazzjoni tal-plugins u l-għaqda tad-duplikati jiġu ma' Enterprise.
Fejn jidhru l-ħiliet
L-istess ħila ppubblikata tilħaq lin-nies f'ħames postijiet.
- L-assistent iqabbel talba ma' ħila permezz tad-deskrizzjoni, it-triggers u l-mudelli tat-tfittxija tagħha, u jsegwi l-istruzzjonijiet tal-ħila.
- L-aġenti u l-flussi tax-xogħol isejħu l-ħiliet bħala passi. Pass ta' fluss tax-xogħol isemmi l-ħila; l-eżekuzzjoni tirreġistra liema verżjoni użat.
- Il-buttuni tal-IA fuq l-iskrins kull waħda tħaddem ħila waħda. Amministratur jista' jiftaħ "Dwar din il-buttuna" biex jara l-ħila li tħaddem buttuna, x'taqra u min biddilha l-aħħar, u jista' jitfi l-buttuna mingħajr ma jmiss il-ħila.
- L-IDE (ambjent ta' żvilupp integrat) tiegħek u Claude Code jilħqu l-librerija permezz tal-Workbench u tlettax-il għodda MCP (Model Context Protocol):
list_skills,get_skill,match_prompt,discover_skills,invoke_skill,record_execution,create_skill,import_skill,get_generation_jobusync_skills_localfosthom. Kull sejħa titħaddem bħala l-persuna li bdietha, ġewwa l-lista ta' permessi tagħha. - Il-librerija tal-ħiliet innifisha, fejn in-nies jibbrawżjaw, iħaddmu u jissuġġerixxu bidliet fil-ħiliet, u l-amministraturi jaraw is-sid, l-utenti, l-eżekuzzjonijiet u n-nefqa ta' kull ħila.
Ikun xi jkun dak li jħaddem ħila, il-ħila ma tistax twessa' dak li jista' jagħmel min iħaddimha: issejjaħ biss għodod ġewwa l-lista ta' permessi ta' min iħaddimha u taqra biss dak li dik il-persuna tista' tiftaħ (SKILL_CANNOT_WIDEN_TOOLS). Eżekuzzjoni mingħajr rotta ta' mudell tiġi rrifjutata minflok ma tiġi mbassra (SKILLS_ENGINE_BINDING_MISSING); id-dispatcher jagħżel ir-rotta, mill-konfigurazzjoni tal-mudell tal-organizzazzjoni stess.
Eżempju maħdum: sommarju tal-allokazzjoni tal-irmiġġ għal Harrow
Il-pjanifikaturi ta' Harrow diġà kellhom żewġ għodod li jinqraw biss (read-only) fuq il-lista ta' permessi tagħhom mill-plugin tal-ippjanar tal-irmiġġ ta' Harrow stess: berth-plan.read jirritorna l-pjan għal data, u vessel-call.read jirritorna waqfa ta' bastiment bit-tieqa tal-wasla u t-tul tiegħu. Il-ħila ma teħtieġ xejn ieħor. Qatt ma tikteb, għalhekk qatt ma teħtieġ żewġ approvaturi.
---
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.Is-skill.yaml maġenbha jagħti lil-librerija isem li jidher, kategorija u l-frażijiet li l-matcher għandu jidderieġi hawn:
# 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 *"Imbagħad il-kmandi, mir-root tar-repożitorju:
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 żied sitt każijiet ta' test fil-kreatur: ġurnata ordinarja, ġurnata b'wasla tard li ċaqilqet żewġ waqfiet, ġurnata b'kunflitt ġenwin, data li għad m'għandhiex pjan, bastiment twil wisq għall-irmiġġ tiegħu, u talba li ppruvat iġġiegħel lill-ħila tipproponi rmiġġ ġdid (m'għandhiex tagħmel dan; m'għandha l-ebda għodda li tikteb). Il-prova (dry run) reġgħet ħaddmet għoxrin pjan tal-passat f'shadow. Ladarba l-każijiet għaddew, reviżur fl-uffiċċju tal-ippjanar approvaha, u saret attiva għat-tim tal-ippjanar. L-assistent issa jwieġeb il-mistoqsija bl-istess forma kull darba, u l-buttuna tal-IA tal-pjanifikaturi fuq il-paġna tal-pjan tal-irmiġġ tħaddem l-istess ħila.
Parti 2: ħiliet tal-manifest
Ħila tal-manifest hija l-unità ta' komputazzjoni li jippubblika plugin. Hija ddikjarata fis-skills[] tal-manifest, ivvalidata mill-SDK (software development kit) meta tħaddem create-nexus-plugin validate, ikkompilata fil-korp tar-reġistru minn compileRegistry, u ssinkronizzata mar-reġistru tal-ħiliet. Qatt ma tikteb SQL tar-reġistru bl-idejn, sabiex ir-ringiela li tqassam il-pjattaforma u d-deskrittur li ddikjarajt ma jkunux jistgħu jitbiegħdu minn xulxin.
Kull ħila tal-manifest teħtieġ id, displayName, description, tier, classification, inputSchema u outputSchema. Iddikjara timeoutMs ukoll: huwa numru sħiħ (integer) minn 1,000 sa 21,600,000 (minn sekonda sa sitt sigħat), u valur barra minn dik il-medda jiġi rrifjutat b'TIMEOUT_OUT_OF_BOUNDS. dataResidency huwa any, eu jew us, u any huwa l-valur predefinit.
Is-id huwa lower_snake, u ċ-ċavetta tat-tqassim tar-reġistru hija t-tip ta' xogħol bin-namespace <plugin name>.<skill id>, sabiex żewġ plugins ikunu jistgħu t-tnejn ikollhom ħila summarise mingħajr ma jaħbtu. Hawnhekk hawn il-ħila l-waħda tal-mudell, imqassra:
{
"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
}Il-ħames livelli (tiers)
Il-livell mhuwiex tikketta. Kull livell għandu oqsma tiegħu stess, u qasam li jappartjeni għal livell ieħor jiġi rrifjutat b'FIELD_NOT_FOR_TIER minflok ma jitwaqqa' bil-kwiet.
| Livell | Jeħtieġ | Jilħaq mudell | Min iħaddmu |
|---|---|---|---|
host_callback |
hostCallback: is-Service tiegħek, il-port tiegħu, mogħdija (path) u ż-żewġ limiti ta' bytes |
Le | Il-pjattaforma tagħmel POST tal-input lis-Service tiegħek stess, ġewwa n-namespace tiegħek |
plugin_queue |
queueName, miktub <plugin name>.<name> |
Le | Il-worker tiegħek, li jiġbed mill-kju tiegħek |
tool_using |
systemPrompt u tools[]; fiduċja core jew verified |
Iva | Il-pjattaforma, permezz tal-AI Provider Router; kull sejħa ta' għodda titħaddem permezz ta' eżekutur fil-lista ta' permessi |
llm_only |
systemPrompt; fiduċja core jew verified |
Iva | Il-pjattaforma, sejħa waħda permezz tal-AI Provider Router |
map |
map.perItemJobType, li jsemmi ħila oħra tal-istess manifest li mhijiex mappa |
Biss permezz tal-mira tiegħu | Il-pjattaforma tħaddem il-mira darba għal kull element u tiġbor ir-riżultati |
L-ebda wieħed mil-livelli tal-mudell ma jsemmi fornitur jew mudell. Ir-router jagħżel it-tnejn mill-pool stess tal-organizzazzjoni li tkun qed tagħmel it-tqassim. Għodda f'ħila tool_using issemmi wieħed minn sitt eżekuturi: standing_service_call (is-Service tiegħek stess), graphrag, graphrag_query, graphrag_search, h3 jew web_search. Kwalunkwe ieħor jiġi rrifjutat b'EXECUTOR_NOT_PERMITTED. It-tliet eżekuturi tal-graff tal-għarfien (knowledge-graph) jaċċettaw biss l-ismijiet tal-għodod graphrag_query u graphrag_search, għaliex l-eżekutur iħaddem kwalunkwe operazzjoni li l-għodda tkun imsemmija għaliha.
Jeżistu żewġ livelli fir-reġistru li plugin ma jistax jiddikjara: ktajjen u ħiliet li jaħdmu waħedhom jinkitbu mill-pjattaforma biss. Sinkronizzazzjoni li ssemmi wieħed minnhom tiġi rrifjutata kollha kemm hi.
Liema livell għandek tuża
host_callbackmeta x-xogħol ikun funzjoni tal-input li l-kodiċi tiegħek stess jikkalkula: punteġġ, kalkolu, tfittxija fl-iskema tiegħek stess. Huwa l-aktar sempliċi biex jiġi ttestjat u l-valur predefinit tal-mudell. Ipproteġi r-rotta tal-callback: mogħdija f'manifest mhijiex sigriet, u r-rotta trid tivverifika s-sejħa tal-pjattaforma u tieħu l-organizzazzjoni minnha, qatt mill-korp. Iddikjarahaauth: internalu mmuntarequireService(Fastify) jewserviceMiddleware(Express) fuqha. Il-protezzjoni tirrifjuta token maħluq għal xi ħadd ieħor. Wieġeb malajr, u agħmel it-tieni kunsinna tal-istess xogħol bla ħsara.plugin_queuegħal xogħol itwal li persuna tistenna għalih, fejn il-worker tiegħek ikollu f'idejh iċ-ċiklu tal-ħajja. Il-worker irid iċaqlaq l-eżekuzzjoni għalrunningmeta jibda u għal status terminali meta jispiċċa; worker li jippubblika biss ir-riżultat tiegħu jħalli l-eżekuzzjoni turiqueuedgħal dejjem.llm_onlymeta sejħa waħda ta' mudell bi prompt tas-sistema fiss tagħmel ix-xogħol, u l-plugin tiegħek ikuncorejewverified.tool_usingmeta l-mudell ikollu bżonn isejjaħ għodod f'ħolqa (loop), għal darb'oħra biss f'corejewverified.mapmeta trid li l-pjattaforma tifrex (fan out) waħda mill-ħiliet l-oħra tiegħek fuq lista.
Il-ħila tiegħi tal-propagazzjoni tal-orbita f'Corrán Orbital hija host_callback. Il-plugin tagħna huwa community, għalhekk il-livelli tal-mudell qatt ma kienu għażla, u ma nħossx in-nuqqas tagħhom: propagatur li jagħti tweġiba differenti nhar ta' Tlieta jkun agħar minn inutli.
Approvazzjoni qabel kull eżekuzzjoni
Ħila tal-manifest li qatt ma trid titħaddem fuq il-kelma ta' magna biss tiddikjara dan:
"approval": { "required": true, "reason": "Re-planning a pass needs the flight dynamics lead." }required huwa dejjem true; ħila li ma teħtieġ l-ebda approvazzjoni tħalli l-blokk barra. reason huwa dak li jara l-approvatur, minn karattru wieħed (1) sa 500 karattru wara t-tirqim (trimming), u kwalunkwe forma oħra tiġi rrifjutata b'APPROVAL_INVALID. Tqassim tal-ħila mbagħad jinżamm: it-tqassim iwieġeb 202 b'status: "awaiting_approval" u waitpointId, u l-approvazzjoni ta' persuna msemmija biss terħih, darba. Tqassim ta' lott (batch), mappa jew katina ta' ħila miżmuma jiġi rrifjutat b'SKILL_APPROVAL_NOT_HOLDABLE, għaliex tixrid (fan-out) ma jistax iżomm l-elementi tiegħu. Uri t-tweġiba miżmuma u ħalli l-approvatur jiddeċiedi; tqassamx biex imbagħad titlob il-kunsens.
Sinkronizzazzjoni mar-reġistru
Kull sinkronizzazzjoni hija dikjarattiva u vverifikata kollha kemm hi. Ibgħat is-sett sħiħ ta' ħiliet kull darba: ħila li tħalli barra tiġi diżattivata, u l-istorja tal-eżekuzzjoni tagħha tibqa'. Ħila waħda ħażina tirrifjuta s-sinkronizzazzjoni kollha b'SYNC_CONTRACT_VIOLATION, b'kull ksur elenkat flimkien u xejn miktub, sabiex plugin qatt ma jkun nofsu aġġornat. Kapitlu 2.22, Ir-runtime tal-plugin, ikopri s-sejħa tas-sinkronizzazzjoni u kif il-pjattaforma tkun taf liema plugin qed isejjaħ.
L-għażla bejn iż-żewġ tipi
Jekk ix-xogħol huwa "għid dan bl-istess mod kull darba", huwa ħila ta' Skills Engine. Jekk ix-xogħol huwa "ħaddem il-kodiċi tiegħi u agħtini t-tweġiba tiegħu", huwa ħila tal-manifest. Il-biċċa l-kbira tax-xogħol reali jispiċċa jkun it-tnejn: is-sommarju tal-irmiġġ ta' Harrow huwa ħila ta' Skills Engine li l-għodod tagħha jiġu minn plugin, u l-għodod tal-plugin huma stess iddikjarati fil-manifest tiegħu. Il-ħila ta' Skills Engine hija l-orħos mit-tnejn biex tinbidel, li hija raġuni tajba biex iżżomm il-kliem u l-ġudizzju hemmhekk u l-aritmetika fil-plugin.
L-ispiża hija reali fiż-żewġ każijiet. Ħila ta' Skills Engine ma tkunx lesta meta s-SKILL.md jinqara tajjeb; tkun lesta meta l-każijiet tagħha jgħaddu, il-prova (dry run) tagħha taqbel ma' dak li ddeċidew in-nies, u xi ħadd li mhuwiex int ikun approvaha. Ibbaġitja ġimgħa għal ħila li tikteb, il-biċċa l-kbira tagħha għall-canary.



