Appearance
Everything Claude Code Code Reviewer Agent 是一款专为 AI 编程助手生态（如 Claude Code、Codex、Cursor）打造的专业代码审查代理，负责在每次代码变更后自动或手动执行高标准的代码质量、安全性和可维护性检查。相比直接对话 Claude，使用专属 code-reviewer agent 能确保每次审查流程系统、可控、无遗漏，极大提升团队协作与代码基线安全，是生产环境不可或缺的核心 Agent。
Everything Claude Code Code Reviewer Agent：代码质量、安全性与可维护性专业审查代理
在现代 AI 辅助编程环境中，如何确保自动生成或修改的代码始终符合高标准的质量、安全和可维护性要求？Everything Claude Code（ECC）中的 Code Reviewer Agent 正是为此而生。它不仅弥补了直接与 Claude 聊天时审查流程易遗漏、标准不统一、难以批量落地等痛点，更通过自动化、结构化的审查机制，成为生产级 AI 编程插件体系的基石。
1. Code Reviewer Agent 是什么？解决什么问题？
Code Reviewer Agent 是 ECC 插件体系中的核心专业代理，专职负责代码质量、安全性和可维护性的深度审查。它的设计目标是：
- 每次代码变更后自动/手动触发，系统性发现潜在问题
- 严格执行安全、质量、风格等多维度的审查清单
- 输出结构化、分级（CRITICAL/HIGH/MEDIUM/LOW）的审查报告
- 保障团队协作和 AI 生成代码的生产可用性
与直接对 Claude 说“帮我看看这段代码”相比，专用的 code-reviewer agent 能做到：
- 流程标准化：始终遵循统一 checklist，不会遗漏关键安全点
- 自动聚合上下文：自动读取 diff、commit 历史、相关文件，避免只看片段导致误判
- 信心阈值过滤：只报告高置信度问题，减少噪音
- 结构化输出：按严重级别、文件、行号、修复建议分组，便于后续自动化和团队协作
- 与其他 Agent 协作：可串联 security-reviewer、tdd-guide、build-error-resolver 等，实现完整开发闭环
ECC 的 Agent-First 原则（详见Everything Claude Code 完全指南）要求所有代码变更必须经过 code-reviewer agent 审查，尤其在 AI 生成代码、多人协作、CI/CD 流水线等场景下尤为关键。
2. Code Reviewer Agent 能做什么？不能做什么？
能做的：
- 自动收集代码变更上下文（
git diff --staged、git diff、git log），全局感知改动范围 - 多维度深度审查：
- 安全（如硬编码密钥、SQL 注入、XSS、认证缺失等）
- 代码质量（函数/文件过大、嵌套过深、死代码、缺少测试等）
- 前端/React/Next.js 专项（依赖数组、key、状态管理等）
- 后端/Node.js 专项（输入校验、限流、N+1 查询、错误泄漏等）
- 性能与最佳实践（算法复杂度、缓存、bundle size、命名规范等）
- 分级报告（CRITICAL/HIGH/MEDIUM/LOW），每个问题包含文件、行号、描述与修复建议
- 项目规范适配：自动读取
CLAUDE.md或 rules，适配项目特定约定 - AI 代码生成专属补充：特别关注行为回归、安全假设、架构漂移等 AI 生成常见风险
- 与其他 Agent 并行协作，如安全审查、测试覆盖、自动修复等
不能做的：
- 不负责自动修复（修复需配合其他 agent 或人工介入）
- 不覆盖业务逻辑正确性（仅聚焦通用质量与安全，业务需求需结合 Planner/Architect 等 Agent）
- 不会输出无把握的建议（仅报告>80%置信度问题，减少误报）
- 不会覆盖未变更代码的非关键问题（只标记 CRITICAL 级别的历史安全隐患）
3. 触发方式：自动与手动调用
Code Reviewer Agent 支持自动触发与手动调用两种模式：
- 自动触发：在每次代码保存、提交（pre-commit hook）、PR 创建、CI/CD 流水线等关键节点，自动激活 code-reviewer agent，保障每次变更都被审查。
- 手动调用：开发者可在任意时刻，通过命令面板、快捷键或插件命令显式调用 code-reviewer agent，针对特定文件、diff 或 commit 进行即时审查。
例如，安装 ECC 后，保存文件时会自动触发 Plankton Code Quality Skill 联动 code-reviewer agent 进行 Lint+AI 审查；在 PR 阶段，也可通过命令行或 UI 一键发起全量审查。
4. 与其他 Agent 的协作模式
Code Reviewer Agent 并非孤立工作，而是 ECC 多 Agent 协作体系中的关键一环，常见组合包括：
- 与 Security Reviewer Agent 串联：code-reviewer 发现安全疑点后，自动派发给 security-reviewer 做专项漏洞扫描与修复建议
- 与 TDD Guide Agent 配合：如 code-reviewer 检查到测试覆盖不足，可联动 tdd-guide 自动生成/补全测试用例
- 与 Build Error Resolver Agent 协作：code-reviewer 检查通过后，自动触发 build-error-resolver 验证构建无误
- 与 Rules/Skills/Hook 体系集成：结合 Rules 体系 强制项目规范，或用 Hooks 实现自动化审查与通知
- 在多 Agent 并行模式下，与语言专属 reviewer（如 typescript-reviewer、python-reviewer）协同，提升跨栈代码一致性
这种协作模式让每一次代码变更都能自动经过“安全—质量—测试—构建”全链路闭环，极大提升 AI 编程助手的专业生产力。
5. 实际使用示例：一场完整的对话
假设你刚完成一段 TypeScript 代码的重构并准备提交：
步骤 1：自动触发或手动调用 code-reviewer agent
bash
# 自动触发（保存/提交时）
git add .
git commit -m "refactor: 优化用户数据处理流程"
# ECC 自动激活 code-reviewer agent或
bash
# 手动调用
ecc agent code-reviewer步骤 2：Agent 自动收集上下文并输出结构化报告
plaintext
[HIGH] 未处理的 Promise 拒绝
File: src/user/service.ts:87
Issue: 存在未捕获的异步错误，可能导致进程崩溃。
Fix: 使用 try/catch 或 .catch() 处理所有异步操作。
[MEDIUM] processUsers 函数嵌套过深
File: src/user/utils.ts:15-68
Issue: 嵌套超过 4 层，影响可读性和后期维护。
Fix: 拆分为多个小函数，使用早返回优化结构。
## Review Summary
| Severity | Count | Status |
|----------|-------|--------|
| CRITICAL | 0 | pass |
| HIGH | 1 | warn |
| MEDIUM | 1 | info |
| LOW | 0 | note |
Verdict: WARNING — 1 HIGH 问题建议修复后再合并。步骤 3：根据建议修复，再次触发 code-reviewer agent，直至无 CRITICAL/HIGH 问题
步骤 4：如有安全疑点，自动派发 security-reviewer agent 进行深度安全检查
步骤 5：通过后进入测试、构建、文档等后续自动化流程
这种结构化、标准化的流程，远比“直接问 Claude”更专业、更可靠，也便于团队协作和自动化集成。
6. 为什么不用直接问 Claude，而要用专门的 code-reviewer agent？
- 流程不可控：直接提问 Claude，审查内容和深度全靠 prompt，容易遗漏关键安全点或质量项
- 上下文有限：Claude 单轮对话难以自动聚合 diff、commit、项目规则等多源上下文，易产生片面结论
- 输出不可结构化：手动对话输出难以自动分级、统计、集成进 CI/CD 或团队协作流程
- 无法与其他 Agent 串联：缺乏自动派发安全审查、测试补全、自动修复等多 Agent 协作能力
- 无法强制规范：团队无法保证每次变更都被严格审查，容易形成“漏网之鱼”
ECC 的 code-reviewer agent 通过 Agent-First 设计，彻底解决上述痛点，成为 AI 辅助编程的“质量守门员”。
7. 常见问题与注意事项
Q: code-reviewer agent 会不会漏掉业务逻辑上的 Bug？
A: 它聚焦于通用质量、安全、可维护性，业务正确性需结合 planner/architect 等 Agent 或人工评审。
Q: 审查结果可以自动修复吗？
A: code-reviewer agent 只负责发现和报告问题，自动修复可结合 refactor-cleaner、tdd-guide、build-error-resolver 等其他 Agent 实现。
Q: 如何适配项目自定义规范？
A: agent 会自动读取 CLAUDE.md 或项目 rules，适配团队特定约定；如需扩展可参考 Rules 体系详解。
通过 Code Reviewer Agent，AI 编程助手不再只是“生成代码的工具”，而是成为生产级开发流程中不可替代的专业质量守门员。想要系统性提升 AI 辅助开发效率，建议结合 ECC 的Skills、Hooks、Subagents、MCP 配置全面集成 code-reviewer agent，打造安全、可控、可演进的智能研发体系。