Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh

Danh mục kỹ năng và plugin

Trạng thái: Đang hoạt động Phạm vi: công khai, trạng thái hiện tại Xem xét lần cuối: 2026-08-12 Chủ sở hữu: môi trường chạy AX Code

Sổ đăng ký có thể khám phá của các kỹ năng dựng sẵn và cách thêm kỹ năng dự án.

Menu / mặc định là một mặt phẳng điều khiển (/plan, /review, /debug, /status, /model). Các kỹ năng dựng sẵn cũ hơn chỉ dành cho tác nhân (công cụ kỹ năng). Gói độ tin cậy backend cũng được liệt kê như lệnh gạch chéo.

Kỹ năng dựng sẵn (phát hành dưới packages/ax-code/skills/)

Kỹ năng dùng SKILL.md với frontmatter YAML (name, description, paths tùy chọn, allowed-tools).

Kỹ năng dự án

Đặt kỹ năng dưới bất kỳ chỗ nào sau:

• .ax-code/skill/<name>/SKILL.md hoặc .ax-code/skills/<name>/SKILL.md
• .agents/skills/<name>/SKILL.md (tương thích Agents / Codex)
• .claude/skills/<name>/SKILL.md (tương thích Claude Code)
• .opencode/skills/<name>/SKILL.md

Liệt kê và xác thực:

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

Điều khiển gọi

AX Code đọc các điều khiển tùy chọn này khi khám phá một kỹ năng:

Dùng boolean YAML true và false. Thiếu điều khiển thì giữ mặc định. Nếu nhiều nguồn không thống nhất, một khai báo hạn chế hơn sẽ thắng. Kiểu điều khiển không hợp lệ hoặc chính sách sidecar sai dạng tắt cả hai chế độ gọi và tạo chẩn đoán gọi trong kiểm kê kỹ năng và nhật ký môi trường chạy. Hãy sửa siêu dữ liệu trước khi dùng kỹ năng. Sidecar tùy chọn phải nhỏ hơn 64 KiB; dấu phân cách tài liệu YAML và bí danh không được hỗ trợ ở đó.

Các điều khiển này quản việc gọi kỹ năng, độc lập với quyền tác nhân sẵn có. Một lần nhắc ngôn ngữ tự nhiên về kỹ năng chỉ thủ công không ủy quyền cho mô hình tải nó; hãy gọi lệnh gạch chéo của nó. allowed-tools đã khai báo vẫn là chỉ dẫn quy trình và không cấp quyền.

Khám phá có giới hạn

Ban đầu mô hình nhận các tóm tắt kỹ năng, không phải chỉ dẫn đầy đủ. Mỗi khối siêu dữ liệu kỹ năng trong lời nhắc hệ thống và mô tả công cụ có ngân sách 8,000 ký tự. Mô tả được rút ngắn trước khi các mục bị bỏ; các khuyến nghị khớp tệp được ưu tiên khi danh sách vẫn vượt ngân sách đó. Một thông báo bỏ sót giải thích cách lấy thêm tóm tắt. Đây là giới hạn ký tự, không phải số token hay một bảo đảm hiệu năng.

Công cụ skill có hai chế độ loại trừ lẫn nhau:

• {"name":"api-contract"} tải một kỹ năng qua kiểm tra quyền sẵn có.
• {"query":"database"} tìm tên và mô tả đủ điều kiện mà không tải thân kỹ năng.
• {"query":"","offset":20} tiếp tục một danh sách bằng đúng nextOffset từ kết quả trước.

Tìm kiếm là nguyên văn và không phân biệt hoa thường. Truy vấn rỗng liệt kê kỹ năng đủ điều kiện. Hãy theo nextOffset cho đến khi nó vắng. Kỹ năng chỉ thủ công và bị từ chối quyền bị loại khỏi khám phá mô hình. Các mục siêu dữ liệu riêng quá cỡ bị bỏ qua kèm thông báo. Tên và thứ tự ưu tiên nguồn không đổi.

Plugin

Cấu hình plugin trong ax-code.json:

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

Plugin triển khai các hook @ax-code/plugin (tool.execute.before, tool.execute.after, shell.env, xác thực, v.v.).

Đời callback

Nhà máy plugin nhận lifecycle tùy chọn trong đầu vào của chúng. lifecycle.signal hủy khi thực thể bị hủy hoặc plugin được nghỉ hưu. Hãy đăng ký bộ đếm, trình theo dõi và đăng ký bằng lifecycle.onDispose(cleanup). Hàm được trả về hủy đăng ký việc dọn đó. Các đăng ký chạy tối đa một lần; đăng ký sau khi hủy sẽ bắt đầu dọn ngay. Callback dọn bắt đầu theo thứ tự đăng ký ngược, mỗi cái có ngân sách một giây, và có thể kết thúc đồng thời.

Hook biến đổi nhận một đối số thứ ba tùy chọn, { signal }; hook cấu hình và sự kiện nhận nó làm đối số thứ hai. Tín hiệu này hủy công việc khi callback đang chờ; dùng lifecycle.signal cho công việc thuộc plugin vượt một callback. Hãy truyền tín hiệu cho các thao tác có thể hủy. Callback khởi tạo, cấu hình, sự kiện và biến đổi có hạn 15 giây. Hết thời gian sẽ nghỉ hưu plugin cho thực thể đó và hủy đời của nó. Các nhà máy sẵn có và hook biến đổi hai đối số vẫn hoạt động. Thực thi công cụ tùy chỉnh và xác thực tương tác giữ hợp đồng thực thi sẵn có.

Đầu vào biến đổi là các quan sát chỉ đọc của dữ liệu thuần. Hãy đột biến bản nháp đầu ra và chờ mọi thay đổi trước khi trả về. Các đột biến đầu ra thành công trở nên nhìn thấy được theo thứ tự đăng ký; thay đổi thất bại hoặc muộn bị bỏ. Thay đổi tải sự kiện không bao giờ được phát hành. Một từ chối quyền vẫn là từ chối, và hook quyền thất bại hoặc đã nghỉ hưu đòi hỏi phải hỏi trừ khi một từ chối đã tồn tại.

Mảng và đối tượng thuần được tách khỏi trạng thái môi trường chạy. Lược đồ, hàm và thực thể lớp giữ danh tính và phải được coi là chỉ đọc. Plugin vẫn là JavaScript đáng tin chạy trong tiến trình môi trường chạy: việc hủy là hợp tác và không thể dừng vòng lặp vô hạn đồng bộ hay hoàn tác hiệu ứng bên ngoài.

Gói hook

Xem Hook cho năm gói vòng đời chính thức (format-after-edit, block-force-push, require-tests-on-stop, protect-env-files, log-bash-commands).

Khung đánh giá

Chạy bộ cổng môi trường chạy tác nhân và bộ chính sách tập hợp đa chế độ:

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

Xem thêm Chế độ thực thi cho cục bộ/đám mây/lai/hội đồng/sàn đấu.