SuperAPI AI 工具集

ajimi-review

编程与开发

查看项目

更新于 11-16 17:18

技能介绍

ajimi-review 是一个围绕代码审查的 AI 技能,目标是审查代码变更、Pull Request(PR)、diff 以及未提交的本地工作,找出其中的缺陷和回归问题。其核心方法是将每个疑似缺陷视为待验证的假设,要求用证据确认:说明触发条件、被违反的预期,以及可归因于所审查变更的影响。

用途与审查对象

  • 可用于 PR 审查、分支或提交区间比较、暂存区变更(index 与 HEAD 对比)、混合的本地改动,以及外部提供的补丁。
  • 审查前先确定目标与比较基线:PR 记录 head commit 与实际 diff 的基线(通常是 GitHub 上的 merge base);分支或提交区间使用请求的比较方式,并把移动引用解析为提交 ID;暂存变更对比 index 与 HEAD;混合改动记录基线以及是否包含暂存、未暂存和相关未跟踪文件;外部补丁记录可用的父级或周边代码。
  • 要求 diff、源码上下文、执行结果和行引用保持在同一个被审查快照上;若审查期间目标发生移动,需复查受影响结论或在报告中指明早期快照。

主要能力

  • 从用户请求、issue、规格、调用方或现有测试中确立契约;对行为变更识别其有意替换的预期。
  • 按审查清单选取相关视角,从公共入口和受变更影响的需求出发,沿 diff 追踪调用方、数据、测试和配置。
  • 对每个候选缺陷识别可达输入或状态、适用预期、预测影响,以及负责的变更代码或遗漏需求,并检查守卫、下游处理等可能反驳该候选的事实。
  • 聚焦变更引入、加重、暴露或在既定需求下未完成的行为;当变更创造新路径或加重影响时,也可考虑既有缺陷。
  • 将无关缺陷、推测性抽象和常规格式化或 lint 反馈排除在发现之外。

验证方式

  • 优先使用最小的检查,通过受支持的入口触发相关行为;先选定断言和预期结果,再读取输出。
  • 可使用现有测试、最小 fixture,或运行应用与 CLI。设置失败和超时作为证据限制上报;通过的套件只支持其断言覆盖的行为。
  • 在可能时比较等价输入、fixture 和环境;契约变化时比较适用于两个版本的预期,并在被审查快照上检查新需求。
  • 证据类型包括:回归(同一断言在基线通过、在被审查快照失败)、缺陷修复(报告缺陷的断言在基线失败、在修复后通过)、新功能缺陷(受支持输入或状态在被审查快照上违反新功能契约,并说明为何不适用基线比较)、受支持的构建或工具失败(相关命令在受支持配置下报告与变更相关的确定性错误)。
  • 若源码或制品足以定论,可使用静态证据:把受支持输入或状态追踪到确切的失配处,并引用入口、相关守卫或假设、变更代码和适用契约;不完整的追踪或未执行的复现视为未验证。
  • 可重新运行检查以解决特定不确定性(如偶发失败)。

使用方式与安全约束

  • 保护用户的工作区,临时测试和比较副本使用隔离的临时空间。
  • 执行候选代码前检查相关命令、钩子和脚本,使用所需最小权限、合成数据,不接触线上服务或凭据。
  • 无法安全执行时,改用能定论的源码证据;安全审查保持防御性和基于源码,只使用对防御属性的可信检查,不提供利用代码或漏洞复现说明。
  • 对针对性检查无法定论的重要不变量,参考形式化验证指南,并在把反例作为代码缺陷证据前确认其适用于该实现。
  • 置信度、审查者一致意见、作者保证和无关的通过检查都不能证明缺陷存在。

报告要求

  • 使用报告模板,每个根本原因只报一个发现,按严重程度排序,锚定到能解释问题的最小变更位置;删除或遗漏使用最近变更上下文并说明缺少什么。
  • 记录检查与决定性输出或源码追踪,包含足够上下文以便在不泄露隐私数据的情况下复现证据。
  • 严重程度:Critical 用于可达且影响严重的失败(如大范围数据丢失或重大中断);Important 用于受支持使用中的实质性错误行为;Minor 用于已确认但影响有限的缺陷。综合前置条件、可能性、影响范围和可恢复性判断。
  • 按原因汇总被丢弃的候选;未验证问题需说明缺失证据和已知的下一步检查。
  • 当请求审查的实质性部分被阻塞时使用 incomplete,并保留已确认发现;当请求范围已审查且无重大验证缺口时使用 complete,即使存在发现。审查状态描述的是覆盖范围。
  • 修复、发布、批准和合并动作需单独的用户授权,不属于本技能执行范围。

限制

  • 资料未提供具体安装命令、运行环境、支持的平台、收费方式或价格信息,暂未提供。
  • 资料未提供具体报告模板的完整字段格式,暂未提供。
  • 该技能以审查与验证为核心,不负责实施修复或执行合并等操作。