SuperAPI AI 工具集

review-verify

测试与质量

查看项目

更新于 10-15 21:56

技能介绍

用途:review-verify 是 agentic-workflow 评审包中的内部“运行验证”评审环节,由 review-change 或 product-audit 在其对话中组合调用,作为被路由的步骤内联执行。它只产出发现(findings),从不编辑、从不重构代码。

主要能力:按固定清单逐项评估,每项都不可跳过,不适用必须说明原因。清单包括:本次评审中运行项目的验证门(按项目声明的命令做类型检查、测试、构建,并粘贴每条命令的退出状态);真实执行变更所声称的主要行为(运行 CLI/端点/函数并粘贴实际观察到的输出);复现 SPEC 开发场景中至少一个失败模式(错误输入、缺失文件、错误路径)并确认其行为符合规范;证明新增或修改的测试在实现被回退或破坏时确实失败(通过变异或暂存验证,之后恢复);确认没有为通过而跳过或禁用测试(在 diff 中 grep skip/only/todo 标记);确认构建产物或开发服务器能干净启动(无表示损坏的新警告);把只能由人工确认的内容(视觉、设备、区域设置、负载)明确列入 Manual,不得静默丢弃。

使用方式:调用方传入 diff 或路径/通配符作为范围,默认是当前变更对比默认分支;返回表格顶部需声明范围。返回内容为固定格式块:REVIEW VERIFY — scope、发现表格(#、Finding、Sev、Evidence、Suggested fix)、Checklist 统计、Summary、Manual 列表、Decision(PASS 或 FAIL)。存在未解决的 critical 或 major 发现则 FAIL,否则 PASS;minor 发现不阻塞,交由调用方的分诊步骤处理。

适用场景:适用于对代码变更做运行层面的验证评审,尤其是需要证据支撑、需要区分自动可验证与人工确认事项的场合。

限制:仅限内部组合调用,不是独立菜单入口;只报告发现,不做修改;报告门槛要求只有当合格用户的结果改变或项目明确声明的规则被违反时才记录一行,并需在证据旁引用所违反的规则;注释/标点错别字、纯格式漂移、无引用规则的风格偏好、超出 SPEC 命名场景的假设性健壮性都不算发现;格式良好的变更预期结果是空表格加 Decision: PASS,不得为凑数填充表格。完成条件是每个清单项都有证据(file:line 或命令输出)或明确标注 n/a 及原因,且返回上述固定格式块,不多不少,且未改动任何代码。