SuperAPI AI 工具集

impl-validator

编程与开发

查看项目

更新于 10-16 03:14

技能介绍

用途:impl-validator 是一个批判性审查技能,用于验证另一技能或代理刚完成的工作是否真正符合预期目标,在用户看到结果前发现真实问题,而非给出鼓励性评价。

主要能力:支持两种模式。子代理模式由其它技能以结构化 check: 块程序化调用,读取 goal、artifacts、checks 字段并返回结构化输出;用户模式由用户直接调用 /impl-validator,通常附带对刚完成工作的描述。校验流程包括:用一句话复述目标(无法复述则标记 WARN);逐个检查产物是否存在、是否完整、内容是否与目标逻辑一致(识别占位文本如 <TODO>、{{variable}}、INSERT HERE,复制粘贴错误,逻辑矛盾,缺失必填字段,边界情况);检查是否符合项目既有约定(技能需含 name 与 description 的 YAML frontmatter、祈使语气、编号步骤;Wiki 页面需含 title、category、tags、sources、created、updated;Shell 脚本需有 shebang、可 chmod +x、使用 set -e;Plist 需为合法 XML、Label 与文件名一致、ProgramArguments 指向真实路径);逐条执行 checks 列表并给出 PASS/WARN/FAIL;最后生成含目标、检查表、总体判定、待修复问题与注意事项的报告。总体规则:任一 FAIL 即 FAIL,无 FAIL 但有 WARN 即 WARN,全部 PASS 即 PASS。

使用方式:子代理模式下解析传入的 check: 块并按其字段执行;用户模式下从上下文推断目标与产物,若目标含糊可提一个澄清问题,关键检查不得凭猜测进行。子代理模式返回完整报告供调用方决定是否修复;用户模式直接展示报告,若总体 FAIL 可主动提出修复。

适用场景:对实现结果做二次意见验证,检查文件、输出、配置是否与声明目标一致,适用于技能、Wiki 页面、Shell 脚本、Plist 等产物的质量把关。

限制:不检查风格偏好(除非违反约定)、性能与效率(除非目标提及)、目标本身是否是好主意,以及假设性的未来问题,仅标记当前产物中的实际问题。严重度参考:必填 frontmatter 缺失、文件不存在、检查确定为假属 FAIL;硬编码路径可能在其他机器失效、页面数异常偏低属 WARN。具体安装命令与平台信息暂未提供。