Halaman ini diterjemahkan dari dokumentasi bahasa Inggris. Perintah, pengenal, dan contoh tidak diubah. Runtime 7.24.4 · SDK 2.6.7. Sumber bahasa Inggris

Katalog skill dan plugin

Status: Aktif Cakupan: publik, kondisi terkini Terakhir ditinjau: 2026-08-12 Pemilik: runtime AX Code

Registri yang dapat ditemukan untuk skill bawaan dan cara menambahkan skill proyek.

Menu bawaan / adalah bidang kendali (/plan, /review, /debug, /status, /model). Skill bawaan yang lebih lama tetap hanya untuk agen (alat skill). Paket keandalan backend juga tercantum sebagai perintah garis miring.

Skill bawaan (dikirim di bawah packages/ax-code/skills/)

Skill memakai SKILL.md dengan frontmatter YAML (name, description, paths opsional, allowed-tools).

Skill proyek

Tempatkan skill di salah satu dari:

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

Cantumkan dan validasi:

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

Kendali pemanggilan

AX Code membaca kendali opsional ini saat menemukan skill:

Pakai boolean YAML true dan false. Kendali yang hilang mempertahankan bawaan. Jika beberapa sumber tidak sejalan, deklarasi yang lebih ketat menang. Jenis kendali yang tidak valid atau kebijakan sidecar yang rusak menonaktifkan kedua mode pemanggilan dan menghasilkan diagnostik pemanggilan di inventaris skill serta log runtime. Perbaiki metadata sebelum memakai skill. Sidecar opsional harus lebih kecil dari 64 KiB; pembatas dokumen YAML dan alias tidak didukung di sana.

Kendali ini mengatur pemanggilan skill, terlepas dari izin agen yang sudah ada. Sebutan bahasa alami atas skill yang hanya manual tidak mengizinkan model memuatnya; panggil perintah garis miringnya. allowed-tools yang dinyatakan tetap berupa instruksi alur kerja dan tidak memberikan izin.

Penemuan yang dibatasi

Model mula-mula menerima ringkasan skill, bukan instruksi penuh. Setiap blok metadata skill di prompt sistem dan deskripsi alat memiliki anggaran 8,000 karakter. Deskripsi dipendekkan sebelum entri dihilangkan; rekomendasi yang cocok dengan berkas mendapat prioritas bila daftar masih melebihi anggaran itu. Pemberitahuan penghilangan menjelaskan cara mengambil lebih banyak ringkasan. Ini batas karakter, bukan jumlah token atau jaminan kinerja.

Alat skill memiliki dua mode yang saling eksklusif:

• {"name":"api-contract"} memuat skill melalui pemeriksaan izin yang sudah ada.
• {"query":"database"} mencari nama dan deskripsi yang memenuhi syarat tanpa memuat isi skill.
• {"query":"","offset":20} melanjutkan daftar memakai nextOffset persis dari hasil sebelumnya.

Pencarian bersifat harfiah dan tidak peka huruf. Kueri kosong mencantumkan skill yang memenuhi syarat. Ikuti nextOffset sampai tidak ada. Skill yang hanya manual dan yang ditolak izin dikecualikan dari penemuan model. Entri metadata individual yang terlalu besar dilewati dengan pemberitahuan. Nama dan prioritas sumber tetap tidak berubah.

Plugin

Konfigurasikan plugin di ax-code.json:

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

Plugin mengimplementasikan hook @ax-code/plugin (tool.execute.before, tool.execute.after, shell.env, autentikasi, dan sebagainya).

Masa hidup callback

Pabrik plugin menerima lifecycle opsional pada masukannya. lifecycle.signal dibatalkan saat instans dibuang atau plugin dipensiunkan. Daftarkan pewaktu, pengamat, dan langganan dengan lifecycle.onDispose(cleanup). Fungsi yang dikembalikan membatalkan pendaftaran pembersihan itu. Pendaftaran berjalan paling banyak sekali; mendaftar setelah pembuangan memulai pembersihan segera. Callback pembersihan dimulai dalam urutan pendaftaran terbalik, masing-masing dengan anggaran satu detik, dan boleh selesai bersamaan.

Hook transform menerima argumen ketiga opsional, { signal }; hook konfigurasi dan peristiwa menerimanya sebagai argumen kedua. Sinyal ini membatalkan pekerjaan saat callback tertunda; pakai lifecycle.signal untuk pekerjaan yang dimiliki plugin di luar satu callback. Teruskan sinyal ke operasi yang dapat dibatalkan. Callback inisialisasi, konfigurasi, peristiwa, dan transform memiliki batas 15 detik. Waktu habis memensiunkan plugin untuk instans itu dan menggugurkan masa hidupnya. Pabrik yang sudah ada dan hook transform dua argumen tetap berfungsi. Eksekusi alat kustom dan autentikasi interaktif mempertahankan kontrak eksekusi yang sudah ada.

Masukan transform adalah pengamatan hanya-baca atas data biasa. Mutasikan draf keluaran dan tunggu semua perubahan sebelum kembali. Mutasi keluaran yang berhasil menjadi terlihat sesuai urutan pendaftaran; perubahan yang gagal atau terlambat dibuang. Perubahan muatan peristiwa tidak pernah diterbitkan. Penolakan izin tetap penolakan, dan hook izin yang gagal atau dipensiunkan mengharuskan bertanya kecuali penolakan sudah ada.

Larik dan objek biasa dilepas dari keadaan runtime. Skema, fungsi, dan instans kelas mempertahankan identitas dan harus diperlakukan sebagai hanya-baca. Plugin tetap JavaScript tepercaya yang berjalan di proses runtime: pembatalan bersifat kooperatif dan tidak dapat menghentikan putaran tak hingga yang sinkron atau membatalkan efek eksternal.

Paket hook

Lihat Hook untuk lima paket siklus hidup resmi (format-after-edit, block-force-push, require-tests-on-stop, protect-env-files, log-bash-commands).

Harness evaluasi

Jalankan rangkaian gerbang runtime agen dan rangkaian kebijakan ansambel multi-mode:

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

Lihat juga Mode eksekusi untuk lokal/cloud/hibrida/dewan/arena.