systematic-debugging

systematic-debugging 技能旨在防止在处理复杂软件问题时应用临时补丁的常见工程反模式。通过强制执行严格的调查阶段序列，该技能确保代理程序能识别错误的根本来源，而非仅仅掩盖症状。它适用于在可靠性至关重要的环境中工作的软件开发人员与编码代理。当发现测试失败、生产环境错误、非预期的运行期行为或性能回归时，该技能会自动触发，强制执行「根本原因优先」的方法。

• 第一阶段：进行全面的调查，包括堆栈跟踪分析、一致的重现步骤、近期 git 提交的差异分析，以及多组件边界检测。

• 第二阶段：通过将损坏的代码与工作参考进行比较来进行模式分析，以识别微小的环境或逻辑差异。

• 第三阶段：采用科学方法进行假设制定，要求在执行单变量测试前记录推理过程。

• 第四阶段：执行有针对性的修复，如果超过三次尝试仍无法解决问题，内置架构评估的护栏机制会介入。

• 对于任何技术问题（包括 CI/CD 失败、整合问题与竞态条件）皆须强制使用。

• 要求基于证据的调试：代理程序在提出变更前，必须记录每个边界（例如 API 层、数据库查询、构建脚本）的发现。

• 通过要求在多次尝试修复无效时转向架构审查，防止无效的开发循环。

• 与测试驱动开发 (TDD) 及其他 Superpowers 技能无缝整合，确保每次修复皆由先失败后成功的测试案例验证。

• 结合追踪技术来定位损坏数据值的根源，确保修复发生在源头而非仅在失败点。