SuperAPI AI 工具集

logic-explain

通用与其它

查看项目

更新于 10-16 05:51

技能介绍

用途:当用户对某段代码的实际行为感到困惑,或想知道“为什么输入 X 得到 Y”时,用本技能生成针对特定输入的分步执行追踪(跨函数,含名称解析与类型转换说明)。它偏描述性,用于解释而非评估。

主要能力:Step 0 语言与范围路由,检测语言并确认单一函数加单一输入场景;Step 1 明确入口点、输入场景与用户想理解的问题;Step 2 建立前提,解析不明显的名称、说明入口处关键变量类型、标注访问的全局或模块状态;Step 3 产出编号的分步追踪,跨函数边界,围绕用户场景,不主动分支到其他路径;Step 4 突出不易察觉的行为,如名称解析、隐式转换、隐藏副作用;Step 5 用各一句话总结“实际行为 vs 假设行为”。报告模式行写作 Execution Explain(中文:执行解释)。

使用方式:按 ../_shared/common.md §13 懒加载;仅在需要语言、报告头变体、范围路由和加载预算时读取 ../_shared/common.md,按需读取 logic-explain-guide.md 中对应步骤,并按需加载 ../_shared/semiformal-guide.md、../_shared/semiformal-checklist.md、../_shared/report-template.md。刻意跳过 logic-risks.md:本模式不产出 L-code 发现,Remedy 也不在范围内。

适用场景:用户询问某输入下的执行过程,或对行为与预期不符感到困惑。

限制:若用户只想找 bug 而无输入场景,转交 logic-review;若追踪中发现 bug,停止并建议 logic-review 或 logic-locate,交接时以“Partial trace context (carry into next skill):”保留已建立的前提与已完成步骤。报告头省略 Logic Score、Fault Confidence 与 Verdict 行。技能仅在上游来源与本地项目上下文明确匹配时使用;应用前需自行验证命令、生成代码、依赖、凭据与外部服务行为;示例不能替代环境相关测试、安全审查或破坏性/高成本操作的审批。前置文档的具体内容与更多细节暂未提供。