SuperAPI AI 工具集

peer-review

编程与开发

查看项目

更新于 10-16 03:19

技能介绍

Peer Review 是一个用于对进行中的工作进行“全新上下文”审查的技能。它针对暂存改动、分支差异、PR 或一组文件,在不累积会话假设的情况下返回按严重程度分组的审查发现,作者可以自行决定采纳或跳过。

用途

该技能用于在开发过程中获得对未完成工作的独立审查。它不依赖当前会话的上下文,而是将内容交给一个全新的审查者,从而减少既有假设带来的偏差。审查目标可以是暂存改动、未暂存改动、分支差异、PR 或指定文件/目录。

主要能力

  • 支持多种目标:无目标时自动检测暂存/未暂存改动;--staged 仅审查暂存改动;--pr N 审查 PR 差异及描述;--branch NAME 审查分支与默认分支的差异;也可指定文件或目录路径。
  • 支持 --model 选择审查模型:默认 self(当前助手生成全新实例作为审查者);claude-* 使用指定 Claude 模型;copilot[:submodel] 或 codex[:submodel] 路由到外部 CLI。
  • 支持 --focus TOPIC 缩小审查重点(如 security、consistency、evals),但不会抑制重点领域之外的关键发现。
  • 自动检测审查模式:Diff 模式关注 bug、安全问题、缺失测试、风格违规、意外行为变更;Consistency 模式关注相关文件之间的漂移,如过时步骤引用、术语不一致、缺失并行更新、未充分说明项、shell 命令错误、内部数学/计数错误。
  • 审查结果按严重程度分组返回。

使用方式

在 Claude Code 中通过 /peer-review [target] [options] 调用。参数解析从左到右进行,支持 --staged、--pr N、--branch NAME、--model MODEL、--focus TOPIC,剩余 token 视为文件/目录路径。多个目标选择器互斥,同时出现会报错。

使用示例(来自资料):

  • /peer-review --staged
  • /peer-review --pr 123
  • /peer-review --branch feature/foo
  • /peer-review path/to/file
  • /peer-review --model copilot:gpt-4o-mini
  • /peer-review --focus security

外部 CLI 安装命令(资料提供):

  • copilot:npm install -g @github/copilot-cli(或 VS Code 扩展)
  • codex:npm install -g @openai/codex

适用场景

适用于需要在提交前或合并前获得独立审查的开发者,尤其是希望避免当前会话上下文影响判断、或希望将审查委派给外部模型/CLI 的场景。也适用于检查相关文件之间的一致性。

限制与安全说明

该技能处理可能不可信的内容(git diff、PR 正文、文件内容),资料中列出了多项缓解措施:参数校验(--pr 要求正整数,--branch 要求字符白名单)、路径参数不经过 shell、双引号插值、不可信内容边界标记、外部 CLI 分流层、codex 使用 stdin 传输、外部 CLI 上下文隔离、预检密钥扫描、第三方 CLI 来源验证。

残余风险包括:使用 copilot/codex 时内容会发送给第三方厂商;copilot 在非交互模式下不遵守 stdin,其提示通过命令行 -p 传递,可能被本地其他用户通过 ps 或 /proc/<pid>/cmdline 看到;密钥扫描为启发式,可能漏报;审查者仍会消费不可信 diff 内容。

资料还说明本地扫描器(如 snyk-agent-scan)可能基于模式存在而非缓解缺失,标记 W007、W011、W012 三类发现,并解释了这些标记的成因及基线固定方式。

暂未提供

资料未提供该技能的收费、价格、平台支持范围、具体效果数据或完整使用步骤之外的额外信息。