SuperAPI AI 工具集

code-review

编程与开发

查看项目

更新于 10-16 05:05

技能介绍

用途:对 GitLab 合并请求(MR)做全面代码评审,覆盖代码质量、安全、性能与最佳实践,并输出可执行的反馈。

前置条件:需安装 GitLab CLI(glab),可用 brew install glab 或从 https://gitlab.com/gitlab-org/cli 获取。本技能配置为自托管实例 https://gitlab-erp-pas.dedalus.lan,需配置相应访问凭据,项目标识与 URL 均使用该实例。

触发方式:输入 review 或 code review;输入 review MR-123 或 review !123 评审指定 MR;输入 review #456 根据 GitLab issue 找到关联 MR。

主要流程:先确认 project_id,再用 glab mr view <iid> 获取标题、分支、作者、审批与流水线状态及 diff_refs;用 glab mr diff <iid> 获取变更文件与增删;复杂改动用 git show <ref>:<file_path> 查看完整上下文;用 git log 与 git show 查看提交;用 glab api /projects/:id/merge_requests/:iid/discussions 查看已有讨论以避免重复;用 glab ci list、glab ci view <pipeline_id>、glab ci trace <job_id> 检查流水线与失败任务。

评审内容:代码风格与命名、结构与 DRY、逻辑与边界情况、错误处理、性能、安全(输入校验、SQL 注入、XSS 等)、资源与并发、设计模式与 SOLID、测试覆盖、文档、API 兼容性、新依赖、破坏性变更、数据库迁移。

输出:结构化报告,含执行摘要、统计(文件数、增删行、提交、关键问题)、优点、按优先级分级的问题(🔴 关键、🟡 重要、🟢 建议)、详细发现(文件与行、以问题形式表述、上下文)、安全与性能评审、测试与文档建议、结论(APPROVED、CHANGES_REQUESTED 或 NEEDS_DISCUSSION)。

可选回写:经用户确认后,用 glab mr note <iid> --message "<comment>" 添加普通评论,或用 glab api POST /projects/:id/merge_requests/:iid/discussions 结合 position(base_sha、head_sha、start_sha、new_path、new_line、old_path、old_line)添加行级讨论。

限制与规则:只评审本次 MR 引入的变更,不评论未改动代码;反馈用提问而非指令式措辞;结论前先检查流水线状态并查看已有讨论;添加评论前必须征得用户同意。资料未说明具体模型、平台支持范围、收费与价格,暂未提供。