Skip to content

[Feature] 开源技能(@github)支持按仓库成套查看与整套安装 #1094

Closed

Description

@SAXEM1997

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 工作流,少装一个就跑不通。

当前使用者的实际困难:

  1. 看不出归属:列表里只有技能名,同一仓库的 20 个技能混在 79 条里,无法按仓库归类查看。
  2. 装不齐:想用一整套,只能逐个搜索、逐个安装,靠人肉凑齐并记住成员列表。
  3. 版本错位:仓库升级后逐个升级容易漏装、出现成员版本不一致,而套件语义本就要求成员版本锁步。

关键在于:服务端已有 Suite(技能套件)能力(/api/v1/suites、CLI skillhub suite),但 GitHub 同步链路不生成套件记录,/github 页面也没有套件入口——这套能力恰好覆盖不到最需要它的场景。

Proposed Solution

把「一个 GitHub 仓库 = 一个技能套件」作为同步产物的第一等公民:

  1. 同步侧自动成组:每个 github_source_binding 产出的技能,自动挂到 @github/<owner>--<repo> 的 suite 记录下,成员与该次同步的固定 commit 绑定;仓库 HEAD 变更时整组推进,符合套件的锁步语义。
  2. /github 增加「按仓库」视图与套件入口:默认仍是现有技能列表,可切换为按仓库分组;仓库卡片显示成员数、最近同步提交,点进去复用已有套件详情页。
  3. 整套下载 / 安装:
    • 网页:套件详情提供「下载整套」(zip,含各成员包);
    • CLI:skillhub install @github/owner--repo 一次装齐(skillhub suite 已具备该能力,缺的是服务端套件记录);
    • 单个成员仍可独立安装,不受影响。
  4. 审核不变:成员仍逐包进同步审核队列,套件只是聚合视图,不引入「一次审核全部」的绕过路径。

Alternatives Considered

  1. 维持现状、用户自行分组:正是要解决的问题——79 条平铺、无可发现的归属关系。
  2. 用标签(label)分组:标签可被任意技能认领,无成员归属、无锁步版本、无「整套安装」语义,属于弱分组。
  3. 用 namespace 隔离:@github 是固定单命名空间,无法为每个仓库开子命名空间;创建命名空间也是治理级资源。
  4. 客户端自写脚本拼装:解决不了网页端整套浏览/下载,且每个组织都要重复实现一遍。

Impact

  • 数据:新增套件记录(复用已有套件模型),不改动既有 skill/version 表结构;需要一次迁移或对历史同步产物做回填。
  • 审核/治理:不变,成员仍独立审核;不引入新的发布路径。
  • 部署/服务:无新增服务。
  • 兼容:纯增量,未使用套件的调用方行为不变。

Contract Or SDK Impact

  • OpenAPI:同步结果增加套件关联字段;/github 分组查询可能需要新参数(如 groupBy=repository)或直接复用 /api/v1/suites 列表接口。
  • CLI:skillhub suite 已支持套件安装与精确成员版本,服务端产生套件记录后即可直接工作,无需新增命令。
  • ClawHub 兼容层:单技能坐标 @github/<slug> 保持不变,套件坐标另立,互不影响。

Activity

  1. added
    triage/deferred暂留 backlog,由自动化定期重新评分 / Issue stays in backlog and is rescored by automation.
    priority/p3低优先级 / Low priority triage bucket.
    effort/l大改动或高风险改动,需要 maintainer 负责 / Large or risky change requiring maintainer ownership.
    risk/high涉及安全、鉴权、迁移或公共契约 / Touches security, auth, migrations, or public contracts.
    on Nov 13, 2026
  2. github-actions commented on Nov 13, 2026

    @github-actions
    Contributor

    Issue Triage

    • Route: triage/deferred
    • Priority: priority/p2 (2.6/5)
    • Effort: effort/l (5/5)
    • Confidence: 5/5
    • Risk: high
    • Analysis Mode: rules-only

    Why

    • Touches core SkillHub workflows (namespace, api, install).
    • Issue includes operator or product impact details.
    • Text suggests a bounded change (label).

    High-Risk Signals

    • Mentions sensitive areas (openapi).
    • Issue mentions API, SDK, or contract changes.

    Next Action

    • Keep the issue in the deferred queue and let the 6-hour rescore keep lifting it; it is forced into an active lane by day 10. If it is still open on day 14, treat it as a P0 escalation target under the SLA and prioritize it in the next triage pass.

    问题分流结果

    • 路由: triage/deferred
    • 优先级: priority/p2 (2.6/5)
    • 修复投入: effort/l (5/5)
    • 信息完整度: 5/5
    • 风险: 高
    • 分析模式: rules-only

    原因

    • 涉及 SkillHub 核心流程(namespace, api, install)
    • 包含用户或产品影响说明
    • 文本显示改动范围较可控(label)

    高风险信号

    • 提到敏感区域(openapi)
    • 提到 API、SDK 或契约变更

    下一步

    • 将 issue 保留在 deferred 队列,并由 6 小时一次的 rescore 持续抬升;最晚在第 10 天强制进入 active lane。若第 14 天仍未闭环,应按 SLA 视为 P0 升级目标,并在下一次 triage 中重点处理
  3. added
    priority/p2中优先级 / Medium priority triage bucket.
    and removed
    priority/p3低优先级 / Low priority triage bucket.
    on Nov 13, 2026
  4. XiaoSeS commented on Nov 20, 2026

    @XiaoSeS
    Collaborator

    按维护者确认的本期范围结项。已合并的 PR #1102 交付了:

    • 开源技能按 GitHub 仓库浏览、仓库详情和成员列表;
    • 固定采集快照的历史与对比;
    • 基于可分发、已批准的精确技能版本生成仓库快照 ZIP,包含清单与 SHA-256 校验;
    • 单技能入口继续保留。

    这里采用独立的“仓库+采集快照”模型,不将仓库自动转换为 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    effort/l大改动或高风险改动,需要 maintainer 负责 / Large or risky change requiring maintainer ownership.priority/p2中优先级 / Medium priority triage bucket.risk/high涉及安全、鉴权、迁移或公共契约 / Touches security, auth, migrations, or public contracts.triage/deferred暂留 backlog,由自动化定期重新评分 / Issue stays in backlog and is rescored by automation.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions