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

feat(evolution): private reviewed overlay revisions from local session-derived skill improvements

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

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

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
20/100
Loại issue
Tính năng
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
authentication, backend-api-design, security

Hướng nghiên cứu

Read the current schema, auth, routes, and contracts, then review issues #31, #34, #35, and #55 for prerequisites and existing patterns. The issue scopes implementation to backend contracts and CLI helpers, with schema validation and negative security tests first. Done means the reviewed private overlay flow meets the listed privacy, lineage, authorization, concurrency, and rollback requirements; no specific files or tests are named.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement

Parent / prerequisites

Tracked by SkillX #31. Depends on personal-kit immutable lineage/overlay #55, registry releases #34/#54. Consumer AgentKit #2274, future AK ak insights -> skill improvement proposal and private publish.

Objective

Expose an authenticated, privacy-safe flow to publish user-reviewed skill overlay revisions created from local AgentKit session analysis, while preserving base foundation ancestry, source-license/entitlement restrictions, review history, optimistic concurrency and no raw session exfiltration.

Contract

  1. Inputs: target @publisher/skill, base package ID/version/digest, existing overlay revision/generation, candidate structural patch and supporting non-sensitive evidence summary; never require or accept raw transcripts, environment secrets, local absolute filesystem paths, prompts containing customer data or arbitrary source trees without specific consent.
  2. An optional local agent may analyze session/evaluation and propose a patch, but only user-authorized content is sent. Default visibility private; profile settings do not grant automatic publish permission.
  3. Validate package schema, patch bounds, AST/semantic extension points, submitted file paths, content scanner, license, foundation redistribution restrictions, publisher namespace, entitlements, declared required runtime permissions and resource manifests. Reject hidden binary/executable additions unless separately declared/reviewed.
  4. Immutable revision with revision ID, parent digest, content digest, base digest, ancestry chain, author and audit metadata. Compare-and-swap expectedGeneration and idempotency key to prevent lost updates and duplicate publish.
  5. Distinguish draft, candidate, reviewed, published, rejected, and quarantined as needed without conflicting with package release states. Disallow publish based purely on an unverifiable success counter or self-reported prompt.
  6. User explicitly approves diff + permissions + target visibility; record consent/approval proof, not private session content. Provide dry-run validation endpoint and machine-readable conflicts/new permission requests.
  7. Support rollback to previous revision and local locked sync; old revision remains available under policy when newer candidate rejected. Handle private/public transitions without exposing paid upstream contents.
  8. Reuse existing skillx publish / registry auth patterns and #55 lineage API; do not build a new service or second user identity.

Adversarial acceptance

  • No raw transcript fields or secrets accidentally persisted, logged, vectorized, indexed or included in errors.
  • Anonymous/other-user writer denied; wrong base digest/entitlement/visibility rejected; concurrent proposals conflict explicitly.
  • Double-submit of same revision is idempotent; differing content under same immutable revision refused.
  • Paid/private upstream derivative cannot leak protected foundation bytes through public patch/preview/search.
  • Review denial, compromised account, quarantined content, rollback, retry and expired credentials deterministic.
  • Works with manifest and locked sync from #55, and AK publishes only reviewed effective user-owned delta.

Agent implementation prompt

Read SkillX instructions and current schema/auth/routes/contracts plus #31/#34/#35/#55 before coding. Specify threat/privacy model and the exact acceptable request envelope; add schema validation tests first. Prefer a local-only evidence proposal and upload patch only. Implement a dry-run validate step, CAS-backed versioned persistence and explicit approval endpoint with audit, strict publisher and paid-license checks. Add negative security tests (accidental secret/session upload, cross-user access, unauthorized visibility, lost update) and backward compatibility coverage. Scope the PR to backend/contracts/CLI helpers; downstream AgentKit session parsing and eval stay in AgentKit. Include migrations, rollback and exact tests in PR.

Non-goals

Reading or indexing full user sessions server-side, training on private transcripts, automatic unattended publish, crypto payments/creator settlements, automatic security approval.

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

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.