Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Personal-kit API gaps for AgentKit kit publish/sync

Đang mở
  • Có gì không ổn?
#88 1 bình luận 0 reaction 1 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@mrgoonie đang làm issue này rồi.

Từ ngày 15/10/2026.

Đánh giá

Issue này chưa được đánh giá.

Mô tả

M0 AgentKit v3 release blocker (owner decision, 2026-10-19): Personal kits are no longer a post-v3 optional milestone. AgentKit #2524 and #2589 require production-compatible first-run flows after ak update --ssot: create/edit foundation-derived skills and personal kits, rebase/resolve, explicit private publish, locked second-device sync, and approved session-evolution proposal; local/offline use requires no SkillX login, cloud calls require scoped auth. At audit, SKILLX_PERSONAL_KITS_API=0 in apps/web/wrangler.jsonc. PR #94 delivered composition metadata and If-Match on 2026-10-16, so re-check gaps 1–2 rather than reimplement, and evaluate 3–7 against current schema. Release must pass real staging→production-compatible E2E including signed @agentkit/* foundation publishing, pinned older base handling, CAS conflict, private permissions, no secret leakage and rollback; no fake-only GO. Own exact API enablement, rollback flag and smoke receipts. AgentKit #2282 owns independent acceptance. No automatic user-session upload, public publish or execution of remote scripts. Server-side work should not duplicate AgentKit's Go installer.

Context

AgentKit G2 adds ak skills kit publish and ak skills kit sync --locked for personal kits. The work is tracked in bestagentkits/agentkit#2278 under the epic bestagentkits/agentkit#2274.

Building them against the current personal-kit API surfaced gaps that limit what a synced kit can do. AgentKit works around each one by failing safe and does not depend on any undocumented endpoint.

Gaps

  1. A revision document has no composition metadata. There is no field for the manifest's extends and include, or for the resolution records (keep-old, fork and overlay decisions). As a result, a kit synced from SkillX cannot be rebased or edited from that copy.
    • Ask: optional, schema-validated composition fields on a revision document, and include them in the document digest.
  2. No If-Match or ETag precondition on kit writes. AgentKit sends the expected generation in the request body.
    • Ask: honor If-Match: <generation> and return 412 on a mismatch, keeping the body field for compatibility.
  3. Only forks of ak- skills can be published. An in-place overlay on a foundation skill is refused, so AgentKit exits 6 for it today.
    • Ask: accept structured overlay revisions against a pinned foundation skill, using the lineage from #55.
  4. Bases are verified against SkillX releases only. The @agentkit/* foundation releases must exist on SkillX before any AgentKit kit can publish or sync.
    • Ask: publish or mirror the @agentkit/* releases, or accept a signed AgentKit release manifest as a base.
  5. Session proposals are not offered through the personal-kit API that AgentKit uses. This relates to #56.
  6. Every pinned base must be the current release. A skill pinned to an older foundation release cannot be published until it is rebased.
    • Ask: allow a revision to pin any published, non-yanked base release.
  7. extends: skillx:<kit> is not supported. A manifest cannot extend another SkillX kit yet; AgentKit keeps it marked unsupported.

Acceptance

Each item is either done or explicitly declined, with the reason. AgentKit then updates its contract and the G2 acceptance rows.

Refs #31

Ngôn ngữ chính
TypeScript
Star
189
Fork
40
Merge trung bình
7 giờ 38 phút
Pull request đã merge (30 ngày)
30

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của nextlevelbuilder/skillx

Tất cả issue của nextlevelbuilder/skillx

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.