用途
review 是一个多智能体代码审查命令,用于在提交代码前自动检测质量、安全以及领域特定问题。它通过并行运行多个专门的审查代理,结合置信度评分与假阳性过滤,输出一份去重后的综合审查报告。
主要能力
- 并行代理执行:同时启动多个独立审查代理以提升速度。
- 置信度评分:所有发现项附带 0-100 的置信度分数,≥80% 才会被报告。
- 假阳性过滤:排除已有问题、lint 可捕获问题、带 lint-ignore 注释的代码等。
- 自动去重:合并多个代理的相同发现。
- 分类严重级别:🔴 Critical(置信度≥90%,必须合并前修复);🟡 Important(置信度≥80%,应在合并前修复)。
内置审查代理
- 核心审查员(han-core:code-reviewer,始终运行):关注正确性、安全性、可维护性、可测试性、性能、编码规范。
- 安全审查员(security:security-engineer,始终运行):检查输入验证、SQL 注入、XSS/CSRF、认证授权、密钥管理、API 安全、依赖漏洞等。
- 领域特定审查员(自动选择):根据变更文件自动匹配代理:
*.tsx, *.jsx, *.css→ frontend:presentation-engineer(UI/UX、可访问性、响应式)**/api/**, **/controllers/**→ backend:backend-architect(API 设计、可扩展性、错误处理)**/db/**, **/*schema*→ databases:database-designer(查询优化、迁移、索引)**/test/**, **/*.test.*→ quality:test-architect(测试质量、覆盖率)**/infra/**, *.tf→ infrastructure:devops-engineer(基础设施、部署、配置)
使用方式
- 审查当前分支:
/review - 审查指定 PR:
/review pr 123 - 指定代理审查:
/review --agents security,performance - 审查指定文件:
/review src/services/payment.ts - 冗余审查:
/review --redundant(对高风险代码运行多个审查员,共识逻辑:≥2 个审查员同意才报告) - 历史上下文审查:
/review --with-history - 自定义代理团队:
/review --team security-critical
工作流程
- 准备:通过
git diff --stat main...HEAD、git diff main...HEAD、git log main...HEAD --oneline收集变更上下文。 - 并行审查:在单次消息中发起多个 Task 调用,同时运行核心、安全及领域特定代理。
- 整合:收集所有问题、去重、过滤置信度≥80%、按严重程度分类并格式化
file:line引用。 - 报告:输出综合审查摘要,包含变更文件数、增删行数、代理数量、发现项列表、验证状态、决策(如 REQUEST CHANGES)及后续行动。
配置
在 .claude/settings.json 中可配置:
{
"review": {
"confidenceThreshold": 80,
"autoSelectAgents": true,
"enableRedundancy": false,
"includeHistory": false,
"maxIssuesPerCategory": 10
}
}
审查代理还会检查 CLAUDE.md、CONTRIBUTING.md、.github/PULL_REQUEST_TEMPLATE.md 以获取项目标准。
适用场景
- 创建 PR 前自动审查代码。
- 作为
/feature-dev工作流第 6 阶段(Review)的一部分。 - 在提交前运行
/review,修复后再次运行直至无高置信度问题。 - PR 审查自动化(配合
ghCLI)。
限制
- 置信度 <80% 的问题默认不报告。
- 不报告已有问题、lint 可捕获问题、带 lint-ignore 注释的代码、无文档标准的风格偏好以及无证据的理论担忧。
- 若自动检测错误,可手动指定代理。
- 冗余审查模式仅在至少 2 个审查员同意时才报告问题。
- 其他更多功能、平台兼容性、收费信息暂未提供。