performing-systematic-debugging-for-stubborn-problems

此技能通过应用改良的 Fagan 检查方法论，为系统化调试提供了结构化框架。它专为面临复杂、持续存在且多次尝试修复仍无效的问题的开发人员所设计。通过从试错式的“快速修复”转向系统化的多阶段分析，此工具确保通过逻辑严密性而非臆测来识别根本原因。

流程分为四个阶段：初始概述、系统化检查、使用“五个为什么”技术进行根本原因分析，以及解决方案与验证。在检查阶段，代理作为阅读者，执行逐行代码导览，以检测逻辑错误、边界条件失败、错误的异常处理、数据流不一致以及集成点缺陷。它要求明确的推理，代理必须记录每一项假设，标记不明确的部分以进行深入分析，并透过大声思考来保持透明度。

• 执行逐行检查以识别逻辑错误、控制流问题与边界条件缺陷。

• 实施“五个为什么”技术，将症状追溯至环境、并发或设计背景中的根本原因。

• 促进对预期行为与实际行为的详细记录，以厘清复杂的系统交互。

• 产生结构化的验证计划，包括具体的测试案例、手动步骤与监控策略，以确保永久解决问题。

• 作为防止“随机调试”的守门员，要求在实施前必须完成分析。

• 最适合用于难以处理的错误、复杂的分布式系统故障，或需要深入架构理解的遗留代码缺陷。

• 不适用于简单的语法错误、不涉及代码的环境配置问题，或初步的故障排除。

• 输入需要问题背景、代码库与失败的尝试历史；输出为分类后的缺陷清单、根本原因报告与验证蓝图。

• 用户必须在各阶段之间提供明确核准，以确保质量与系统设计约束的一致性。

• 针对逻辑或集成点极度晦涩的复杂部分，运用“深度思考 (ultrathink)”能力。