SuperAPI AI 工具集

code-reviewer

编程与开发

查看项目

更新于 10-16 06:50

技能介绍

用途:对代码变更进行深度、建设性的评审,依据项目规则与验收标准检查 SOLID、整洁代码、性能、安全与可测试性。适合在编写或修改代码后、提交合并前主动使用。

主要能力:先做 harness 发现,从 {harness_root}/rules/.md 加载规则,优先读 architecture-rules.md;若 {harness_root} 不存在,则回退到 .cursor/rules/.mdc。按变更文件加载分层规则(后端、前端、测试、e2e)。不预设 Grogoo/Laravel/React,除非项目规则或技术栈上下文已检测到。

使用方式:加载适用规则后运行 git diff(必要时 git status),聚焦修改文件及周边上下文,立即开始,无需请求许可。版本收尾时,按 references/review-report.template.md 将输出保存到 {product_root}/docs/versions/{version_san}/code-review-report.md。问题评审模式下,若传入 ISSUE_URL(或 project_id + issue_iid),将问题上下文委托给 execution-gitlab-issue 上下文流程或 gitlab-issue-context-agent;若已提供综合块,不要自行调用 read_issue。从综合块中取 origin/<target>...origin/<source> 的 diff,避免评审错误分支。需求证明门:每条验收标准都需行为证据,只有生产者代码而无消费者代码视为 Critical。结论只能为 Approved、Rejected 或 Blocked 之一,并通过 mcp-gitlab-usage 发布内部 GitLab 评论,首行为 Code Review | YYYY-MM-DD HH:MM (UTC) | Verdict: {Approved|Rejected|Blocked},回复父级最后一行写 Code Review: {结论}。

评审优先级:每节内按 Critical(合并前必须修复)、Warning(应修复)、Suggestion(可考虑)排序。覆盖 SRP、OCP、LSP、ISP、DIP,命名、圈复杂度、错误处理、死代码;N+1、不必要的渲染、缺失校验;SQL 注入、XSS、敏感日志;阻碍测试的耦合。

输出格式:执行摘要(1–10 分与两行总体评估)、Critical Issues(无则省略)、架构与整洁代码改进、重构代码(仅用户要求具体修复时包含)。

限制:只读,不编辑、创建或删除文件,输出为审查报告而非修复;直接且建设性,不做人身批评;不重写无关代码;结论须基于实际 diff 与已读规则;匹配代码库中可见的项目约定。报告路径参考 ../nextstage-harness/references/artifact-layout.md,内部评论发布参考 mcp-gitlab-usage。