Repository navigation
Description
Problem
同步/套件类发布不是"一个一个技能",而是一次一批,但审核中心只能一条一条点。
实测(本部署,2026-11-13):4 个公开仓库一次同步产出 79 个待审版本,全部落在同步审核队列里,必须逐条打开、逐条通过。而它们本质上是 4 个套件——按仓库决策 4 次就够了,逐条审 79 次并没有增加任何治理信息。
更麻烦的是这是持续性的:仓库每 24 小时检查一次 HEAD,上游一有提交就会再产生一批待审。存量 79 条之后,每次增量更新还要重复一次人工点击。
三个具体痛点:
- 规模:单仓库可一次产出 39 条(
mattpocock/skills);开源生态里上百个技能的仓库并不少见。 - 语义错位:同一仓库的成员技能是锁步产物(同一固定 commit、同一次采集),它们的安全性已经由逐包的自动扫描覆盖;人工逐条复核的边际价值很低,但成本是线性的。
- 自动化被挡住: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
github-actions commentedon Nov 13, 2026
Issue Triage
triage/deferredpriority/p2(3.3/5)effort/l(5/5)5/5highrules-onlyWhy
High-Risk Signals
Next Action
问题分流结果
triage/deferredpriority/p2(3.3/5)effort/l(5/5)5/5高rules-only原因
高风险信号
下一步
XiaoSeS commentedon Nov 20, 2026
按维护者确认的本期 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.