Repository navigation
Closed
Labels
effort/l大改动或高风险改动,需要 maintainer 负责 / Large or risky change requiring maintainer ownership.大改动或高风险改动,需要 maintainer 负责 / Large or risky change requiring maintainer ownership.priority/p2中优先级 / Medium priority triage bucket.中优先级 / Medium priority triage bucket.risk/high涉及安全、鉴权、迁移或公共契约 / Touches security, auth, migrations, or public contracts.涉及安全、鉴权、迁移或公共契约 / Touches security, auth, migrations, or public contracts.triage/deferred暂留 backlog,由自动化定期重新评分 / Issue stays in backlog and is rescored by automation.暂留 backlog,由自动化定期重新评分 / Issue stays in backlog and is rescored by automation.
Description
Problem
GitHub 公开仓库同步(@github namespace)上线后,一个仓库里的多个技能会被拆成 N 条互不关联的条目,「开源技能」页(/github)只能逐条浏览、逐条下载/安装。
实测数据:同步 4 个公开仓库(anthropics/skills、obra/superpowers、mattpocock/skills、KKKKhazix/khazix-skills)共产出 79 个技能,全部平铺在开源技能页里。而这些仓库的技能本来就是成套设计的——典型如 obra/superpowers 的 brainstorming → writing-plans → test-driven-development → systematic-debugging 工作流,少装一个就跑不通。
当前使用者的实际困难:
- 看不出归属:列表里只有技能名,同一仓库的 20 个技能混在 79 条里,无法按仓库归类查看。
- 装不齐:想用一整套,只能逐个搜索、逐个安装,靠人肉凑齐并记住成员列表。
- 版本错位:仓库升级后逐个升级容易漏装、出现成员版本不一致,而套件语义本就要求成员版本锁步。
关键在于:服务端已有 Suite(技能套件)能力(/api/v1/suites、CLI skillhub suite),但 GitHub 同步链路不生成套件记录,/github 页面也没有套件入口——这套能力恰好覆盖不到最需要它的场景。
Proposed Solution
把「一个 GitHub 仓库 = 一个技能套件」作为同步产物的第一等公民:
- 同步侧自动成组:每个
github_source_binding产出的技能,自动挂到@github/<owner>--<repo>的 suite 记录下,成员与该次同步的固定 commit 绑定;仓库 HEAD 变更时整组推进,符合套件的锁步语义。 /github增加「按仓库」视图与套件入口:默认仍是现有技能列表,可切换为按仓库分组;仓库卡片显示成员数、最近同步提交,点进去复用已有套件详情页。- 整套下载 / 安装:
- 网页:套件详情提供「下载整套」(zip,含各成员包);
- CLI:
skillhub install @github/owner--repo一次装齐(skillhub suite已具备该能力,缺的是服务端套件记录); - 单个成员仍可独立安装,不受影响。
- 审核不变:成员仍逐包进同步审核队列,套件只是聚合视图,不引入「一次审核全部」的绕过路径。
Alternatives Considered
- 维持现状、用户自行分组:正是要解决的问题——79 条平铺、无可发现的归属关系。
- 用标签(label)分组:标签可被任意技能认领,无成员归属、无锁步版本、无「整套安装」语义,属于弱分组。
- 用 namespace 隔离:
@github是固定单命名空间,无法为每个仓库开子命名空间;创建命名空间也是治理级资源。 - 客户端自写脚本拼装:解决不了网页端整套浏览/下载,且每个组织都要重复实现一遍。
Impact
- 数据:新增套件记录(复用已有套件模型),不改动既有 skill/version 表结构;需要一次迁移或对历史同步产物做回填。
- 审核/治理:不变,成员仍独立审核;不引入新的发布路径。
- 部署/服务:无新增服务。
- 兼容:纯增量,未使用套件的调用方行为不变。
Contract Or SDK Impact
- OpenAPI:同步结果增加套件关联字段;
/github分组查询可能需要新参数(如groupBy=repository)或直接复用/api/v1/suites列表接口。 - CLI:
skillhub suite已支持套件安装与精确成员版本,服务端产生套件记录后即可直接工作,无需新增命令。 - ClawHub 兼容层:单技能坐标
@github/<slug>保持不变,套件坐标另立,互不影响。
Metadata
Metadata
Assignees
Labels
effort/l大改动或高风险改动,需要 maintainer 负责 / Large or risky change requiring maintainer ownership.大改动或高风险改动,需要 maintainer 负责 / Large or risky change requiring maintainer ownership.priority/p2中优先级 / Medium priority triage bucket.中优先级 / Medium priority triage bucket.risk/high涉及安全、鉴权、迁移或公共契约 / Touches security, auth, migrations, or public contracts.涉及安全、鉴权、迁移或公共契约 / Touches security, auth, migrations, or public contracts.triage/deferred暂留 backlog,由自动化定期重新评分 / Issue stays in backlog and is rescored by automation.暂留 backlog,由自动化定期重新评分 / Issue stays in backlog and is rescored by automation.
Activity
github-actions commentedon Nov 13, 2026
Issue Triage
triage/deferredpriority/p2(2.6/5)effort/l(5/5)5/5highrules-onlyWhy
High-Risk Signals
Next Action
问题分流结果
triage/deferredpriority/p2(2.6/5)effort/l(5/5)5/5高rules-only原因
高风险信号
下一步
feat(github): browse repository snapshots and download pinned skills (#…
XiaoSeS commentedon Nov 20, 2026
按维护者确认的本期范围结项。已合并的 PR #1102 交付了:
这里采用独立的“仓库+采集快照”模型,不将仓库自动转换为 Suite,也不承诺仓库内所有技能存在编排或强制锁步关系。
本次关闭不表示原提案的所有设想均已实现:仓库 CLI 一次安装、整仓升级与本地恢复尚未交付,后续在 #1110 中继续澄清其范围;#1103 的自动生成 Suite 方案也需要按上述模型重新核对。合并代码不等于现有部署已完成升级。
Closing against the maintainer-approved scope delivered by merged PR #1102: repository browsing, member/detail views, immutable acquisition snapshot history/comparison, and snapshot ZIP downloads containing pinned approved/distributable Skill versions, a manifest and SHA-256 checksums. Individual Skill access remains available.
The implementation uses a separate repository/acquisition-snapshot model. A GitHub repository is not automatically converted into a Suite, and no orchestration or mandatory lockstep relationship is inferred.
This closure does not claim every original proposal was implemented. Repository CLI installation, bulk upgrades and local recovery remain undelivered; their scope is to be clarified in #1110. The automatic-Suite proposal in #1103 must be reconciled with this model. A merged PR does not establish that existing deployments have upgraded.