Sürüm 1.0.0-alpha.1en son
Bölüm 2.20
Beceriler
Bir Skills Engine becerisinin nasıl yazılacağı, test edileceği ve yayınlanacağı, yayına girdiğinde nerede göründüğü ve bir eklentideki bildirim (manifest) becerilerinin nasıl farklılık gösterdiği. Harrow Port Authority için uygulamalı bir rıhtım tahsisi özetini içerir.
Bu sayfa, İngilizce aslından YZ tarafından çevrilmiştir. Anlaşılmayan bir yer olursa İngilizce sayfa esas alınır. Bu sayfayı İngilizce okuyun

Harrow Port Authority'deki platform mühendisi Tomás Reilly, geçen ay bana rıhtım planlamacılarının asistana "yarın hangi rıhtımda kim var ve ne değişti?" diye sordukları her seferinde neden farklı bir yanıt aldıklarını sordu. Bunun yanıtı, asistana iyi bir yanıtın nasıl göründüğünü kimsenin söylememiş olmasıydı. Bir Skills Engine becerisi bu sorunu bir öğleden sonrada çözdü: planlamacılar artık her seferinde ilk sırada rıhtım tablosunun, altında son plandan bu yana yapılan değişikliklerin ve en sonda çakışmaların yer aldığı aynı üç bölümlü özeti alıyor. Bu bölüm, söz konusu beceriyi uçtan uca ele almakta ve ardından diğer beceri türünü, yani bir eklentinin manifestosunda yer alan beceriyi incelemektedir.
İki tür beceri
Nexus, "beceri" kelimesini iki farklı şey için kullanır ve bunlar farklı şekilde oluşturulur.
| Skills Engine becerisi | Manifesto becerisi | |
|---|---|---|
| Tanımı | Beceriler kitaplığında bir SKILL.md paketi |
Bir eklentinin skills[] dizisinde tiplendirilmiş bir satır |
| Kim yazar | Yetkisi olan herkes, oluşturucuda veya kendi düzenleyicisinde | Bir geliştirici, bir eklentinin içinde |
| Ne içerir | Talimatlar, çağırabileceği araçlar, isteğe bağlı dosyalar ve betikler | Bir girdi ve çıktı şeması, bir katman ve bu katmanın ihtiyaç duyduğu alanlar |
| Platforma nasıl ulaşır | Doğrulanır, yüklenir ve Skills Engine'de yayınlanır | Manifestodan derlenir ve beceri kayıt defteriyle senkronize edilir |
| Ne çalıştırır | Asistan, aracılar, iş akışları, YZ (yapay zeka) düğmeleri, Claude Code | UNO (iş akışı motoru) sevki |
| Tipik kullanım | "Rıhtım planını her seferinde aynı şekilde özetle" | "Bu geçişte yörünge yayıcımızı çalıştır" |
Bölümün geri kalanı bunları birbirinden ayrı tutar. Bir paragrafta tek başına "beceri" deniyorsa bu bir Skills Engine becerisidir.
1. Bölüm: Skills Engine becerileri
Beceri nedir
Bir beceri bir klasördür. İçindeki SKILL.md dosyası becerinin ne işe yaradığını ve işin nasıl yapılacağını belirtir; bunun yanında işin ihtiyaç duyduğu dosyalar ve çalıştırdığı betikler yer alır. Motor bir beceriyi üç katmanda yükler: ad ve açıklama her zaman, bir görev beceriyi çağırdığında talimatlar ve yalnızca bir adım ihtiyaç duyduğunda dosyalar yüklenir. Bu nedenle bir kurulum iki yüz beceri barındırabilir ve biri kullanılana kadar bunlar için neredeyse hiçbir maliyet ödemez.
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
Dizin adı, becerinin kısa adıyla (slug) aynı olmalıdır. Uyuşmazlık bir doğrulama uyarısıdır ve düzeltilmeye değerdir; çünkü kitaplık bir yüklemeyi mevcut bir beceriyle kısa adı üzerinden eşleştirir.
SKILL.md ön bilgisi
Ön bilgi (frontmatter), dosyanın üst kısmındaki iki --- satırı arasında yer alan YAML kodudur. Biçim üç alanı zorunlu kılar. Doğrulamanın kendisi yalnızca birkaç durumda işlemi engeller: eksik bir ad veya açıklama ya da zaten alınmış bir kısa ad veya iş türü. Diğer her şeyi uyarı olarak bildirir.
| Alan | Tür | Zorunlu | Ne barındırır |
|---|---|---|---|
name |
dize | evet | kebab-case biçiminde benzersiz tanımlayıcı |
description |
dize | evet | Becerinin ne yaptığı, en fazla 500 karakter. Kitaplık ve eşleştirici bunu okur; bu nedenle bunun doğru beceri olup olmadığına karar veren bir okuyucu için yazın |
allowed-tools |
dize veya liste | evet | Becerinin çağırabileceği araçlar. Yalnızca onu çalıştıran kişinin izin listesini daraltabilir |
triggers |
liste | hayır | Beceriyi doğrudan çağıran eğik çizgi komutları |
capabilities |
liste | hayır | Her biri bir name, bir description ve isteğe bağlı olarak input_schema, output_schema ve examples içeren yapılandırılmış yetenekler |
version |
dize | hayır | Anlamsal bir sürüm; belirtilmediğinde 1.0.0 |
visibility |
dize | hayır | private, team veya public |
status |
dize | hayır | draft, testing veya published |
Talimatları yaklaşık 5.000 belirtecin (token) altında tutun. Açık olun ve örnekler verin. Her beceri bir işi iyi yapmalıdır; kendinizi "ve ayrıca" yazarken bulursanız muhtemelen elinizde iki beceri vardır.
skill.yaml
skill.yaml, motorun keşif ve kitaplık için ihtiyaç duyduğu bilgileri taşır, böylece SKILL.md okunabilir kalır. Motorun okuduğu alanlar arasında name, display_name, description, version, status, visibility, triggers, aliases, category, tags, allowed_tools ve capabilities bulunur. Bir yetenek, eşleştiricinin kendisine göndermesi gereken ifadeler olan query_patterns alanını taşıyabilir. Ayrıca motorun kendi bütçelemesi için ipuçları da vardır: complexity, estimated_tokens ve required_services.
scripts/
scripts/ altındaki her şey, beceriyle birlikte bir bileşen olarak birebir paketlenir. Bir betik çalıştırılır, asla modelin bağlamına okunmaz ve bir korumalı alanda (sandbox) çalışır. Bir adım, modelin kafasından yapmaması gereken aritmetik veya ayrıştırma işlemleri içerdiğinde betik kullanın.
Görünürlük ve durum
Görünürlük, beceriyi kimlerin bulabileceğini belirtir: private sizsiniz, team ekibinizdir ve public kitaplığın hizmet verdiği kuruluştaki herkestir. Konsolda aynı seçim "Yalnızca ben", "Gümrük masası" gibi bir ekip veya tüm kuruluş olarak görünür ve bir beceri ayrıca ilgili paketin kendi incelemesi aracılığıyla bir alan paketinde paylaşılabilir.
Durum, becerinin yaşam döngüsünün neresinde olduğunu belirtir.
| Durum | Anlamı |
|---|---|
draft |
Devam eden çalışma; keşfedilemez |
testing |
Doğrulanıyor, sınırlı erişimli |
published |
Genel kullanıma açık |
deprecated |
Yerine yenisi geçmiş; kullanımdan kaldırılma aşamasında |
Bir sürüm yayınlandıktan sonra asla değişmez. Konsolda "canlı", "kanarya" ve "gölge" sürümler üzerindeki etiketlerdir ve daha önceki bir sürüme geri dönmek bir etiketin yerini değiştirir. Devam eden çalıştırmalar başladıkları sürümde tamamlanır.
SKILL.md dosyasını, yanındaki dosyaları ve her birinin ne zaman yükleneceğini ve becerinin çağırabileceği araçları gösterir. Kontrol amaçlı bir beceriye yazma işlemi yapan hiçbir araç sunulmaz ve bir beceri yalnızca çalıştırıcının izin listesini daraltabilir.Bir klasörden canlı bir beceriye
Skills Engine deposundaki beş npm betiği, bir beceriyi düzenleyicinizden kitaplığa taşır ve oraya ulaştığını kanıtlar.
| Komut | Yaptığı iş |
|---|---|
npm run skill:validate skills/<slug> |
Paketi denetler (lint). Yayınlama için sıfır hata gerekir |
npm run skill:upload skills/<slug> |
Tek adımda doğrular ve yayınlar; eşkuvvetlidir (idempotent) |
npm run skill:upload skills/<slug> --dry-run |
Hiçbir şey yazmadan doğrular ve planı yazdırır |
npm run skill:publish -- --dry-run skills/<slug> |
Yüklemenin arkasındaki daha düşük seviyeli yayınlama işlemi, aynı iş hattı |
npm run skill:reconcile |
Deponuzdaki becerileri kitaplık ve beceri kayıt defterindekilerle karşılaştırır |
npm run skill:live:verify |
Yayınlanmış bir beceriyi çalışan kurulum üzerinde uçtan uca kontrol eder |
Yayınlama işlemi iki kayıt yazar ve ikisi de önemlidir. Biri SKILL.md gövdesi, yetenekleri, bileşenleri ve kalite kaydıyla becerinin kendisidir; kitaplık, keşif ve eşleştirme bunu okur. Diğeri ise iş akışı motorunun bir sevki çözümlemek için başvurduğu kayıt defteri girdisidir. Yalnızca kayıt defterine ulaşmış bir beceri çalışır ancak siz onu yükleyene kadar kitaplıkta görünmez.
Yayınlama eşkuvvetlidir (idempotent). Değişmemiş bir beceri işlem yapmaz (no-op) ve mevcut bir beceri kısa adıyla eşleştirilerek yerinde güncellenir, asla yeniden oluşturulmaz. Zaten yayınlanmış bir sürümle aynı baytları yüklerseniz, bir kopya değil CONTENT_HASH_ALREADY_PUBLISHED ile o sürümü geri alırsınız.
skill:reconcile, deponuzdaki becerileri kitaplık, kayıt defteri ve iş akışı motorunun envanteriyle karşılaştırır ve bir yerde var olup diğerinde olmayan her şeyi bildirir. skill:live:verify, çalışan kurulumda daha ileri gider: her iki kayıt da mevcuttur ve aynı içerik karmasıyla (hash) birbirini işaret eder, becerinin iş türünün prova sevki kabul edilir, beceri kitaplık listesinde ve ayrıntılarında görünür, çağrılabilir ve denetim izi yayınlama, sevk ve çalıştırma işlemlerini kısa ad ve istek kimliğiyle birbirine bağlar.
Bir iş istasyonundan yapılan yükleme, bir bağlantı noktası yönlendirmesi (port-forward) aracılığıyla kurulumun bilgi hizmetine, yani nexus-graphrag öğesine ulaşır ve ortamda Skills Engine'in hizmet anahtarına ihtiyaç duyar. Anahtarı ekrana yazdırmadan yükleyin:
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-summaryKüme içinde, bir iş hattı görevinde varsayılan adres kendi kendine çözümlenir ve GRAPHRAG_URL gerekmez. Anahtarı kuruluşunuzun kendi gizli bilgi süreci aracılığıyla alın. Bu anahtar asla depoya, kabuk geçmişinize veya bir komutun çıktısına girmez.
Testler, onay ve canlıya geçiş
Bir beceri kitaplığa taslak olarak ulaşır ve oluşturucu üç aşama geçilene kadar onu orada tutar.
| Kontrol | Yaptığı iş |
|---|---|
| Test senaryoları | Becerinin onaya gidebilmesi için her senaryonun başarılı olması gerekir. Bir senaryo yalnızca onaylayanların görebileceği bir gerekçeyle kaldırılabilir. |
| Gölgede prova çalıştırması | Beceri, yanıtları kimsenin görmediği geçmiş işler üzerinde çalışır ve sonuçları o sırada bir kişinin verdiği kararla karşılaştırılır. |
| Başka bir aileden bir model tarafından yapılan kör inceleme | Atlanmış bir kontrolü, uydurulmuş bir kaynağı ve becerinin uymaması gerekirken uyduğu gizlenmiş bir talimatı arar. |
Ardından onay gelir. Yazma işlemi yapan bir araç ekleyen beceri, iki kişi geçiş anahtarlarıyla (passkey) onaylayana kadar bekletilir ve bunu öneren kişi onaylayanlardan biri olamaz (PUBLISH_NEEDS_APPROVAL). Daha sonra önce gölgede, ardından adlandırılmış kapıların arkasındaki tek bir birim için kanaryada ve son olarak herkes için canlıya geçer. Bir kanarya kapısı karşılanmazsa kanarya kendiliğinden durur ve herkes önceki sürümde kalır; erken aşamada herkese göndermek için bir gerekçe ve ikinci bir onaylayıcı gerekir (CANARY_GATE_NOT_MET).
Community sürümünde oluşturucu, kitaplık, sürümler ve testlerin tümü mevcuttur ve testler geçtikten sonra beceri sahibi tek başına yayınlar. Kanarya, iki kişilik onay, eklenti senkronizasyonu ve kopyaları birleştirme Enterprise sürümüyle birlikte gelir.
Becerilerin göründüğü yerler
Aynı yayınlanmış beceri insanlara beş yerde ulaşır.
- Asistan, bir isteği açıklamasına, tetikleyicilerine ve sorgu kalıplarına göre bir beceriyle eşleştirir ve becerinin talimatlarını izler.
- Aracılar ve iş akışları, becerileri adımlar olarak çağırır. Bir iş akışı adımı beceriyi adlandırır; çalıştırma işlemi hangi sürümü kullandığını kaydeder.
- Ekranlardaki YZ düğmelerinin her biri bir beceri çalıştırır. Bir yönetici, düğmenin çalıştırdığı beceriyi, neyi okuduğunu ve son olarak kimin değiştirdiğini görmek için "Bu düğme hakkında" bölümünü açabilir ve beceriye dokunmadan düğmeyi kapatabilir.
- IDE'niz (tümleşik geliştirme ortamı) ve Claude Code, Workbench ve aralarında
list_skills,get_skill,match_prompt,discover_skills,invoke_skill,record_execution,create_skill,import_skill,get_generation_jobvesync_skills_localaraçlarının da bulunduğu on üç MCP (Model Context Protocol) aracı üzerinden kitaplığa ulaşır. Her çağrı, onu başlatan kişi olarak ve o kişinin izin listesi dahilinde çalışır. - İnsanların becerilere göz attığı, bunları çalıştırdığı ve değişiklik önerdiği, yöneticilerin ise her becerinin sahibini, kullanıcılarını, çalıştırmalarını ve harcamalarını gördüğü beceriler kitaplığının kendisi.
Bir beceriyi ne çalıştırırsa çalıştırsın, beceri çalıştırıcının yapabileceklerini genişletemez: yalnızca çalıştırıcının izin listesi içindeki araçları çağırır ve yalnızca o kişinin açabileceği verileri okur (SKILL_CANNOT_WIDEN_TOOLS). Model rotası olmayan bir çalıştırma tahmin edilmek yerine reddedilir (SKILLS_ENGINE_BINDING_MISSING); sevk edici, kuruluşun kendi model kurulumundan rotayı seçer.
Uygulamalı örnek: Harrow için rıhtım tahsisi özeti
Harrow'un planlamacıları, Harrow'un kendi rıhtım planlama eklentisinden izin listelerinde zaten salt okunur iki araca sahipti: berth-plan.read belirli bir tarihin planını döndürür ve vessel-call.read varış aralığı ve uzunluğuyla birlikte bir gemi uğrağını döndürür. Becerinin başka hiçbir şeye ihtiyacı yoktur. Asla yazma işlemi yapmaz, bu nedenle asla iki onaylayıcıya ihtiyaç duymaz.
---
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.Yanındaki skill.yaml, kitaplığa bir görünen ad, bir kategori ve eşleştiricinin buraya yönlendirmesi gereken ifadeleri verir:
# 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 *"Ardından depo kök dizininden komutlar:
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 oluşturucuya altı test senaryosu ekledi: sıradan bir gün, iki uğrağı kaydıran geç bir varışın olduğu bir gün, gerçek bir çakışmanın olduğu bir gün, henüz planı olmayan bir tarih, rıhtımı için çok uzun olan bir gemi ve becerinin yeni bir rıhtım önermesini sağlamaya çalışan bir istek (bunu yapmamalıdır; yazma işlemi yapan bir aracı yoktur). Prova çalıştırması gölgede geçmişteki yirmi planı yeniden oynattı. Senaryolar geçtikten sonra planlama masasındaki bir incelemeci bunu onayladı ve beceri planlama ekibi için canlıya geçti. Asistan artık soruyu her seferinde aynı biçimde yanıtlıyor ve planlamacıların rıhtım planı sayfasındaki YZ düğmesi aynı beceriyi çalıştırıyor.
2. Bölüm: bildirim (manifest) becerileri
Bir manifesto becerisi, bir eklentinin yayınladığı bilgi işlem birimidir. Manifestonun skills[] alanında bildirilir, create-nexus-plugin validate komutunu çalıştırdığınızda SDK (yazılım geliştirme kiti) tarafından doğrulanır, compileRegistry tarafından kayıt defteri gövdesine derlenir ve beceri kayıt defteriyle senkronize edilir. Kayıt defteri SQL kodunu asla elle yazmazsınız; böylece platformun sevk ettiği satır ile bildirdiğiniz tanımlayıcı birbirinden kopamaz.
Her manifesto becerisi id, displayName, description, tier, classification, inputSchema ve outputSchema alanlarına ihtiyaç duyar. timeoutMs alanını da bildirin: bu, 1.000 ile 21.600.000 (bir saniye ile altı saat) arasında bir tam sayıdır ve bu aralığın dışındaki bir değer TIMEOUT_OUT_OF_BOUNDS ile reddedilir. dataResidency alanı any, eu veya us değerini alır ve varsayılan değer any olarak ayarlanmıştır.
id lower_snake biçimindedir ve kayıt defterinin sevk anahtarı ad alanlı iş türü olan <plugin name>.<skill id> değeridir; böylece iki eklenti çakışma olmadan bir summarise becerisine sahip olabilir. İşte şablonun kısaltılmış tek becerisi:
{
"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
}Beş katman
Katman bir etiket değildir. Her katmanın kendine özgü alanları vardır ve başka bir katmana ait olan bir alan sessizce yok sayılmak yerine FIELD_NOT_FOR_TIER ile reddedilir.
| Katman | Gereksinimler | Bir modele ulaşır | Kim çalıştırır |
|---|---|---|---|
host_callback |
hostCallback: Hizmetiniz (Service), bağlantı noktası, bir yol ve her iki bayt sınırı |
Hayır | Platform, girdiyi kendi ad alanınız içindeki kendi Hizmetinize (Service) POST eder |
plugin_queue |
queueName, <plugin name>.<name> olarak yazılır |
Hayır | Kendi kuyruğunuzdan çeken çalışanınız (worker) |
tool_using |
systemPrompt ve tools[]; güven düzeyi core veya verified |
Evet | Platform, AI Provider Router aracılığıyla; her araç çağrısı izin listesine alınmış bir yürütücü üzerinden çalışır |
llm_only |
systemPrompt; güven düzeyi core veya verified |
Evet | Platform, AI Provider Router aracılığıyla tek bir çağrı |
map |
map.perItemJobType, aynı manifestoda yer alan ve harita (map) olmayan başka bir beceriyi adlandırır |
Yalnızca hedefi aracılığıyla | Platform, hedefi öğe başına bir kez çalıştırır ve sonuçları toplar |
Her iki model katmanı da bir sağlayıcı veya model adı belirtmez. Yönlendirici her ikisini de sevk eden kuruluşun kendi havuzundan seçer. Bir tool_using becerisindeki bir araç altı yürütücüden birini adlandırır: standing_service_call (kendi Hizmetiniz), graphrag, graphrag_query, graphrag_search, h3 veya web_search. Diğer her şey EXECUTOR_NOT_PERMITTED ile reddedilir. Üç bilgi grafiği yürütücüsü yalnızca graphrag_query ve graphrag_search araç adlarını kabul eder, çünkü yürütücü aracın adını taşıdığı işlemi çalıştırır.
Kayıt defterinde bir eklentinin bildiremeyeceği iki katman vardır: zincirler ve kendi başına çalışan beceriler yalnızca platform tarafından yazılır. Bunlardan birini adlandıran bir senkronizasyon tamamen reddedilir.
Hangi katman kullanılmalı
- İş, kendi kodunuzun hesapladığı girdinin bir fonksiyonu olduğunda
host_callback: bir puan, bir hesaplama, kendi şemanızda bir arama. Test edilmesi en basit olanıdır ve şablonun varsayılanıdır. Geri arama (callback) rotasını koruyun: manifestodaki bir yol gizli bilgi değildir ve rota platformun çağrısını doğrulamalı ve kuruluşu asla gövdeden değil, bu çağrıdan almalıdır. Bunuauth: internalolarak bildirin ve üzerinerequireService(Fastify) veyaserviceMiddleware(Express) bağlayın. Koruma, başka biri için üretilmiş bir belirteci reddeder. Hızlı yanıt verin ve aynı işin ikinci kez teslim edilmesini zararsız hale getirin. - Bir kişinin beklediği, yaşam döngüsüne çalışanınızın (worker) sahip olduğu daha uzun işler için
plugin_queue. Çalışan, başladığında çalıştırmayırunningdurumuna ve bitirdiğinde sonlandırıcı bir duruma taşımalıdır; yalnızca sonucunu gönderen bir çalışan, çalıştırmanın sonsuza kadarqueuedolarak görünmesine neden olur. - Sabit bir sistem istemiyle tek bir model çağrısı işi gördüğünde ve eklentiniz
coreveyaverifiedolduğundallm_only. - Modelin bir döngü içinde araçları çağırması gerektiğinde, yine yalnızca
coreveyaverifieddüzeyindetool_using. - Platformun diğer becerilerinizden birini bir liste üzerinde dağıtmasını (fan out) istediğinizde
map.
Corrán Orbital'deki yörünge yayılımı becerim bir host_callback becerisidir. Eklentimiz community düzeyindedir, bu nedenle model katmanları hiçbir zaman bir seçenek olmadı ve bunların eksikliğini de hissetmiyorum: Salı günü farklı bir yanıt veren bir yayıcı, işe yaramaz olmaktan daha kötü olurdu.
Her çalıştırmadan önce onay
Yalnızca bir makinenin kararıyla asla çalışmaması gereken bir manifesto becerisi bunu bildirir:
"approval": { "required": true, "reason": "Re-planning a pass needs the flight dynamics lead." }required her zaman true değerindedir; onaya ihtiyaç duymayan bir beceri bu bloğu atlar. reason, onaylayıcının gördüğü metindir, kırpıldıktan sonra 1 ila 500 karakter arasındadır ve diğer tüm biçimler APPROVAL_INVALID ile reddedilir. Becerinin sevki daha sonra bekletilir: sevk işlemi status: "awaiting_approval" ve bir waitpointId ile 202 yanıtını verir ve yalnızca adlandırılmış bir kişinin onayı bunu bir kez serbest bırakır. Bekletilen bir becerinin toplu, harita veya zincir sevki SKILL_APPROVAL_NOT_HOLDABLE ile reddedilir, çünkü bir dağıtım (fan-out) kendi öğelerini bekletemez. Bekletilen yanıtı oluşturun ve kararı onaylayıcıya bırakın; sevk edip ardından onay istemeyin.
Kayıt defteriyle senkronize etme
Her senkronizasyon bildirimseldir ve bir bütün olarak kontrol edilir. Her seferinde tam beceri kümesini gönderin: dışarıda bıraktığınız bir beceri devre dışı bırakılır ve çalıştırma geçmişi kalır. Hatalı tek bir beceri, tüm ihlaller birlikte listelenerek ve hiçbir şey yazılmadan tüm senkronizasyonu SYNC_CONTRACT_VIOLATION ile reddeder; böylece bir eklenti asla yarım güncellenmez. Bölüm 2.22, Eklenti çalışma zamanı, senkronizasyon çağrısını ve platformun hangi eklentinin çağrı yaptığını nasıl bildiğini ele alır.
İki tür arasında seçim yapma
İş "bunu her seferinde aynı şekilde söyle" ise bu bir Skills Engine becerisidir. İş "kodumu çalıştır ve bana yanıtını ver" ise bu bir manifesto becerisidir. Gerçek işlerin çoğu her ikisiyle sonuçlanır: Harrow'un rıhtım özeti, araçları bir eklentiden gelen bir Skills Engine becerisidir ve eklentinin araçları da kendi manifestosunda bildirilir. Skills Engine becerisi ikisi arasında değiştirilmesi daha ucuz olanıdır; bu da ifadeleri ve muhakemeyi orada, aritmetiği ise eklentide tutmak için iyi bir nedendir.
Maliyet her iki durumda da gerçektir. Bir Skills Engine becerisi SKILL.md iyi okunduğunda bitmiş sayılmaz; senaryoları geçtiğinde, prova çalıştırması insanların verdiği kararlarla uyuştuğunda ve siz olmayan biri onu onayladığında bitmiş olur. Yazma işlemi yapan bir beceri için çoğu kanarya aşamasında geçmek üzere bir hafta bütçe ayırın.



