Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

feat(quality-packs): QGP foundation packs, private overrides và three-way rebase giữ nguyên opt-out

未关闭
#108 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
18/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
typescript

调研方向

Start by reading the listed personal-kit files under apps/web/app/lib/personal-kits/, the release signing code, compatibility code, schemas, and existing personal-kit tests. The issue asks to extend those foundations for versioned quality packs, private overlays, and consent-aware three-way rebase; use the referenced ADR and dependencies to establish expected behavior. Done means the listed merge, privacy, rollback, offline, and interoperability cases pass without losing opt-outs.

由索引模型根据 Issue 内容生成。

描述

enhancement

Mục tiêu / dependencies

Epic QGP: https://github.com/bestagentkits/agentkit/issues/2638; AgentKit integration: https://github.com/bestagentkits/agentkit/issues/2639.
SkillX là kênh phân phối/cá nhân hóa tùy chọn, không là runtime dependency của QGP. Đây là phạm vi quality packs đã nêu trong thiết kế hệ sinh thái.
Tái sử dụng #33/#34/#35 (discovery/immutable release/personal kits), #36 (packs), #54/#100 (foundation provenance), #88 (personal-kit APIs), #107 (private library). AgentKit counterparts: https://github.com/bestagentkits/agentkit/issues/2278, https://github.com/bestagentkits/agentkit/issues/2589. Không tạo installer/sync/rebase engine khác.

Bằng chứng

Đọc lại 5fc3077: apps/web/app/lib/personal-kits/{kit-rebase,kit-conflicts,kit-revisions,kit-verify,kit-lifecycle}.ts, lib/releases/sign-manifest.ts, lib/compatibility/, schema và tests personal kits. Có nền tảng release/provenance/rebase để mở rộng thay vì copy-paste.

Phạm vi

  1. Versioned quality-pack metadata/facet theo ADR QGP: rule IDs/schema, evaluator refs/versions, rubric/profile, required capabilities, compatibility, provenance, checksums, scripts/deps và permission declaration. Pack là data trước; tải về không đồng nghĩa cấp quyền chạy.
  2. Foundation + user/project overlays: inherit, explicit disabled, param override, remove/tombstone; thứ tự deterministic và explain nguồn mỗi rule. Không sửa foundation bytes, không overwrite entire skill để cá nhân hóa rubric.
  3. Three-way rebase trên base đã pin + upstream mới + overlay. Nếu upstream đổi ý nghĩa/type/default/permissions của rule overridden phải conflict/migration review. New rule có network/model/scripts không được tự enable. Unknown capabilities/schema fail actionable; không drop silently.
  4. Package/release pin và immutable lock đủ chạy offline; opt-in update/sync/rebase/publish qua existing APIs/CLI/MCP. Private content/receipts không lọt public search, ratings, previews, cache hoặc telemetry. Reuse #107 scope.
  5. Evaluation evidence là attachment có scope/redaction và consent, không upload raw sessions/screenshots tự động. Score phải ghi corpus/evaluator/policy versions và measured/estimated; không biến self-reported model score thành verified marketplace certification.
  6. Rollback phục hồi cả pack versions, overlay và opt-out. Revoked/quarantined pack không được silently execute; installer consumer giữ execution sandbox/permissions riêng.

Definition of Done (DoD)

  • Quality-pack schema/facet có version/compatibility/provenance và conformance fixtures với QGP; cơ chế discovery cũ không bị phá.
  • Publish/fetch/install pinned pack dùng existing immutable release và verified artifacts, không thêm registry thứ hai. Offline consumer chạy không cần SkillX API.
  • User có thể bật/tắt evaluator/rule, override params/profile, giữ inherit khác false/remove; explain output đúng sau install/sync/update/rebase.
  • Tests three-way merge: upstream add/change/delete/rename rule, modified local overlay, disabled rule, changed schema/permissions, concurrent version update và conflict resolution.
  • Foundation update KHÔNG re-enable rule người dùng đã tắt, không cấp upload/model/sandbox/budget mới, không tự chạy migration scripts có quyền.
  • New rule/evaluator requiring external execution luôn inactive/pending-consent cho tới owner chấp thuận; project metadata không giả được user consent.
  • Lock/digest/version pin và rollback tái lập chính xác effective policy, kể cả opt-outs; corrupt/stale/foreign/quarantined release bị xử lý đúng.
  • Private packs/overrides/eval evidence chỉ owner/grantees đọc được ở tất cả REST/MCP/CLI/search/cache paths; test không leak into public metadata/leaderboards.
  • Evidence upload/public publish cần explicit action; labels tự model tạo không được gọi là độc lập verified benchmark, missing measurements không biến thành zero.
  • AgentKit↔SkillX interoperability test: install foundation -> customize -> upstream update -> conflict/resolve -> sync another authorized client -> rollback, kết quả effective policy giống nhau.
  • CI offline và deterministic fixtures, no-secret bundle scan, path/symlink/size bounds; docs custom quality pack/private publication/migration/consent/rollback và failure cases.

Không làm

Không dựng quality marketplace/revenue layer mới, không bắt QGP gửi dữ liệu trung tâm, không tự publish cải tiến của agent hoặc thay các quyền người dùng bằng consent trong package.

主要语言
TypeScript
星标
190
派生
42
平均合并
5 小时 50 分钟
30 天内合并 PR
37

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

nextlevelbuilder/skillx 的其他 Issue

查看 nextlevelbuilder/skillx 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。