pr-review

🔍 本地智能代码审查与自动修复

基于多代理并行分析的本地代码预审工具,可在提交前自动发现并修复安全漏洞与代码缺陷,确保代码质量。

收藏
13.6k
安装
3.7k
版本
v2.0.1
CLS 安全性认证2026-05-01
点击查看完整报告 >

使用说明

核心用法

该 Skill 提供革命性的Pre-Review(预审查)能力,将传统 PR 发布后的评论-修复循环前移至本地开发阶段。它支持两种工作模式:Diff 模式针对当前分支与主分支的变更进行精准审查,自动识别变更文件并聚焦增量代码;Audit 模式则可对指定目录、文件模式或整个代码库进行深度安全审计。通过并行启动 5 个 Sonnet 代理,分别从规范合规、Bug 扫描、Git 历史回溯、安全与性能、质量与测试五个维度进行专业分析,并根据置信度评分(Diff 模式 ≥70,Audit 模式 ≥80)直接自动修复代码问题。

显著优点

左移审查时机是最大创新,避免 PR 发布后的低效往返沟通,实现"分析-修复-发布干净代码"的一站式流程。并行多代理架构确保审查维度全面性,覆盖从代码风格到安全漏洞的完整谱系,避免人工审查的视角盲区。智能自动修复功能直接修改高置信度问题,减少开发者重复劳动,同时保留低置信度问题的人工审查入口。此外,文件风险优先级分类(高/中/低)确保认证、支付等关键路径获得重点审查。

潜在缺点与局限性

作为 T3 级别社区项目,其长期维护稳定性和企业级支持不如官方商业工具。自动修改代码虽高效,但可能对复杂业务逻辑产生误判,存在过度修正风险。重度依赖 Git 环境,无版本控制的项目完全无法使用。对于非标准项目结构,指南发现能力(CLAUDE.md、ESLint 配置等)可能受限。此外,并行运行 5 个 Sonnet 代理在大型代码库上可能消耗较多计算资源和时间。

适合的目标群体

主要面向注重代码质量的开发者追求效率的敏捷团队,特别是希望减少 PR 审查往返时间的技术团队。适合作为 CI/CD 流程的本地前置关卡,在提交前进行快速自检。安全工程师可利用 Audit 模式进行深度代码审计,开源维护者可用其确保贡献者代码符合项目规范。

使用风险与注意事项

自动修改代码是首要风险,尽管有置信度阈值控制,仍强烈建议在运行前确保所有变更已提交或备份,避免不可逆的代码丢失。修复后必须运行完整测试验证行为一致性,防止"修复"引入新 Bug。该 Skill 会执行 Git 命令并读取项目文件,需确保在可信环境中使用。对于生产环境关键系统,不建议完全依赖自动修复,应将 Auto-fix 结果视为建议而非最终代码。

安全解读

核心用法

pr-review 是一款前置式代码审查工具,颠覆传统"先发布 PR 再修复评论"的循环。它在本地分析代码变更,直接修复问题后发布干净的 PR。支持两种模式:

  • Diff 模式(默认):审查当前分支 vs main/master 的变更,自动修复置信度 ≥70 的问题,适合 PR 前自检
  • Audit 模式:审查指定路径或全代码库,自动修复置信度 ≥80 的问题,适合安全审查和代码库健康检查

命令示例:

  • /pr-review — 审查当前分支变更
  • /pr-review src/api/ — 审计指定目录
  • /pr-review --audit — 全库审计

显著优点

并行深度分析:启动 5 个 Sonnet Agent 同时扫描,覆盖代码规范合规性、真实 Bug、Git 历史回归、安全漏洞与性能问题、测试与代码质量五大维度,效率远超人工单点审查。

智能自动修复:高置信度问题直接修改代码,低置信度问题人工判断,避免"修复疲劳"。Diff 模式 ≥70、Audit 模式 ≥80 才自动修复,策略保守可控。

项目规范感知:自动读取 CLAUDE.md、.eslintrc、tsconfig.json 等配置文件,确保审查贴合项目实际约定,而非套用通用规则。

安全审计专用:Audit 模式针对高危文件(认证、支付、数据库查询)优先深度扫描,输出安全摘要(硬编码凭证、注入风险、XSS 漏洞等)。

潜在缺点与局限性

依赖 Git 环境:必须安装 Git,且需基于 main/master 分支对比,对非 Git 项目或特殊分支策略不友好。

子 Agent 资源消耗:5 个并行 Sonnet Agent 对本地计算资源和 Token 消耗较大,大型代码库审查可能触发上下文限制。

自动修复风险:尽管有置信度门槛,仍存在误修改可能,必须在 Git 保护下使用。不支持需要架构级改动的复杂问题。

语言中立性未明确:文档未指定优先支持语言,对特定生态(如 Python 类型检查、Rust 内存安全)的深度规则覆盖程度未知。

适合人群

  • 个人开发者:PR 前快速自检,减少被 Review 时的尴尬修正
  • 团队 Tech Lead:批量审计代码库安全债务,建立质量基线
  • 开源贡献者:确保贡献代码符合项目规范,提升合并通过率
  • 安全工程师:快速扫描高危模块,识别注入、凭证泄露等风险

常规风险

1. 代码修改风险:自动修复可能改变代码意图,建议始终先 git commit 再运行,事后 git diff 审查
2. 敏感代码泄露感知:子 Agent 会处理代码内容,虽无外传,但极度敏感代码环境需谨慎评估

3. 修复阈值误判:70/80 分阈值可能漏判边缘问题,重要代码建议人工复核所有输出

pr-review 内容

plugins文件夹
pre-review文件夹
commands文件夹
手动下载zip · 15.0 kB
CLAUDE.mdtext/markdown
请选择文件