SuperAPI AI 工具集

check

编程与开发

查看项目

更新于 10-15 23:43

技能介绍

check 是一个纯诊断工具,用于检测规格文档与代码之间的漂移。它只报告违规,不写入任何内容,由用户自行决定补救方式。规格与代码静默偏离是 SDD 的首要失败模式,check 就是检测器,建议在每次 /build 之后、每次发布之前运行。

使用方式:读取 SPEC.md,若缺失则提示“no spec, nothing to check.”并停止。解析调用参数:§V 仅检查不变量(默认),§I 检查接口,§T 审计任务状态与代码,--all 检查全部三项。

主要能力:§V 将每条不变量翻译为可验证的代码断言,通过 grep 或读取相关文件,分类为 HOLD / VIOLATE / UNVERIFIABLE,并记录地址与 file:line 证据。§I 定位实现并分类为 MATCH(代码形状与规格一致)、DRIFT(实现存在但形状不同)、MISSING(实现缺失)、EXTRA(代码暴露了 §I 未列出的接口)。§T 对每条任务:x 验证声称的工作是否存在,~ 记为进行中,. 记为待处理,无证据的 x 行标记为 STALE。

报告按严重程度分组,末尾为每类给出一行补救提示:VIOLATE / DRIFT 建议调用 spec skill bug: <V.n> 或修复代码;MISSING 建议若任务存在则对 §T.n 调用 build skill,否则用 spec skill 修订 §T;STALE 建议用 spec skill 修订 §T 取消勾选;EXTRA 建议用 spec skill 修订 §I 记录,或删除代码。

限制:零写入,不编辑 SPEC.md,不编辑代码,不使用子代理,由主线程读取,不打分不分级,每项只有保持或漂移两种结果。绝不调用修复,仅报告。