社区子代理集合里的评审类 Agent 通常有个通病:清单又长又散,看起来覆盖一切,实际上没有优先级、没有输出契约,模型跑完不知道该报什么。awesome-claude-code-subagents 里的 code-reviewer 是这类设计的集大成者:十一个评审维度的清单矩阵加三阶段工作流,一个 Agent 覆盖代码质量、安全、性能、设计模式、测试、文档、依赖、技术债、语言特化与评审自动化——瑞士军刀式定义的典型样本。本文按"定位 → 清单矩阵 → 工作流与输出 → 提示词工艺 → 总结"拆解这份子代理定义。
1、定位:全维度高级代码评审员
提示词开篇定义人设:"senior code reviewer with expertise in identifying code quality issues, security vulnerabilities, and optimization opportunities across multiple programming languages"——多语言高级评审员,关注正确性、性能、可维护性与安全四条主线,强调建设性反馈与最佳实践执行。
frontmatter 两个字段值得注意:tools: Read, Write, Edit, Bash, Glob, Grep——六件工具全开,包括写与执行。这意味着它不只是评审者,还能直接改代码、跑命令验证,是个"评审加修复"一体的重型代理;model: inherit 跟随宿主档位。
被调用时的四步开场:向上下文管理器查询评审需求与标准 → 评审代码变更、模式与架构决策 → 分析质量 / 安全 / 性能 / 可维护性 → 给出可执行的反馈。第一步的"context manager"是 VoltAgent 生态里的一个约定角色(负责项目上下文管理),显示这套代理被设计为团队协作网络的成员而非孤立个体。
2、十一维清单矩阵
提示词的主体是十一个维度的检查清单,每个维度 8 个条目——88 项检查构成一张评审矩阵。
评审检查单(8 项硬指标):零关键安全问题、覆盖率 > 80%、圈复杂度 < 10、无高危漏洞、文档完整、无重大代码异味、性能影响已验证、最佳实践一致遵循——这一段是唯一带量化阈值的,相当于整个 Agent 的验收标准。
其余十个维度各管一摊:
| 维度 | 覆盖内容(节选) |
|---|---|
| 代码质量 | 逻辑正确性 / 错误处理 / 资源管理 / 命名 / 组织 / 复杂度 / 重复 / 可读性 |
| 安全评审 | 输入校验 / 认证 / 授权 / 注入 / 密码学 / 敏感数据 / 依赖扫描 / 配置安全 |
| 性能分析 | 算法效率 / 数据库查询 / 内存 / CPU / 网络调用 / 缓存 / 异步模式 / 资源泄漏 |
| 设计模式 | SOLID / DRY / 模式适切性 / 抽象层级 / 耦合 / 内聚 / 接口设计 / 可扩展性 |
| 测试评审 | 覆盖率 / 质量 / 边界 / mock 使用 / 隔离 / 性能测试 / 集成测试 / 文档 |
| 文档评审 | 注释 / API 文档 / README / 架构文档 / 示例 / 变更日志 / 迁移指南 |
| 依赖分析 | 版本管理 / 安全漏洞 / 许可合规 / 传递依赖 / 体积影响 / 替代方案 |
| 技术债 | 代码异味 / 过时模式 / TODO / 弃用用法 / 重构需求 / 现代化机会 |
| 语言特化 | JS/TS 模式 / Python 惯用法 / Java 规范 / Go / Rust 安全 / C++ 标准 / SQL 优化 / Shell 安全 |
| 评审自动化 | 静态分析集成 / CI/CD 钩子 / 自动建议 / 评审模板 / 指标追踪 / 团队仪表盘 / 质量门禁 |
横向看,这是一张"评审该想什么"的完整地图;纵向看,每个维度 8 条的等分设计保证了均匀覆盖。但它与官方 pr-review-toolkit 的分寸差异立现:官方把同样的领域拆成五个独立 Agent(comment / test / type / silent-failure / 评审),每个带量表与输出契约;这里则一锅烩——广度换深度,88 条清单没有一条告诉模型"发现问题后按什么格式报、报几条、怎么排优先级"。
3、三阶段工作流与输出
工作流分三段,每段带自己的清单。
阶段一:评审准备——变更范围分析、标准识别、上下文收集、工具配置、历史评审、关联 issue、团队偏好、优先级设定。
阶段二:实施评审——系统性分析、安全优先、验证正确性、评估性能、评审可维护性、验证测试、检查文档、给出反馈。评审模式也定了规矩:从高层入手、聚焦关键问题、给具体示例、承认好的实践、保持建设性、反馈排优先级。
这一阶段内嵌了两个 JSON 片段:一个是"上下文查询"协议(向 context manager 要评审标准),一个是进度追踪协议——files_reviewed: 47, issues_found: 23, critical_issues: 2, suggestions: 41。结构化进度上报是个好设计,宿主可以据此展示"评审到第几个文件"。
阶段三:交付卓越——一份"完成通知"模板:"Reviewed 47 files identifying 2 critical security issues and 23 code quality improvements... Overall code quality score improved from 72% to 89% after implementing recommendations." 这段示例给出了输出的目标形态(数字化的总结陈词),但只是通信模板而非强制契约。收尾还列了与其他八个代理的协作关系(security-auditor、architect-reviewer、performance-engineer 等),再次强调团队网络定位。
4、提示词工艺
量化验收前置。88 条清单里唯一的硬数字全部集中在开头检查单(覆盖率 > 80%、复杂度 < 10、零关键安全)——把验收标准放在清单之首,模型与人类都能第一时间对齐"什么算过"。这个手法值得学:先给阈值,再给维度。
进度协议内嵌。JSON 进度追踪让长评审可观测,弥补了子代理在隔离上下文里运行时宿主"看不见进度"的短板——结构化上报是对 Claude Code 子代理机制的一个实用补丁。
协作网络式设计。定义里显式声明与 qa-expert、security-auditor 等八个代理的分工关系,这超出了单 Agent 提示词的常规内容——它在把整个仓库的 100+ 代理当作一个系统来设计,单份定义是系统的接口文档。
短板也同样明显:广度碾压深度。88 条无差别的清单稀释了模型注意力,缺少"每个发现按什么格式报、严重度怎么定、最多报几条"的输出契约——对比官方 pr-test-analyzer 的十级量表、silent-failure-hunter 的七段式报告,这份定义的输出形态几乎全靠模型自由发挥。直接用的话,建议在 CLAUDE.md 里补一份输出模板约束它。
5、总结
code-reviewer 是 VoltAgent 子代理集合中的旗舰评审代理:十一维 88 条检查清单覆盖质量、安全、性能、设计、测试、文档、依赖、技术债、语言特化与自动化,开头带量化验收(覆盖率 > 80% / 复杂度 < 10 / 零关键安全),三阶段工作流内嵌 JSON 进度追踪与交付通知模板,六件工具全开支持"评审 + 修复"一体,并与仓库内其他八个代理声明协作关系——一份团队网络式设计的瑞士军刀。
它适合两类场景:单发大评审——想一次调用拿到全维度扫描报告时,它的广度无可替代;以及当模板底稿——十一维清单是绝佳的"评审该查什么"备忘录,裁剪成自己项目的检查单很省事。边界方面:无输出契约导致结果形态不稳定,重要评审建议配输出模板;工具全开(含 Bash)在生产环境有权限风险,可按需裁剪 tools 白名单;与官方 pr-review-toolkit 相比深度不足——精评安全用 silent-failure-hunter、评测试用 pr-test-analyzer、评类型用 type-design-analyzer,各取所长比指望一个代理包打天下更实际。作为社区大而全风格的代表作,它的价值在于宽度与清单本身,而非评审深度。


