SuperAPI AI 工具集

re-verify-structure

通用与其它

查看项目

更新于 10-15 17:31

技能介绍

用途:作为逆向工程第一阶段(结构分析)的独立校验环节,对照真实源码核验 re-structure-analysis 产出的结构图。它以独立 Critic 身份在单独 agent 上下文中运行,无法访问执行者的推理过程,只能看到产物。门禁规则:第二阶段 re-visualize-logic 必须在本校验给出 PASS 或 WARN 后才能继续。

主要能力:遵循三条原则——代码即真相、可追溯到行、行为优先于意图。执行流程包括:加载 manifest 与结构图(manifest 参数直接指定,或由 analysis 参数推导为 docs/reverse/{analysis}/manifest.json,二者至少提供一个;phase1.status 必须为 completed 才能继续);引用校验(逐条检查 file:line 的文件存在性、行号有效性与内容匹配,分类为 VALID、INACCURATE(±10 行内)、INVALID、HALLUCINATION);完整性校验(统计目标范围内实际组件并与结构图对比,计算覆盖率);Mermaid 图校验(语法有效性与节点/关系抽查);内部一致性检查;生成校验报告至 docs/reverse/{analysis}/verification/v1-structure.md;更新 manifest(PASS/WARN 时 phase1.status 置为 verified,FAIL 时保持 completed)。

判定标准:引用准确率 ≥95% 为 PASS、80–94% 为 WARN、<80% 为 FAIL;组件覆盖率 ≥95% 为 PASS、90–94% 为 WARN、<90% 为 FAIL;Mermaid 错误 0 为 PASS、1–2 为 WARN、≥3 为 FAIL;幻觉 0 为 PASS、≥1 为 FAIL。任一 FAIL 项即整体 FAIL。

限制:禁止修改结构图与源码文件,禁止假设缺失信息(应标记为问题),禁止批准 FAIL 状态文档,禁止访问执行者对话上下文或推理。

适用场景:需要独立、可追溯地验证逆向工程结构分析产物的质量与真实性时使用。具体安装方式与运行命令暂未提供。