SuperAPI AI 工具集

java-code-review

编程与开发

查看项目

更新于 10-16 01:49

技能介绍

用途:对 Java 代码进行有重点、基于证据的审查,将发现写入仓库根目录的 review.md(除非用户指定其他位置)。只审查代码,不在用户未明确要求修复时改动生产代码。

审查范围:用户指定文件、类、包、提交或 diff 时按此范围,不擅自扩大;否则用 git status --short 和相关 git diff(含暂存改动)检查已修改、新增、重命名的文件,重命名文件审查结果文件及有意义的 diff。只纳入与行为相关且影响被审查 Java 代码的 Java 及邻近文件(如测试、SQL 迁移、配置、API 模式),并在报告中说明范围。需阅读调用方、测试、配置与接口以验证每条发现,不凭名称或通用最佳实践下结论。

检查内容:潜在缺陷(条件错误、null/空值处理、状态或事务错误、异常处理、资源泄漏、并发、安全或授权缺口、API/序列化不匹配、持久化错误、边界情况);重复代码(重复逻辑、复制分支、重复映射/校验、可减少漂移的抽象);待改进项(设计不清或脆弱、耦合过度、命名误导、可避免的复杂度、测试缺口、性能问题、违反项目约定)。优先正确性与影响而非风格。区分已确认问题与风险或疑问。

验证:对每条发现追踪控制流与数据流,检查附近测试,条件允许时运行最小有用测试、编译、静态分析或复现命令;不要为让验证通过而改动文件;无法验证需说明原因。

报告:写入前检查目标文件是否存在;存在则询问覆盖或使用新文件名,用户选择新文件名则严格使用该名;不存在则创建 review.md。报告需自包含,含 Scope、Summary、Findings(每个发现给出严重级别、位置、类别 Bug/重复代码/改进、置信度、问题与具体修复建议)、Positive observations(可选)、Validation。严重级别用 Blocker、High、Medium、Low,按严重级别再按文件与行排序,每条发现对应一个独立问题。未发现问题需明确说明并仍包含范围、验证与正面观察。

最后:告知用户报告已创建并链接生成文件,给出发现数量,简要指出 Blocker 或 High;若因已有文件需用户选择而无法创建,先提问并停止写入。缺失事实暂未提供。