SuperAPI AI 工具集

commit-review

编程与开发

查看项目

更新于 11-04 19:59

技能介绍

用途

commit-review 是一个代码质量审查技能,用于在 commit 技能选择轻量审查,或用户主动请求时,对某个确切的待提交(pending)commit 进行审查。其目标是围绕该 commit 的意图与目的,检查变更的正确性、回归风险、安全性与复杂度问题。

主要能力

  • 确定目标 commit 及其目的,加载适用的项目审查规则与叠加规则(overlays)。
  • 在 --fix-loop 模式下,读取 references/fix-loop.md,并在审查前对确切的候选内容做快照,同时保留无关工作。
  • 检查每个变更文件及受影响的调用方,关注正确性、回归、安全与不必要的复杂度。
  • 追踪变更行为在成功、失败与边界情况下的表现;在相关时检查权限与受影响的调用方。
  • 将变更行为与其配置的规范所有者/规格、profile 声明的场景/用例以及执行的测试证据进行对照;仅在存在实际疑虑时读取更多参考资料。
  • 对变更行为,识别测试应当捕获的现实 bug;仅在测试强度不明确且编辑已获授权时,使用针对性的变异探针(mutation probe)。
  • 对疑虑进行内联验证,对照源码与反证。

使用方式

  • 默认以只读方式运行。
  • 使用 --fix-loop 时,在范围内修复已验证的问题,并对更新后的整个候选内容重新审查,最多两轮;--loop-owner=caller 时保持只读。
  • 遇到未解决的 MEDIUM 及以上问题或检查失败时停止;非阻塞的 LOW 问题延后处理。不得静默扩大预算。
  • 简要报告发现、修复、检查、轮次与延后的 LOW 问题。
  • 仅在完全覆盖的全新 fix-loop 通过且必需检查通过后,使用其原始快照出具回执(receipt)。
  • 该审查不会执行暂存、提交或推送;也不例行加载其他审查工作流。

适用场景

适用于需要在提交前对某个确切待提交 commit 做轻量质量审查的场合,尤其是希望结合项目审查规则、测试证据与边界情况检查,并在授权时进行有限轮次修复与复审的工作流。

限制

  • 发现需具备可达触发条件、后果、file:line、严重级别与至少 85% 置信度;推测性建议、无关债务以及已被检查捕获的问题会被省略。
  • 缺少必需证据会阻止通过。
  • fix-loop 最多两轮,不得静默扩大预算。
  • 该技能本身不执行暂存、提交或推送操作。
  • 关于具体安装命令、收费与价格、支持平台等信息,资料中暂未提供。