SuperAPI AI 工具集

core-reviewer

测试与质量

查看项目

更新于 10-16 04:08

技能介绍

用途

Core Reviewer 是一个代码审查与质量保障技能,负责以资深代码审查员的角色,通过系统化的审查流程确保代码的质量、安全性与可维护性。它面向需要结构化代码评审的团队,帮助在合并前发现质量问题、安全漏洞和性能瓶颈。

主要能力

该技能按五个维度组织审查工作:

  1. 功能审查:检查代码是否完成预期功能,包括需求是否满足、边界情况是否处理、错误场景是否覆盖、业务逻辑是否正确。
  2. 安全审查:覆盖输入验证、输出编码、身份认证检查、授权验证、敏感数据处理、SQL 注入防护、XSS 防护等安全清单项。
  3. 性能审查:关注算法效率、数据库查询优化、缓存机会、内存使用和异步操作等。
  4. 代码质量审查:检查是否遵循 SOLID、DRY、KISS 原则,命名是否一致,抽象是否恰当。
  5. 可维护性审查:关注命名清晰度、文档完整性、可测试性、模块化和依赖管理。

技能还提供问题优先级分级(严重:安全、数据丢失、崩溃;主要:性能、功能缺陷;次要:风格、命名、文档;建议:改进与优化),以及标准化的审查反馈格式,包含优点、严重问题、建议、指标和行动项等部分。

使用方式

通过 Task 调用审查代理,例如:

Task("Reviewer agent", "Review [code/PR] for quality, security, and performance", "reviewer")

审查发现可通过内存存储工具记录,例如:

{
  action: "store",
  key: "swarm/reviewer/findings",
  namespace: "coordination",
  value: JSON.stringify({ agent: "reviewer", issues: [], recommendations: [] })
}

技能建议先运行自动化检查(lint、test、security-scan),再进行人工审查,并按执行清单逐步推进:运行自动化检查、审查功能与需求覆盖、检查安全漏洞、分析性能影响、验证代码质量、检查可维护性与文档、对问题分级、将发现存入内存、提供建设性反馈。

技能还提供与 MCP 工具的集成方式,用于上报审查状态、共享审查发现和查询实现细节,并可使用代码分析工具执行代码质量分析与安全扫描。

适用场景

  • 合并前审查拉取请求(PR)
  • 审计代码中的安全漏洞
  • 分析性能瓶颈
  • 确保遵循编码标准
  • 验证文档完整性

使用前提包括:有待审查的代码或 PR、可访问编码标准文档、理解项目架构、具备安全检查清单参考。

限制

技能文档未说明具体支持的编程语言范围、与版本控制平台的具体集成方式、自动化检查工具的具体配置要求,以及定价或收费信息,这些内容暂未提供。实际使用效果可能取决于项目环境、团队标准和所接入工具链的可用性。