SuperAPI AI 工具集

systematic-debugging

测试与质量

查看项目

更新于 10-16 07:16

技能介绍

用途:用于处理任何技术问题,包括测试失败、生产环境缺陷、异常行为、性能问题、构建失败和集成问题。核心原则是先找到根因再修复,症状修复视为失败。

主要能力:提供四阶段流程。阶段一为根因调查,要求仔细阅读错误信息与堆栈、稳定复现问题、检查近期变更,并在多组件系统中于各组件边界添加诊断日志以定位失败层,同时沿调用栈反向追踪数据流。阶段二为模式分析,寻找可用的相似实现、完整阅读参考实现、列出工作与故障版本之间的所有差异并理解依赖。阶段三为假设与测试,提出单一明确假设,做最小改动验证,一次只改一个变量。阶段四为实施,先创建失败测试用例,再实施单一修复并验证。

使用方式:按阶段顺序执行,未完成阶段一不得提出修复。若修复失败,少于三次则回到阶段一重新分析;达到三次及以上应停止并质疑架构,与人类伙伴讨论后再继续。目录内还提供 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md 等配套技术,并关联 superpowers:test-driven-development 与 superpowers:verification-before-completion 技能。

适用场景:时间紧迫、看似只需一处快速修复、已尝试多次修复、前次修复无效或尚未完全理解问题时尤其适用。

限制:资料未提供安装命令、平台支持、收费方式或具体版本信息。若系统化调查确认问题确属环境、时序或外部因素,应记录调查过程并实施重试、超时或错误提示等处理,但资料指出约 95% 的“无根因”情况实为调查不完整。