SuperAPI AI 工具集

systematic-debugging

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:把缺陷报告、失败测试或异常运行时行为,转化为有证据支撑的代码级修复路径。强调在没有证据支持根因前不写修复代码,以阻止猜测式打补丁、反复失败修复和“在我机器上能跑”的即兴处理。

主要能力:

  1. 建立当前失败边界:明确什么在失败、在哪失败、如何复现,以及问题属于本地、集成边界还是发布边界。
  2. 先检索历史上下文:若症状疑似已知回归、事故或回滚模式,先调用 bug-history-retrieval,用历史匹配缩小搜索空间,但不跳过调查。
  3. 复现并收集证据:优先用失败自动化测试,其次确定性手工复现;跨服务、队列、任务或异步跳转时在组件边界加埋点。
  4. 隔离根因:检查近期代码与配置变更、契约或兼容性假设、缺失的回归覆盖、环境或发布差异、从旧事故复制的错误绕过方案。若证据指向规划、需求或架构错配,则输出 course-correction-note 并上报。
  5. 选择最小安全修复路径:明确变更行为、保持不变项、需保护的遗留接缝或兼容规则,并说明是永久修复还是显式绕过方案;随后交给 tdd 先写复现或回归测试。
  6. 记录结果:产出 bug-fix-report,包含复现步骤或失败测试、根因、证据、修复范围、回归或特征化测试要求,以及绕过方案遗留的技术债。

升级规则:第一次修复失败应收集更多证据;第二次失败应书面质疑当前假设;第三次及以上应停止局部补丁,假定存在结构性错配并准备 course-correction-note。

适用场景:需要根因优先的调试循环,尤其是遗留系统接缝、失败测试、回归或非预期行为,且用户影响已被控制后。若问题仍是活跃生产事故且尚未遏制,应先走 incident-response,而非本技能。

限制:输入需代码路径、测试套件等资料;历史缺陷上下文与修复沿革简报为可选。技能本身不替代事故响应,也不替代上游规划或架构决策。安装命令与平台支持信息暂未提供。