SuperAPI AI 工具集

completion-audit

测试与质量

查看项目

更新于 10-16 06:03

技能介绍

Completion Audit 是一个面向任务收尾阶段的质量门禁技能,主要用于长周期、多阶段或产出用户可见交付物的任务。它的核心目的是防止执行者在未充分验证的情况下自行宣布任务完成,而是通过外部门禁机制来确认完成状态。

用途 该技能适用于以下场景:任务周期较长或包含多个阶段;任务产出了用户可见的交付物,例如运行结果、仪表盘、报告或导出文件。在这些场景下,执行者需要在宣布任务完成之前,先准备一个“完成候选”(completion CANDIDATE),而不是直接标记为完成。

主要能力

  1. 枚举被改动的文件与用户可见界面:列出本次任务所触及的文件和用户可见的表面。
  2. 核对计划与期望:将计划或目标与线程中表达的期望进行对比,差异必须被呈现,不得静默丢弃。
  3. 映射检查项:将每个被触及的表面映射到受保护的 acceptance_manifest.yaml(只读)中的检查项。任何没有对应检查项的用户可见表面,需记录到 review_queue.yaml 并标记为 blocked。
  4. 收集真实证据:收集真实的证据路径(实际产物或配置),而不是 run_state 断言。
  5. 生成候选文件:写入 completion_candidate.yaml(提案,状态为 candidate_complete)。
  6. 调用外部门禁:执行 check_acceptance.py --manifest ... --inventory ... --candidate ... --repo . 进行验证。

使用方式 执行者按照上述流程操作,最终产出三个结果:completion_candidate.yaml(仅作为提案)、review_queue.yaml(阻塞性未决项)以及门禁结果。门禁结果为 PASS 时,外部验证者可能授予 complete;若为 FAIL 或存在任何审查项,则状态为 blocked。

适用场景 该技能适用于需要严格完成验证的任务,尤其是那些产出用户可见交付物、涉及多阶段或长周期的任务。它帮助确保任务完成状态由外部门禁确认,而非执行者自行判断。

限制

  1. 执行者不得自行设置 complete 状态,只能达到 candidate_complete 或 blocked。只有外部门禁或验证者才能写入 complete。
  2. 不得将真实回归重新归类为“主观”以跳过检查,需要审查等同于 blocked。
  3. 不得将 run_state 作为证据喂给门禁,门禁必须读取真实产物。

其他信息 该技能的官方文本暂未提供。