SuperAPI AI 工具集

requesting-code-review

编程与开发

查看项目

更新于 11-11 16:19

技能介绍

用途

requesting-code-review 是一个提交前代码校验流程,用于在代码落地(commit / push)之前自动执行多层检查:静态安全扫描、基线感知的质量门禁、独立审阅子代理,以及自动修复循环。其核心原则是“任何代理都不应校验自己的工作”,通过全新上下文来发现实施者容易遗漏的问题。

主要能力

  • 获取变更:优先使用 git diff --cached;若为空则尝试 git diff 或 git diff HEAD~1 HEAD。当缓存区为空但工作区有改动时,提示用户先 git add <files>;仍为空则通过 git status 确认无内容可校验。diff 超过 15,000 字符时按文件拆分:git diff --name-only,再对单个文件执行 git diff HEAD -- specific_file.<ext>。
  • 静态安全扫描(仅新增行):用 grep 规则检测硬编码密钥、shell 注入、危险的 eval/exec、不安全反序列化、SQL 字符串拼接注入等,命中项进入后续审阅环节。
  • 基线与测试 / lint:自动识别项目语言并运行对应测试与 lint/类型检查工具(仅在已安装时运行)。先在不含本次改动的基线下记录失败数 baseline_failures(stash 后运行再 pop),只有本次改动新引入的失败才阻断提交。
  • 自检清单:派发审阅者前快速检查硬编码凭据、用户输入校验、参数化 SQL、路径遍历防护、外部调用错误处理、遗留调试输出、注释掉的代码、新代码是否有测试。
  • 独立审阅子代理:启动无共享上下文的新子代理,只收到 diff 与静态扫描结果,返回严格 JSON(passed、security_concerns、logic_errors、suggestions、summary)。采用 fail-closed 规则:任一安全或逻辑问题非空即 passed=false;diff 无法解析也判失败;仅当两个列表均为空才 passed=true。安全项包括硬编码密钥、后门、数据外泄、shell/SQL 注入、路径遍历、用户输入进入 eval/exec、pickle.loads()、混淆命令;逻辑项包括错误条件逻辑、I/O/网络/DB 缺错误处理、差一错误、竞态、代码与意图矛盾;建议项(测试缺失、风格、性能、命名)不阻断。
  • 结果汇总与自动修复:合并静态扫描、测试 lint、审阅结论。全部通过则进入提交;否则输出“VERIFICATION FAILED”并列出问题,交由第三个代理上下文(既非实施者也非审阅者)仅修复已报告问题,不改动其他内容、不新增功能。修复后重新执行完整校验,最多 2 轮;两轮后仍失败则上报用户,并建议 git stash 或 git reset 撤销。
  • 提交:校验通过后执行 git add -A && git commit -m "[verified] <description>",[verified] 前缀表示经独立审阅者批准。

使用方式与触发时机

在实现功能或修复缺陷之后、git commit 或 git push 之前使用;用户说出 “commit”、“push”、“ship”、“done”、“verify” 或 “review before merge” 时触发;在 git 仓库中完成涉及 2 个及以上文件编辑的任务后使用;在子代理驱动开发的每个任务后作为两阶段评审(规格符合性 + 代码质量)的质量门禁。仅供文档的改动、纯配置微调,或用户明确表示 “skip verification” 时可跳过。

与 github-code-review 的区别:本技能校验的是你自己提交前的改动;后者用于在 GitHub 上审阅他人的 PR 并留行内评论。

适用场景

功能开发或缺陷修复收尾、提交/推送前检查、合并前自检、子代理驱动开发中的逐任务质检、TDD 流程中验证测试存在且通过、验证实现是否符合计划要求。

限制与注意事项

  • 空 diff:检查 git status,告知用户无可校验内容。
  • 非 git 仓库:跳过并告知用户。
  • 大 diff(超过 15k 字符):按文件拆分分别审阅。
  • 委派结果非 JSON:用更严格提示重试一次,仍失败按 FAIL 处理。
  • 误报:若审阅者标记了有意为之的写法,在修复提示中说明。
  • 未找到测试框架:跳过回归检查,审阅结论仍照常执行。
  • lint 工具未安装:静默跳过该项,不判失败。
  • 自动修复引入新问题:计为新的失败,继续循环计数。