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

ak skills

ak skills publish

Publish một thư mục Skill lên SkillX thành một release bất biến của @publisher/slug; package mới là private trừ khi --visibility chọn giá trị khác.

Dùng ak skills publish để upload một thư mục Skill lên SkillX thành một release của @<publisher>/<slug> ở đúng một phiên bản. Lệnh đóng gói và kiểm tra tree tại máy, và không gửi gì cho đến khi mọi bước kiểm tra đều qua. Lệnh không ghi gì cục bộ và không bao giờ hỏi.

Cách dùng

ak skills publish <dir> --name <@publisher/slug> --version <semver> [flags]
ak skills publish ./my-skill --name @alice/my-skill --version 1.0.0
ak skills publish ./my-skill --name @alice/my-skill --version 1.1.0-beta.1 --channel beta
ak skills publish ./my-skill --name @alice/my-skill --version 1.0.0 --visibility unlisted --json

Tuỳ chọn

CờMặc địnhMô tả
--name <@publisher/slug>Không có; bắt buộcTên package trên SkillX.
--version <semver>Không có; bắt buộcPhiên bản release, SemVer không có build metadata.
--channel <channel>stableKênh release: stable, beta hoặc alpha.
--visibility <visibility>Mặc định của SkillX, privateVisibility của package mới: private, unlisted hoặc public. Không bao giờ đổi package đã có.

Các cờ dùng chung nằm trong quy ước CLI.

Điều kiện

CầnChi tiết
SkillX đang bậtSau ak update --ssot, hoặc với AGENTKIT_SKILLX=1 hay features.skillx: true. Khi tắt, lệnh thoát 2.
Credential SkillXUpload dùng liên kết agentkit.best (ak skills link) khi có, nếu không thì dùng SKILLX_TOKEN trong ak secrets. Token liên kết cần grant skillx-kits:write; API key cần scope releases:publish:@<publisher>. Không có credential thì không gửi gì.

Lệnh làm gì

  • Thư mục phải có SKILL.md ở gốc. Tree theo agentkit.skill-tree/v1: không đi theo link, symlink, device và đường dẫn không an toàn bị từ chối trước khi gửi bất cứ thứ gì, còn file metadata của VCS và hệ điều hành bị bỏ qua. SkillX nhận tối đa 1000 file và 32 MiB.
  • Package mới là private trừ khi --visibility chọn giá trị khác. Publish không bao giờ đổi visibility của package đã có, nên --visibility với giá trị khác sẽ bị từ chối (thoát 6). Đổi bằng ak skills visibility.
  • Phiên bản đã chứa nội dung khác bị từ chối (thoát 6); hãy publish phiên bản mới. Publish vào package đã bị xoá cũng bị từ chối; hãy khôi phục package trước bằng ak skills restore.
  • Upload mang một idempotency key suy ra từ tên, phiên bản, kênh, visibility và sha256 của archive đã đóng gói. Chạy lại sau khi mất phản hồi sẽ replay release đã lưu thay vì lỗi, và upload mà SkillX vẫn đang lưu dưới key đó được thử lại với backoff.
  • Trên nền tảng không ghi file mode (Windows), mọi file được publish ở dạng không executable, kèm cảnh báo trên stderr. Hãy publish từ macOS hoặc Linux để giữ script executable.

SkillX có thể lưu release mà không publish: state quarantined trong lúc operator của SkillX xem xét kết quả quét. Lệnh vẫn thoát 0 và in cảnh báo ra stderr, nên script phải đọc state trong đầu ra --json, không chỉ dựa vào mã thoát.

Đầu ra

Đầu ra text nêu kết quả (Published, Already published (same content) hoặc Already published (replayed)), rồi visibility, kênh, state, release digest, số file và kích thước đã đóng gói, cùng một dòng cho mỗi finding và cảnh báo. Với package private, lệnh còn in dòng ak skills visibility <@publisher/slug> --set unlisted để chia sẻ nó.

JSON dùng kind=skills.publish với các trường sau dưới data:

identity, version, channel, visibility, releaseDigest, artifactDigest,
state, created, replayed, files, archiveBytes, findings[], warnings[]

Kết quả và mã thoát

MãÝ nghĩa
0Đã publish, đã publish với cùng nội dung, hoặc upload được replay. Release lưu ở state quarantined cũng thoát 0; hãy đọc state.
1Lệnh thất bại: SkillX offline, credential thiếu hoặc bị từ chối, hoặc phản hồi không đáng tin. Thay đổi có thể đã được áp dụng; kiểm tra bằng ak skills visibility.
2SkillX bị tắt, cờ hoặc argument không hợp lệ, thư mục không phải skill tree hợp lệ, hoặc request bị SkillX từ chối vì không hợp lệ.
5Không tìm thấy package, hoặc SkillX chưa bật publish release.
6Conflict với state hiện tại của package: visibility không khớp, phiên bản đã tồn tại, hoặc publish vào package đã bị xoá.
7SkillX từ chối thay đổi: cần duyệt trên dashboard SkillX, tài khoản của credential không sở hữu publisher, publisher bị đình chỉ, hoặc quản trị viên đã xoá package.

Lệnh liên quan