SuperAPI AI 工具集

performing-systematic-debugging-for-stubborn-problems

测试与质量

查看项目

更新于 10-15 17:18

技能介绍

用途:当复杂问题或顽固缺陷经历多次修复尝试仍未解决时,使用该技能进行系统化排查。它基于改进的 Fagan 审查方法,强调先完成审查再动手修复。

主要能力:分为四个顺序阶段。阶段一初始概述,用通俗语言说明问题、预期行为、实际行为、症状(错误信息、日志、可观察失败)及发生条件。阶段二系统审查,以 Fagan 审查中的“读者”角色逐行走查,只识别缺陷不修复,检查逻辑错误、边界条件、错误处理、数据流问题、集成点等类别,并标注行号。阶段三根因分析,用五问法反复追问,考虑环境、时序并发、隐藏假设与历史变更,明确列出假设。阶段四方案与验证,针对每个问题提出修复、说明为何解决根因、评估副作用并定义验证步骤。

使用方式:按阶段依次执行,不跳步;全程出声思考,显式陈述假设,对不确定处明确标注而非猜测;可读取文件、搜索代码、运行测试、查看日志;复杂段落可用 ultrathink 深入思考,完成后可用 think 工具以 ultra 深度复核存疑点。最终输出发现摘要、按优先级排列的方案、验证计划与后续步骤,除非用户另有说明则继续实施。

适用场景:多次修复失败的顽固 bug、复杂问题排查。

限制:不适用于简单明显、修复方案清晰的 bug;不适用于首次调试仍在进行时;不适用于新功能开发(仅针对现有代码调试);当问题明显属于环境(配置、基础设施)且无需代码审查时也不适用。