SuperAPI AI 工具集

review-agent-setup

编程与开发

查看项目

更新于 10-16 07:31

技能介绍

review-agent-setup 是 review-agent-governance 插件的安装与使用配置说明,目标是把 Claude Code 智能体的评审类动作置于人工明确批准之后。

用途:当项目中的 Claude Code 智能体会执行评审、评论、合并 PR(gh pr review、gh pr merge)、分流 Issue(gh issue comment、gh issue close)、发布版本(gh release create)、修改 CI 配置(.github/workflows/、.gitlab-ci.yml)、推送到受保护分支(main、master、release、production),或向外部通知面(Slack webhook、Discord)发布内容(需自行添加对应命令规则,默认策略不拦截这些)时,可安装此插件进行审批管控。如果智能体只做本地文件编辑和运行测试,则此插件属于过度配置,可改用 protect-mcp 做通用工具调用策略执行。

主要能力:把评审类动作挡在显式人工批准之后;每次尝试(无论允许还是拒绝)生成 Ed25519 签名收据;使用 Cedar 策略语言定义规则;允许通过审批窗口(标志文件或斜杠命令)临时放行特定动作;支持强制全量策略评估(dry-run)模式,用于 CI 或锁定审计;提供收据离线验证能力;可与 protect-mcp 组合,两个插件的 PreToolUse 钩子都会在每次工具调用时运行,两者都通过才放行,任一策略拒绝即拦截。

使用方式: 一次性设置:

  1. 安装插件:claude plugin install wshobson/agents/review-agent-governance
  2. 复制默认策略到项目:cp .claude/plugins/review-agent-governance/policies/review-agent-governance.cedar ./review-governance.cedar,可按项目规则编辑。
  3. 创建收据目录和签名密钥:mkdir -p ./review-receipts,并把 /review-receipts/、/review-governance.key、/.review-approved 写入 .gitignore;若密钥不存在,用 npx protect-mcp@0.7.4 init 生成后移动为 ./review-governance.key。protect-mcp 0.7.4 sign 不会创建密钥,因此该命令负责生成且不会覆盖已有密钥;无密钥时收据不带签名。轮换密钥前需先归档密钥和收据文件。公开密钥 publicKey 值可交给审计方,该文件含私钥,不可提交到仓库。 每次会话流程:Cedar 策略默认无条件拒绝评审面动作,需在动作前打开审批窗口、动作后关闭。最简单方式是用标志文件:先 touch ./.review-approved,让 Claude Code 执行评审/评论/合并,随后 rm ./.review-approved。也可在 Claude Code 内使用斜杠命令 /approve-review "原因",它创建带原因说明的 ./.review-approved 并在 ./review-receipts/approvals/ 记录未签名审批日志,仍需后续 rm 关闭窗口。 强制全量策略评估:设置 export REVIEW_APPROVAL_FLAG=./.never-approve 后,所有工具调用都经 Cedar 评估、无审批绕过,匹配 forbid 规则即拒绝,适用于 CI 或锁定审计。 验证收据:用 ls -la ./review-receipts/ 列出收据;读取密钥中的 publicKey 后用 npx @veritasacta/verify@0.9.2 --replay-chain ./review-receipts/receipts.jsonl --key "$PUB" 离线验证全部收据。退出码 0 表示全部通过,1 表示某条收据验证失败(被篡改、密钥错误或行格式错误),2 表示收据文件无法读取。被拒绝的调用不会运行,因此没有收据;可在 Claude Code 内运行 /list-pending 查看当前会话中被 PreToolUse 钩子拦截的工具调用及其工具名和命令或路径。 示例:先用 /list-pending 查看被拦截的调用(如 Bash "gh pr review 42 --approve --body 'LGTM'"),人工确认合适后用 /approve-review "原因" 创建 ./.review-approved,智能体重试即成功并在 ./review-receipts/receipts.jsonl 追加 decision=allow 的收据,最后 rm ./.review-approved 关闭窗口。被允许的调用有可在离线验证的签名收据;被拒绝的尝试没有收据,审批日志也不带签名,审计时需注意。

适用场景:需要人工把关智能体对 PR、Issue、发布、CI 配置、受保护分支或外部通知面操作的项目;需要可审计签名收据的合规或审计环境;多插件组合执行工具调用策略的场景。

限制:默认策略只覆盖评审面动作,不拦截 Slack/Discord 等外部通知面,需自行添加规则;无签名密钥时收据不带签名;审批日志未签名;被拒绝的调用没有收据;仅做本地编辑与测试时不应使用本插件。相关标准包括 Ed25519(RFC 8032)、JCS(RFC 8785)、Cedar 策略语言及 IETF 草案 draft-farley-acta-signed-receipts。