Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

Beceri / eklenti kataloğu

Durum: Etkin Kapsam: herkese açık, güncel durum Son inceleme: 2026-08-12 Sahip: AX Code çalışma zamanı

Yerleşik becerilerin keşfedilebilir kaydı ve proje becerilerinin nasıl ekleneceği.

Varsayılan / menüsü bir denetim düzlemidir (/plan, /review, /debug, /status, /model). Daha eski yerleşik beceriler yalnızca ajanda kalır (beceri aracı). Arka uç güvenilirlik paketi de eğik çizgi komutları olarak listelenir.

Yerleşik beceriler (`packages/ax-code/skills/` altında gönderilir)

Beceri	Amaç	Eğik çizgi
`debug-n-fix`	Doğrulamayla önce ayıkla, sonra düzelt	`/debug` kullanın
`debug-only`	Kod değişikliği olmadan inceleme	Yalnızca ajan
`improve-overall`	Geniş kalite iyileştirmeleri	Yalnızca ajan
`improve-security`	Güvenlik odaklı iyileştirmeler	Yalnızca ajan
`mcp`	MCP kurulum rehberi	`/mcp` kullanın
`run`	Uygulamayı başlat ve gözle	Yalnızca ajan
`simplify`	Yakın zamanda değişen kodu sıkılaştır	Yalnızca ajan
`verify`	Çalışma zamanı doğrulama raporu	Yalnızca ajan
`verified-change`	Yalnızca başarısız bir işaretten sonra düzenle, ardından aynı denetimi yeniden çalıştır	`/verified-change`
`safe-db-migration`	Geri alma notlarıyla şema genişletme, geri doldurma ve daraltma	`/safe-db-migration`
`api-contract`	Önce eklemeli herkese açık API / şema evrimi	`/api-contract`
`incident-observability`	Yamadan önce kanıt öncelikli olay tanısı	`/incident-observability`
`auth-boundaries`	Kimlik doğrulama/yetkilendirme, kiracı yalıtımı, negatif sınamalar	`/auth-boundaries`
`queue-worker`	İdempotent kuyruk/işçi değişiklikleri ve yinelenen teslim	`/queue-worker`
`ruby-on-rails`	Rails sürecini başlatmadan Rails kuralları	Yalnızca ajan

Beceriler YAML ön maddesiyle SKILL.md kullanır (name, description, isteğe bağlı paths, allowed-tools).

Proje becerileri

Becerileri şunlardan herhangi birinin altına koyun:

.ax-code/skill/<name>/SKILL.md veya .ax-code/skills/<name>/SKILL.md
.agents/skills/<name>/SKILL.md (Agents / Codex uyumu)
.claude/skills/<name>/SKILL.md (Claude Code uyumu)
.opencode/skills/<name>/SKILL.md

Listeleyin ve doğrulayın:

ax-code            # TUI skill dialog
# or use the skill tool from a session

Çağrı denetimleri

AX Code bir beceri keşfederken bu isteğe bağlı denetimleri okur:

Konum	Alan	Etki
`SKILL.md` ön maddesi	`disable-model-invocation: true`	Açık `/skill-name` komutunu tutun, ancak beceriyi model keşfinden ve doğrudan model araç yüklemelerinden çıkarın.
`SKILL.md` ön maddesi	`user-invocable: false`	Beceriyi eğik çizgi komutlarından çıkarın; ayrı kapatılmadıkça model çağrısı kullanılabilir kalır.
Kardeş `agents/openai.yaml`	`policy.allow_implicit_invocation: false`	`.agents/skills` yoluyla içe aktarılan beceriler dahil açık eğik çizgi çağrısı gerektirin.

YAML boole değerleri true ve false kullanın. Eksik denetimler varsayılanları korur. Birden çok kaynak uyuşmazsa kısıtlayıcı bildirim kazanır. Geçersiz denetim türleri veya bozuk sidecar ilkesi iki çağrı kipini de kapatır ve beceri envanteri ile çalışma zamanı günlüklerinde çağrı tanıları üretir. Beceriyi kullanmadan önce üst veriyi düzeltin. İsteğe bağlı sidecar 64 KiB’den küçük olmalıdır; YAML belge sınırlayıcıları ve takma adlar orada desteklenmez.

Bu denetimler, mevcut ajan izinlerinden bağımsız olarak beceri çağrısını yönetir. Yalnızca el ile bir becerinin doğal dilde anılması modelin onu yüklemesine yetki vermez; eğik çizgi komutunu çağırın. Bildirilen allowed-tools iş akışı yönergesi olarak kalır ve izin vermez.

Sınırlı keşif

