Skip to content

[Feature] 审核中心支持批量审批与套件整体审批(可选:仅对 GitHub 同步来源的收窄免审) #1096

Closed

Description

@SAXEM1997

Problem

同步/套件类发布不是"一个一个技能",而是一次一批,但审核中心只能一条一条点。

实测(本部署,2026-11-13):4 个公开仓库一次同步产出 79 个待审版本,全部落在同步审核队列里,必须逐条打开、逐条通过。而它们本质上是 4 个套件——按仓库决策 4 次就够了,逐条审 79 次并没有增加任何治理信息。

更麻烦的是这是持续性的:仓库每 24 小时检查一次 HEAD,上游一有提交就会再产生一批待审。存量 79 条之后,每次增量更新还要重复一次人工点击。

三个具体痛点:

  1. 规模:单仓库可一次产出 39 条(mattpocock/skills);开源生态里上百个技能的仓库并不少见。
  2. 语义错位:同一仓库的成员技能是锁步产物(同一固定 commit、同一次采集),它们的安全性已经由逐包的自动扫描覆盖;人工逐条复核的边际价值很低,但成本是线性的。
  3. 自动化被挡住:API token 访问 /api/v1/reviews/** 一律 403 API token cannot access endpoint,CLI 也没有审核命令。想脚本化批量审批,只能靠"网页会话 + 手工拼 CSRF 头"这种非正式手段——这对运维方既不安全也不稳定。

已有能力其实都在:套件(Suite)、审核队列、同步来源标记(origin=GITHUB_SYNC)——只是没有把它们和审批动作连起来。

Proposed Solution

分三档,建议 A 先落地、B 为主、C 可选且默认关闭:

A. 通用批量审批

  • 审核中心列表支持多选,一次对选中项执行通过/驳回,共用一条审核意见。
  • 底层仍为每条生成独立的 review_task(状态、reviewed_by、时间、意见逐条落库),只是提交动作合并;部分失败要逐条回报失败原因,不能整体静默成功。
  • API:POST /api/v1/reviews/batch-approve({ ids: [], comment }),返回逐条结果。

B. 套件整体审批(重点)

  • 套件作为审批单元:一次决策作用于该套件下 N 个成员版本。
  • 底层仍按成员逐条写审核记录(reviewed_by = 决策人,附套件批次标识),保证每个成员可单独追溯、单独驳回/撤回,套件决策不吞掉个体审计。
  • 前置条件:套件下所有成员的扫描必须已产生结论;任一成员扫描未完成/不安全/超时,则该成员不进入本次批量决策,单独留在队列。
  • UI:套件详情页/审核队列的套件分组卡片上提供「整套通过 / 整套驳回」。

C. 收窄的同步免审(可选,默认关闭)

只在同时满足全部条件时自动通过,否则回落到人工:

  • 来源限定 origin=GITHUB_SYNC(或指定 namespace,如 @github);
  • 采集已固定到具体 commit;
  • 安全扫描结论为"通过"(未完成/超时/不安全一律不自动通过);
  • 许可证证据齐全;
  • 与上一次已批准版本相比无实质性内容变化(纯上游更新)。

同时满足才自动发布,并写入"系统自动批准"审计记录(关联 commit、扫描结论、策略版本)。开关由平台管理员控制,关闭后立即恢复全部人工审核。

D. 配套:给 API token 开放审核路由

若 A/B 不以 API 形式暴露给 token,运维方仍只能用网页会话脚本化——比直接给一个受限的 review scope 更不安全。建议至少为 batch 接口开放一个明确 scope(如 review:write),并限定只能操作自己有权审核的 namespace。

Alternatives Considered

方案 为何不够
维持逐条人工 79 条/批 + 每次增量重复,成本随同步规模线性增长
通用"namespace 免审核"开关 #465 已明确拒绝,范围过大、无差异化条件;本提案只在 C 中收窄到同步来源且带多重前置条件
只给 CLI 加审核命令 CLI 同样走 API token 路由,不放开路由权限仍然 403,等于没解决
靠脚本模拟网页会话 当前唯一可行手段,但依赖 CSRF/会话实现细节,脆弱且难审计
只做批量、不做套件维度 能缓解,但套件是天然的审批单元,丢掉这个维度就只能靠"按时间范围勾选",容易误批

与 #1068(TEAM 受信任 MEMBER 免审)、#1049(token 的 confirm-publish 权限)不同:那两条讨论的是内部发布者的免审边界,本条讨论的是同步产物与套件的批量决策效率;C 档可以复用 #1068 的策略框架,但不替代它。

Impact

  • 数据:审核记录需要关联"批量/套件批次"标识(可为新增可空字段);C 档需要策略表(默认关闭)。
  • 权限:批量操作沿用现有审核权限判定(平台 SKILL_ADMIN/SUPER_ADMIN 或对应 namespace 的 OWNER/ADMIN),不新增越权路径。
  • 安全:任何自动通过都必须以扫描结论为前提,扫描失败绝不自动发布;C 档默认关闭且可一键关停。
  • 兼容:A/B 为纯增量;C 默认关闭,不影响现有部署行为。

Contract Or SDK Impact

  • OpenAPI:新增 batch-approve 与套件审批接口;审核响应增加批次/套件关联字段。
  • CLI:可选新增 skillhub review approve --suite <coordinate> / --ids,依赖服务端 batch 接口;不改变现有发布协议。
  • ClawHub 兼容层:不受影响,审核仍走原流程,只是入口合并。

Activity

  1. added
    triage/deferred暂留 backlog,由自动化定期重新评分 / Issue stays in backlog and is rescored by automation.
    priority/p2中优先级 / Medium 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 (3.3/5)
    • Effort: effort/l (5/5)
    • Confidence: 5/5
    • Risk: high
    • Analysis Mode: rules-only

    Why

    • Touches core SkillHub workflows (publish, review, namespace).
    • Contains urgency signals (cannot).
    • Issue includes operator or product impact details.

    High-Risk Signals

    • Mentions sensitive areas (token, 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 (3.3/5)
    • 修复投入: effort/l (5/5)
    • 信息完整度: 5/5
    • 风险: 高
    • 分析模式: rules-only

    原因

    • 涉及 SkillHub 核心流程(publish, review, namespace)
    • 包含紧急信号(cannot)
    • 包含用户或产品影响说明

    高风险信号

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

    下一步

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

    @XiaoSeS
    Collaborator

    按维护者确认的本期 Web 审核范围结项:

    本次关闭不表示下列提案已实现:真正的 Suite 整体审批、GitHub 来源自动免审、审核 Token 授权及 CLI 审核。这些均未纳入维护者确认的本期范围;若后续推进,需要单独确认权限、扫描前置条件、审计与兼容边界,再拆成明确任务。#1103/#1110 中涉及重复审核分组的部分,应以上述已交付能力为基线。


    Closing against the maintainer-approved Web review scope. Merged PR #1101 delivers bounded batch approve/reject for ordinary and GitHub-synced Skills, retaining per-item results and authorization checks. Merged PR #1107 adds review grouping by immutable repository acquisition snapshot, a dedicated repository review page and independently paged members using the existing batch-decision flow.

    Repository grouping organizes the review workload; it neither creates Suites nor bypasses per-item eligibility and authorization checks.

    This closure does not claim delivery of true Suite-level approval, GitHub-source automatic approval/exemptions, review Token scopes or CLI review commands. Those were outside the approved delivery scope. Any future work needs separate decisions on authorization, scan prerequisites, auditing and compatibility. Review-grouping proposals in #1103/#1110 should use the delivered behavior as their baseline.

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