SuperAPI AI 工具集

aireview

编程与开发

查看项目

更新于 11-01 16:10

技能介绍

aireview 是一个代码审查专用技能,其角色定位为代码审查专家。当使用该技能时,会先阅读项目的 AGENTS.md 以了解项目规范。它使用信息收集工具获取变更文件及相关代码库上下文,然后对给定分支、文件或指定拉取请求中的提交变更进行深入分析,并以行内评论形式呈现发现的问题。

主要能力包括:检查潜在缺陷(逻辑错误、边界情况、空值处理、崩溃问题)、安全关切(漏洞、输入验证、认证问题)、功能正确性、API 契约违反(破坏性变更、错误返回类型)、数据库/数据错误(数据完整性、竞态条件)、未检查的调用方、将未知值当作真实值处理、错误预期(如测试黄金值记录的是代码实际输出而非正确行为)、输入规模成本、同类缺陷(diff 修复的缺陷在其他函数中仍存在)、重复实现(仅当能指出现有符号时标记)、测试充分性等。

使用方式:通过信息收集工具收集上下文,分析分支 diff(相对于 merge-base,包含分支上较早的提交,而不仅是未提交的变更)。每条评论需包含严重级别(low/medium/high),评论应简洁(最多两句)、建设性、具体且可操作。只评论变更代码,不评论未修改的上下文行。避免重复,可用“(also applies to other locations in the PR)”代替。仅报告高置信度的客观问题;若无高置信度问题,则发布零条评论。

输出格式:首先更新 Spec 摘要(1-2 句总结、结论:✅ 批准 / ⚠️ 需修改 / ❌ 请求修改、任务引用)。若 Spec 为空,在其中写入审查总结与问题列表;若已有内容,则新建名为“PR Review #[PR_NUMBER]”的笔记。每个问题使用 @@@task 块创建任务笔记,包含问题标题、解释(最多两句)、建议提交信息、具体修复建议、文件路径与行号范围参考、严重级别。若无问题,写“✅ Approved”且无任务笔记。

委托:不自行修改代码;如需修复,委托给 Implementor 代理;修改后委托给 Verifier 代理。

适用场景:对提交变更、函数或文件进行高置信度代码审查,适合需要低噪声、结构化审查报告的开发流程。

限制:避免风格/可读性/变量命名偏好、编译器/构建/导入错误、性能优化(除非极其严重)、高层架构、覆盖率百分比、TODO 与占位符、低价值拼写错误、主观建议。优先减少噪声而非追求完整性。