Model başlangıçta tam yönergeleri değil beceri özetlerini alır. Sistem istemindeki ve araç açıklamasındaki her beceri üst veri bloğunun 8,000 karakterlik bütçesi vardır. Liste bu bütçeyi aşmaya devam ederken girdiler atılmadan önce açıklamalar kısaltılır; dosyayla eşleşen öneriler öncelik alır. Bir atlama uyarısı daha fazla özetin nasıl alınacağını açıklar. Bu bir karakter sınırıdır; token sayısı veya başarım garantisi değildir.

skill aracının iki birbirini dışlayan kipi vardır:

{"name":"api-contract"} mevcut izin denetimi üzerinden bir beceri yükler.
{"query":"database"} beceri gövdelerini yüklemeden uygun adları ve açıklamaları arar.
{"query":"","offset":20} önceki sonuçtaki tam nextOffset değerini kullanarak listelemeyi sürdürür.

Arama düz ve büyük/küçük harfe duyarsızdır. Boş sorgular uygun becerileri listeler. Yok olana kadar nextOffset izleyin. Yalnızca el ile ve izni reddedilen beceriler model keşfinden çıkarılır. Aşırı büyük tekil üst veri girdileri bir uyarıyla atlanır. Adlar ve kaynak önceliği değişmeden kalır.

Eklentiler

Eklentileri ax-code.json içinde yapılandırın:

{
  "plugin": ["file:///absolute/path/to/plugin.js"]
}

Eklentiler @ax-code/plugin kancalarını uygular (tool.execute.before, tool.execute.after, shell.env, kimlik doğrulama vb.).

Geri çağrı ömrü

Eklenti fabrikaları girdilerinde isteğe bağlı lifecycle alır. lifecycle.signal örnek atıldığında veya eklenti emekliye ayrıldığında iptal olur. Zamanlayıcıları, izleyicileri ve abonelikleri lifecycle.onDispose(cleanup) ile kaydedin. Dönen işlev bu temizliği kayıttan çıkarır. Kayıtlar en fazla bir kez çalışır; atmadan sonra kaydetmek temizliği hemen başlatır. Temizlik geri çağrıları ters kayıt sırasıyla başlar, her birinin bir saniyelik bütçesi vardır ve eşzamanlı bitebilir.

Dönüştürme kancaları isteğe bağlı üçüncü bağımsız değişken olarak { signal } alır; yapılandırma ve olay kancaları onu ikinci bağımsız değişken olarak alır. Bu sinyal, geri çağrı beklerken işi iptal eder; bir geri çağrının ötesinde eklentiye ait iş için lifecycle.signal kullanın. Sinyalleri iptal edilebilir işlemlere geçirin. Başlatma, yapılandırma, olay ve dönüştürme geri çağrılarının 15 saniyelik son tarihi vardır. Zaman aşımı eklentiyi o örnek için emekliye ayırır ve ömrünü iptal eder. Mevcut fabrikalar ve iki bağımsız değişkenli dönüştürme kancaları çalışmaya devam eder. Özel araç yürütmesi ve etkileşimli kimlik doğrulama mevcut yürütme sözleşmelerini korur.

Dönüştürme girdileri düz verinin salt okunur gözlemleridir. Çıktı taslağını değiştirin ve dönmeden önce tüm değişiklikleri bekleyin. Başarılı çıktı değişiklikleri kayıt sırasıyla görünür olur; başarısız veya geç değişiklikler atılır. Olay yükü değişiklikleri asla yayımlanmaz. Bir izin reddi ret olarak kalır ve başarısız veya emekli izin kancaları, bir ret zaten yoksa sormayı gerektirir.

Diziler ve düz nesneler çalışma zamanı durumundan ayrılır. Şemalar, işlevler ve sınıf örnekleri kimliği korur ve salt okunur ele alınmalıdır. Eklentiler çalışma zamanı sürecinde çalışan güvenilen JavaScript olarak kalır: iptal işbirlikçidir ve eşzamanlı sonsuz döngüleri durduramaz veya dış etkileri geri alamaz.

Kanca paketleri

Beş resmi yaşam döngüsü paketi için Kancalar sayfasına bakın (format-after-edit, block-force-push, require-tests-on-stop, protect-env-files, log-bash-commands).

Değerlendirme koşumu

Ajan çalışma zamanı kapı kümesini ve çok kipli topluluk ilke kümesini çalıştırın:

cd packages/ax-code
pnpm exec vitest run test/harness/agentic-runtime-eval.test.ts
pnpm exec vitest run test/harness/multi-mode-ensemble-eval.test.ts

Yerel/bulut/hibrit/council/arena için ayrıca Yürütme kipleri sayfasına bakın.