SuperAPI AI 工具集

debug-mastery

测试与质量

查看项目

更新于 10-16 06:44

技能介绍

用途:提供系统化调试方法论,强调先完成根因调查再提出修复,避免随机改动掩盖底层问题。适用于测试失败、生产 Bug、异常行为、性能问题、构建失败、集成问题等任何技术故障。

主要能力:四阶段流程——1) 根因调查:仔细阅读错误信息与堆栈、稳定复现、检查近期变更、在多组件系统中于各边界加诊断埋点、沿调用栈回溯数据来源;2) 模式分析:寻找可工作的相似实现、完整阅读参考实现、逐项列出差异、理清依赖与假设;3) 假设与验证:一次只提一个明确假设、做最小改动测试、未通过则提新假设而非叠加修复;4) 实现:先写失败测试用例(可配合 tdd-mastery),只改根因、一次一处,然后验证。若修复尝试达 3 次以上仍未解决,应停下质疑架构,而非继续第 4 次修复。

可观测性规范:要求精确日志,含 timestamp、level、traceId、component、message、context 等字段;日志分级 ERROR/WARN/INFO/DEBUG;分布式追踪需每个请求携带 TraceID 并为工具调用和复杂逻辑设置 span;前端可用状态快照与视觉回归工具,后端可参考 eBPF 与事务审计,扩展可检查 Service Worker 与端口断连。相关技能包括 root-cause-tracing.md、defense-in-depth.md、verification-mastery、clean-code。

限制:资料中的修复耗时与首次修复率等效果数据来自调试会话经验,未提供来源与方法说明;具体命令、安装方式与平台支持暂未提供。