AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop
BetaBạn đang đọc tài liệu kênh beta (2.13.0-beta.20). Tính năng có thể thay đổi trước bản stable tiếp theo.Chuyển sang stable →

ak skill

ak skill verify

Phân loại môi trường skill cục bộ thành ok, missing, corrupt hoặc unknown và đọc đúng JSON thô.

Dùng ak skill verify để so sánh declaration runtime: hiện tại của skill cục bộ với record theo skill và các marker cache cần có.

Cách dùng

ak skill verify <kit>/<skill>
CờMặc địnhMô tả
--kits-dir <dir>AGENTKIT_KITS_DIR hoặc ./kitsChọn source declaration cục bộ.

Lệnh chỉ đọc, không gửi request mạng, không chạy package tool và không hỏi xác nhận.

Diễn giải status

StatusMã thoátÝ nghĩaBước tiếp theo
ok0Manifest hash và environment kind khớp, đồng thời có marker pyvenv.cfg hoặc node_modules cần thiết.Dùng skill.
missing1Chưa có manifest theo skill.Chạy ak skill install <kit>/<skill>.
corrupt1Manifest không đọc được, hash/kind drift hoặc thiếu marker cache cần có.Chạy ak skill repair <kit>/<skill>, rồi verify lại.
unknown0Runtime management đang opt out hoặc runtime type đã load không được quản lý.Kiểm tra AGENTKIT_SKILL_RUNTIME; đừng xem đây là healthy.

Verify chỉ kiểm tra sức khoẻ cấu trúc. Lệnh không hash từng byte package đã cài, không truy cập registry, không quét vulnerability và không thực thi skill.

JSON và stream

--json ghi object thô ra stdout, không phải shared success envelope:

{"kit":"engineer","skill":"web-testing","status":"ok"}

Với missingcorrupt, object vẫn được ghi trước khi process thoát 1; không có JSON error envelope thứ hai. Lỗi resolve và I/O xảy ra trước khi có status dùng error envelope có cấu trúc trên stderr.

Status dành cho người dùng được ghi ra stderr. --quiet không ẩn dòng status được ghi trực tiếp.

Các mã thoát khác

Ý nghĩa
1Status là missing hoặc corrupt, hay I/O verify bất thường thất bại.
2Reference đơn hoặc cờ không hợp lệ.
4Source skill không có block runtime.
5Không tìm thấy source kit hoặc skill.

Argument theo vị trí bị thiếu hoặc thừa hiện thoát 1 qua đường pre-command validation của Cobra.

Lệnh liên quan