SuperAPI AI 工具集

systematic-debugging

测试与质量

查看项目

更新于 10-15 21:41

技能介绍

用途:在 VS Code Copilot Agent 模式下处理任何技术问题,包括测试失败、生产缺陷、异常行为、性能问题、构建失败和集成问题;尤其适用于时间紧迫、看似只需“快速修复”、已多次尝试修复或尚未完全理解问题时。

核心原则:必须先找到根因再修复,症状修复视为失败。铁律是“未完成根因调查前不得提出修复”。

四个阶段:

  1. 根因调查:仔细阅读错误与堆栈,稳定复现,检查近期变更(git diff、提交、依赖、配置、环境差异);多组件系统(如 CI→构建→签名、API→服务→数据库)需在组件边界加诊断日志,先收集证据定位失败层,再调查该组件;深层调用栈可用根因回溯,配合 Serena MCP 的 find_referencing_symbols 逐层向上追踪。
  2. 模式分析:寻找可工作的相似代码,完整阅读参考实现,列出工作与损坏之间的所有差异,理解依赖、配置与假设。
  3. 假设与测试:写出单一明确假设,做最小改动、一次只改一个变量,验证后再继续;不成立则形成新假设,不在旧修复上叠加。
  4. 实现:先创建失败测试用例(可用 obra-test-driven-development 技能),只做一处根因修复,验证测试通过且未破坏其他测试。若修复失败,尝试少于 3 次则回到阶段 1;达到 3 次以上应停止并质疑架构,与人类伙伴讨论后再继续。

工具建议:VS Code 搜索/ripgrep、转到定义、查找引用、临时日志或断言(提交前移除)、调试器启动配置。

限制与说明:若系统调查后确认问题确属环境、时序或外部因素,应记录调查内容并实现重试、超时、错误信息与监控;但资料指出 95% 的“无根因”情况属于调查不完整。具体安装命令、收费与平台支持信息暂未提供。