SuperAPI AI 工具集

systematic-debugging

编程与开发

查看项目

更新于 10-16 01:33

技能介绍

用途:用于处理各类技术问题,包括测试失败、生产环境 bug、意外行为、性能问题、构建失败与集成问题。尤其在时间紧迫、看似只需“快速一改”、已多次尝试修复无效或尚未完全理解问题时更应使用。

主要能力:将调试分为四个必须依次完成的阶段。阶段一为根因调查:仔细阅读错误信息与堆栈、稳定复现、检查近期变更(git diff、提交、依赖与配置)、在多组件系统中于各组件边界加入诊断日志以定位失败层,并沿调用栈向后追踪数据流直至源头。阶段二为模式分析:查找同代码库中可用的相似实现,完整阅读参考实现,列出工作与损坏版本之间的所有差异,理解依赖、配置与环境假设。阶段三为假设与验证:提出单一明确假设并写下,做最小改动、每次只变一个变量来测试;失败则形成新假设,不在旧修复上叠加。阶段四为实施:先创建最简单且可自动化的失败测试,再针对根因做单一修复,最后验证测试通过且未破坏其他测试。

使用方式:当 3 次及以上修复失败时,应停止继续尝试,转而质疑架构,并与人类伙伴讨论是否需要重构,而非再做第 4 次修复。该技能还附带根因追踪、纵深防御与基于条件的等待等支持技术,并建议配合 tdd 技能编写失败测试、配合验证技能确认修复有效。

适用场景与限制:资料指出,95% 的“无根因”情形实为调查不完整;若最终确认为环境、时序或外部因素,应记录调查过程并加入重试、超时、错误提示与监控日志。具体安装命令、收费与平台信息暂未提供。