SuperAPI AI 工具集

review-clawhub-profile-proposal

部署与运维

查看项目

更新于 10-16 03:06

技能介绍

用途:供 OpenClaw 维护者或所有者审查公开 PR 中提出的候选 ClawHub 恶意技能档案(proposals/<GHSA-ID>/clawscan.yml),该提案源于私密漏洞报告。目标是验证候选档案、保护敏感细节,并在接受后将公开档案行为合入 internal/profiles/clawhub/clawscan.yml。

主要能力与流程:

  • 安全检查:私密漏洞报告是敏感恶意技能细节的唯一来源;不得将漏洞利用细节、私密报告文本、私密产物或可疑技能载荷粘贴到公开 PR 评论、文档、提交信息或基线摘要中;不要运行可疑技能,ClawScan 只把技能文件当数据处理。
  • 审查仓库与 PR 状态:编辑前检查 git status --short --branch,拉取 PR 分支并查看变更文件,确认公开 PR 初始仅含 proposals/<GHSA-ID>/clawscan.yml 及维护者门控产生的基线摘要提交。
  • 确认提案定义 clawhub 档案,且尚未编辑内置档案文件 internal/profiles/clawhub/clawscan.yml、internal/profiles/clawhub/prompt.md、internal/profiles/clawhub/output.schema.json。
  • 验证候选档案:优先使用 GitHub Actions 工作流 SkillTrustBench Profile Gate,传入 PR 编号与提案路径;本地可用 clawscan benchmark SkillTrustBench --ids https://huggingface.co/datasets/cuhk-zhuque/SkillTrustBench-results/resolve/main/data/evaluation_subset_10pct.jsonl --config proposals/<GHSA-ID>/clawscan.yml --profile clawhub --output ./artifacts/skilltrustbench-candidate.json。--ids 公开子集与 --limit、--offset 互斥。
  • 检查基准产物:需为完整 JSON 并保留为产物;benchmark.id 为 cuhk-zhuque/SkillTrustBench,benchmark.split 为 benchmark,idsCount 为 556,idsSha256 匹配 903a036e4b7b16ee28e22d5d9db57a00b3764cfe41e43144acad67921e5196c2;scanner 与 judge 状态可接受,指标无不接受回退,候选能捕获私密报告行为。
  • 更新基线:用 go run ./scripts/update-skilltrustbench-baseline --artifact ./artifacts/skilltrustbench-candidate.json --output benchmarks/skilltrustbench-leaderboard-10pct/<YYYY-MM-DD>.json --profile clawhub --profile-source proposals/<GHSA-ID>/clawscan.yml --subset-case-ids-sha256 903a036e4b7b16ee28e22d5d9db57a00b3764cfe41e43144acad67921e5196c2 --workflow-url <workflow-url>。合并后最新日期 JSON 即最新已接受基线,无需合并后重跑。
  • 决定:拒绝则公开说明非敏感理由,细节留在私密报告,不改内置档案;接受则将公开行为合入 internal/profiles/clawhub/clawscan.yml,并在同一 PR 添加基线,按指示保留或移除提案文件(默认保留),prompt/schema 变更由维护者掌控。
  • 验证:go test -count=1 ./...、go vet ./...、go run ./cmd/clawscan profiles -v、go run ./cmd/clawscan --help;晋升后基准证明用 clawscan benchmark SkillTrustBench --ids <上述子集> --profile clawhub --output ./artifacts/skilltrustbench-clawhub.json。仅在明确接受时使用更小证明。

适用场景:OpenClaw 维护者处理 ClawHub 恶意技能档案提案 PR 时的审查、验证、晋升与举证。

限制与注意:私密报告不得公开引用;不得信任未审查的提案;晋升前须私密报告、提案 diff、基准证明三者一致;普通晋升提交不包含私密产物、恶意载荷细节或生成的 dist/ 输出,除非 issue 明确要求。交接需给出 verdict、提案路径与 PR/ref、已查私密报告(不含敏感细节)、基准命令与产物位置、基线状态、内置档案变更、验证命令与结果、提交 SHA 或未提交原因、残余风险与下一步负责人。