SuperAPI AI 工具集

logic-locate

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:在已确认失败时定位根因,采用“先回溯、再前向”的半形式化追踪。触发条件是用户提供堆栈跟踪、失败断言、错误信息或具体的错误取值观察,例如“找这个 bug”“测试失败”“追踪这次崩溃”。若只是怀疑,应改用 logic-review。

主要能力:按步骤推进——确认具体失败并做语言与范围路由;理解失败(观察行为、期望行为、复现路径);确定入口点(失败测试、最外层应用帧或请求处理器,优先停留于失败锥内);从失败点回溯每个值与状态的来源并建立前提;再从疑似根因前向验证是否到达观察到的症状;若涉及被调用方,进行跨过程追踪,检查返回値、未处理异常、共享状态变更,并遵守深度限制与调用链上下文标签格式,达到限制时把剩余路径记为前提假设并降为 Medium 置信度;最后确定根本分歧并分类,输出聚焦报告。

使用方式:采用按需加载:仅在需要语言、Iron Law、Fault Confidence、范围路由、Remedy 纪律、配置字段与加载预算时读取 ../_shared/common.md;按步骤读取 logic-locate-guide.md 中相应步骤;需要时再加载 ../_shared/logic-risks.md、../_shared/semiformal-guide.md、../_shared/semiformal-checklist.md 和 ../_shared/report-template.md。

输出要求:报告 Findings 部分只有一个 Primary Fault,不做 Critical/Warning/Suggestion 全分列;以 Fault Confidence(High/Medium/Low)替代 Logic Score 行;必须始终输出带标签的 Premises / Trace / Divergence / Trigger / Remedy 字段及 Fault Confidence 行,即使是一函数的简单 bug;不得仅以普通修复建议作答。报告模式行为 Fault Locate(中文:故障定位)。

限制:仅当任务明确匹配其上游来源与本地项目上下文时使用;应用变更前须验证命令、生成代码、依赖、凭据与外部服务行为;示例不能替代环境相关测试、安全审查,或对破坏性/高成本操作的用户批准。