用途:systematic-debugging 是一个调试流程技能,用于处理任何技术问题,包括测试失败、生产环境缺陷、意外行为、性能问题、构建失败和集成问题。其核心原则是:必须先找到根因再尝试修复,只治症状视为失败。
主要能力:技能定义了四个必须依次完成的阶段。阶段一为根因调查:仔细阅读错误信息与堆栈、稳定复现问题、检查近期变更(如 git diff、提交、依赖与配置变化),并在多组件系统中于各组件边界添加诊断日志以定位失败层,同时沿调用栈向上追踪数据流。阶段二为模式分析:寻找可用的相似实现、完整阅读参考实现、列出工作与故障版本之间的所有差异、理解依赖与假设。阶段三为假设与测试:提出单一明确假设,做最小改动逐一验证,失败则提出新假设而非叠加修复。阶段四为实施:先创建失败测试用例,再实施单一修复,最后验证修复且不破坏其他测试。
使用方式:该技能明确要求仅在用户或人类请求使用此技能、且人类给出 [OK] 时才运行。若修复尝试达到三次仍失败,应停止并质疑架构,与人类伙伴讨论,而不是继续第四次修复。技能还列出红旗信号与常见借口,提醒不要跳过流程。
适用场景:时间压力下的紧急故障、看似简单的缺陷、已多次尝试修复、前次修复无效、对问题理解不充分等情况。
限制:资料未提供安装命令、平台支持、收费方式或具体集成细节,暂未提供。技能附带 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md 等支持文档,并关联 superpowers:test-driven-development 与 superpowers:verification-before-completion 技能。