SuperAPI AI 工具集

review

编程与开发

查看项目

更新于 10-16 04:23

技能介绍

用途

review 是一个多智能体代码审查命令,用于在提交代码前自动检测质量、安全以及领域特定问题。它通过并行运行多个专门的审查代理,结合置信度评分与假阳性过滤,输出一份去重后的综合审查报告。

主要能力

  • 并行代理执行:同时启动多个独立审查代理以提升速度。
  • 置信度评分:所有发现项附带 0-100 的置信度分数,≥80% 才会被报告。
  • 假阳性过滤:排除已有问题、lint 可捕获问题、带 lint-ignore 注释的代码等。
  • 自动去重:合并多个代理的相同发现。
  • 分类严重级别:🔴 Critical(置信度≥90%,必须合并前修复);🟡 Important(置信度≥80%,应在合并前修复)。

内置审查代理

  1. 核心审查员(han-core:code-reviewer,始终运行):关注正确性、安全性、可维护性、可测试性、性能、编码规范。
  2. 安全审查员(security:security-engineer,始终运行):检查输入验证、SQL 注入、XSS/CSRF、认证授权、密钥管理、API 安全、依赖漏洞等。
  3. 领域特定审查员(自动选择):根据变更文件自动匹配代理:
    • *.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

工作流程

  1. 准备:通过 git diff --stat main...HEAD、git diff main...HEAD、git log main...HEAD --oneline 收集变更上下文。
  2. 并行审查:在单次消息中发起多个 Task 调用,同时运行核心、安全及领域特定代理。
  3. 整合:收集所有问题、去重、过滤置信度≥80%、按严重程度分类并格式化 file:line 引用。
  4. 报告:输出综合审查摘要,包含变更文件数、增删行数、代理数量、发现项列表、验证状态、决策(如 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 审查自动化(配合 gh CLI)。

限制

  • 置信度 <80% 的问题默认不报告。
  • 不报告已有问题、lint 可捕获问题、带 lint-ignore 注释的代码、无文档标准的风格偏好以及无证据的理论担忧。
  • 若自动检测错误,可手动指定代理。
  • 冗余审查模式仅在至少 2 个审查员同意时才报告问题。
  • 其他更多功能、平台兼容性、收费信息暂未提供。