SuperAPI AI 工具集

why-review

编程与开发

查看项目

更新于 11-06 09:09

技能介绍

why-review 是一个面向代码质量的审查技能,核心用途是判断被审查对象是否正确、是否有证据支撑、是否值得其权衡成本,从而帮助调用方做出有依据的下一步决策。

主要能力:支持多种审查模式。默认的完整模式执行第一轮审查,并在发现中高严重度问题或目标属于单向门决策时执行第二轮对抗性审查;发现项存在时进入发现项验证门。validate-findings 为终端验证模式,只读取终端验证参考文档,对给定报告输出 CLEAN 或 HAS ISSUES 后返回,不再调用自身、不绑定循环、不询问用户。--fix-loop 为可选的修复循环,按审查、验证、授权修复、全新复审的顺序执行,默认上限 3 轮;--loop-owner=caller 时向拥有修复与复审权的调用方返回只读的已验证结果。审查过程包含七项反偏见检查、权衡门、验证清单与对抗性分析,并按后果把发现分为 Critical、High、Medium、Low 四级。

使用方式:通过技能调用方式触发,参数中可携带 --validate-findings、--fix-loop、--loop-owner=caller 等标记。执行前先检测模式,再按模式读取对应参考文档;随后确定审查目标、目标契约与关注点路由,代码变更类目标还需读取代码变更路径参考。审查中发现项会触发终端验证,报告缺陷在同一轮内修正。任务跟踪要求在每步开始与结束时更新状态,并保留简要证据或跳过原因;审查结论需保存到 tmp/reports/ 下的报告文件中并基于磁盘内容综合。

适用场景:代码提交、PR、diff、分支、未提交改动的审查,也适用于对某个决策、主张或陈述做必要性与可选方案评估。涉及跨服务、事件驱动或跨前后端接缝的变更时,会扫描生产者、消费者、契约与集成测试关联。

限制:终端验证模式优先级最高,会忽略修复循环标记;材料性权衡若无用户确认不能判为通过;不可达的关注点只作为观察而非发现;对非平凡缺陷的调试回溯不属于普通制品审查的触发范围。该工具运行于特定代理技能框架,依赖其参考文档与协议文件,具体宿主环境能力映射需按实际环境确认,其他未在资料中说明的收费、平台与效果信息暂未提供。