SuperAPI AI 工具集

nerd-review

编程与开发

查看项目

更新于 10-14 13:24

技能介绍

Nerd Review 是一个专注于代码审查的技能,适用于审查现有代码、实现、拉取请求或指定范围。它强调在不进行任何修改的前提下,提供基于技术栈的检查和按严重程度排序的发现。

用途

Nerd Review 用于对已有代码或变更进行审查,识别问题并按严重程度报告。它不修改被审查的产物,也不编写实现代码。审查类型需明确选择一种:普通审查(审查指定产物或当前状态及必要上下文)或拉取请求审查(审查从基础到头部的差异,仅报告由该差异引入或实质性恶化的问题)。

主要能力

  • 技术栈映射:根据项目清单、锁文件、导入、构建、生成产物和配置自动检测技术栈,并加载最小匹配的参考集。支持 Kotlin、Java、Python、Ruby、TypeScript、JavaScript、Docker、Kubernetes、Terraform、Redis、MySQL、PostgreSQL、Go、Rust 等。框架映射包括 Spring Boot、jOOQ、FastAPI、Ruby on Rails、Sidekiq、React、gRPC,需与其技术栈配对使用。
  • 审查层级:分为三级。一级检查语法、编译或类型失败及具体代码异味;二级检查仓库一致性、测试覆盖率和文档;三级检查不良架构、有害复杂度和设计模式违规。需完成一级后才能进行更高级别的推理,最终发现按严重程度排序。
  • 严重程度:根据影响和可达性独立于审查层级分配严重程度,分为严重、高、中、低。需证明可达性、触发条件、影响和爆炸半径,并使用最低支持的严重程度。
  • 证据与报告:确认问题为新出现、可触达且未在其他地方处理。报告时去重共享原因,仅报告通过对抗性证据检查的发现。报告格式包括严重程度、具体标题、位置、审查级别、证据、影响和修正方向。发现应放在最前,按严重到低排序,再按爆炸半径排序。

使用方式

使用 Nerd Review 时,需明确审查类型(普通或拉取请求审查),并指定审查范围。工具会自动检测技术栈并加载相应参考集。审查过程中,优先使用仓库包装器和窄范围、非修改性检查。检查命令副作用,一次性构建或测试输出可接受。禁止运行格式化工具、自动修复、生成器、迁移、部署或修改性请求。审查结束后停止,仅确认端点变更通过 Smart。

适用场景

适用于需要在不修改代码的情况下进行代码审查的场景,包括审查现有代码、实现、拉取请求或指定范围。特别适合需要按技术栈进行针对性检查、按严重程度排序发现并确保问题证据充分的情况。

限制

  • 不执行任何修改操作,包括格式化、自动修复、生成、迁移、部署或修改性请求。
  • 不修改被审查的产物或编写实现代码。
  • 不得与 Superpowers、Ponytail、Caveman 等技能组合,除非请求明确要求。技能钩子、提及和间接指令不构成授权。
  • 不自动路由到 nerd-patrol,仅在证据需要更深入的安全、漏洞、不安全行为或可利用性审查时使用,且保持审查而不修复。
  • 审查结束后停止,不提供额外内容如赞美、清洁检查列表、风格意见或走查。
  • 严重程度独立于审查层级,审查层级不设置严重程度。
  • 对于缺失事实,如具体收费、价格、平台、效果或使用步骤,暂未提供。