SuperAPI AI 工具集

completion-evaluator

通用与其它

查看项目

更新于 10-16 00:06

技能介绍

用途:completion-evaluator 是一个与技术栈无关的技能,用于依据验收标准与达成指标评估交付物,判断验收标准是否满足,给出带理由的通过/失败判定、具体改进反馈以及下一步行动建议。它主要由 deliverable-evaluator 调用,quality-reviewer 也可用于质量评估。

主要能力:评估框架把达成指标分为三类——completeness_indicators(交付物必须包含什么,如所需函数已实现、错误处理存在、边界情况覆盖、文档齐全)、quality_indicators(应如何构建,如遵循项目规范、测试覆盖率达标、无安全漏洞、性能在限内)、functionality_indicators(必须做什么,如业务逻辑正确、满足用户验收标准、集成点可用、无回归)。评估流程为:加载上下文并读取验收标准、逐项评估指标、计算判定、确定下一步行动。判定为二元结果:全部通过则整体 PASS,任一失败则整体 FAIL,不设 CONDITIONAL。

证据与阈值:证据类型包括代码存在性检查、测试结果、静态分析输出、覆盖率指标、性能指标、人工核查。阈值类型包括布尔、数值、计数、存在性。通过要求所有完整性、质量、功能性指标均 PASS 且无关键问题;失败触发条件为任一指标失败、发现关键问题或阻塞问题。

迭代与反馈:最多迭代 3 次,第 1 次聚焦关键问题,第 2 次主要改进,第 3 次最终打磨;超过 3 次失败则升级,请用户决定接受现状、修改需求或放弃任务。反馈要求具体、可执行、有优先级并指派负责的 agent。

输出格式:包含 overall_verdict、按三类分组的 indicator_results(含 status、evidence、target、actual)、summary(通过数、失败数、通过率)、feedback(critical/major/minor)、next_action(complete 或 rework、原因、指派 agent、具体任务)以及 iteration 信息。

适用场景与限制:适用于需要按验收标准客观判定交付物是否完成的自动化或半自动化评估流程。验收标准可来自 goal_clarifier、用户请求,或未提供时使用默认标准质量清单。资料未提供具体安装命令、平台支持、收费方式与性能数据。