SuperAPI AI 工具集

review-consolidation

测试与质量

查看项目

更新于 10-15 10:53

技能介绍

用途

Review consolidation 是一个代码审查整合技能,核心目标是把原生审查者(native reviewer)的发现进行合并整合,同时保留证据来源(evidence provenance),进行交付核算(delivery accounting)与对抗性验证(adversarial verification)。它接收的输入包括:变体(variant)、准备好的简报/上下文/选择(prepared brief/context/selection)、原生审查者结果(native reviewer results)、交付账本(delivery ledger)。输出是既有的原生审查报告,外加一个项目结果信封(project-result envelope)。

主要能力

  • 保留原生报告规范(canonical native reports),使用既有审查契约整合发现,不引入另一套发现模式(finding schema)。
  • 在做置信度过滤或严重级别排序之前,需先读取技能内的 references/stack-findings.md,它定义了专家输出如何进入原生审查契约,同时保留原始标签、来源角色与证据。
  • 在将专家交付视为完成之前,需校验必填字段。
  • 加载 senior-review:review-quality-gates 技能。整合前需覆盖每一个被选中的审查者,包括技术栈专家、失败、超时或不完整交付。
  • 对所有维度使用同一份输入发现集与交付账本,保留来源角色、原生严重级别、前提与证据来源。
  • 绝不把失败的 worker 合并进成功结果。由单一最终 writer 输出报告。

使用方式

  • 加载 skill-catalog:skill-catalog 技能,针对准备好的 knowledge_selection 与全部 worker 的 knowledge_usage 记录运行 validate-usage。
  • 校验每一个被分配的范围/worker、选择/正文指纹以及被使用的引用。失败、过期或缺失的已选知识属于交付覆盖失败;任何必需的候选门(candidate gate)保持不满足状态。
  • 将未解决的清单/分类/匹配缺口保留在 knowledge_coverage 以及同一报告的覆盖章节中。
  • 已加载的知识不能证明代码路径已运行,也不能确立某个发现的前提。
  • 将知识与发现一同保留来源追溯;通用知识模式仍然需要代码证据与可证伪的前提。
  • 独立推导可以使用通用领域知识,但绝不使用共享的项目结论或同伴发现。

流程阶段

读取技能内的 references/<variant>.md,执行其中的整合、新的验证视角、完整性检查与报告阶段。对于 PR 审查,在产出原生 PR 描述之前,需遵循相同的交付/来源/面板规则。

适用场景与限制

  • 两个继承同一前提的审查者属于回声(echo),不构成独立佐证。
  • 去重时需保留独立证据与不同的失败模式。
  • 加载 project-protocol:project-protocol 技能以校验快照并发布结果信封。
  • 报告可以在覆盖明确降级(explicitly degraded coverage)的情况下完成;但不能声称某个缺失的审查者运行过,也不能声称静态分析执行了运行时行为。

注:该技能的官方详细文档、安装方式与具体平台支持情况暂未提供。