用途
Systematic 是一个系统化调试方法技能,用于在任何 bug、测试失败或异常行为出现时,在提出修复方案之前遵循一套固定流程。其核心理念是:随机修复浪费时间并制造新 bug,快速补丁掩盖底层问题,因此必须始终先找到根本原因再修复,症状修复视为失败。技能以“铁律”形式规定:未经根本原因调查,不得提出任何修复。
主要能力
技能将调试过程划分为四个必须依次完成的阶段:
- 根本原因调查:仔细阅读错误信息与堆栈跟踪,一致地复现问题,检查最近改动,在多组件系统中于各组件边界添加诊断埋点收集证据,并沿调用栈向上追踪数据流以定位源头。
- 模式分析:在同一代码库中寻找可工作的相似示例,完整阅读参考实现,列出可用与故障代码之间的每一处差异,并理解依赖、配置与环境假设。
- 假设与测试:提出单一明确的假设(说明“我认为 X 是根因,因为 Y”),做最小化改动、一次只测一个变量,验证后再继续;若失败则形成新假设而非叠加修复。
- 实施修复:先创建失败测试用例(尽可能自动化),只做一处针对根因的修改,然后验证测试通过、其他测试未被破坏、问题确实解决。若修复次数达到 3 次以上仍未解决,应停止并质疑架构是否存在根本问题,与人工协作者讨论后再继续。
技能还提供“红旗”清单,列举应停止并回到第一阶段的想法,例如“先快速修一下以后再说”“改个 X 试试看”“一次加多个改动”“跳过测试手动验证”“大概是 X 吧直接改”等;并列出常见自我合理化借口及其反驳,例如“问题简单不需要流程”“紧急情况没时间走流程”“先试一下再调查”“多个修复一起做省时间”“参考太长就自己改编”。
使用方式
在遇到技术问题时按四个阶段依次执行,每个阶段满足成功标准后再进入下一阶段。技能要求配合使用 debug:root-cause 子技能处理深层调用栈中的错误追溯,配合 core:tdd 子技能编写失败测试用例;还提到可互补使用 debug:defense-in-depth(找到根因后在多层添加校验)、testing:condition-wait(替换第二阶段发现的任意超时等待)以及 core:verification(在声称成功之前验证修复有效)。
适用场景
适用于任何技术问题,包括测试失败、生产环境 bug、异常行为、性能问题、构建失败和集成问题。技能特别强调在时间压力大、看似“只需一个快速修复”、已经尝试过多次修复、上次修复无效或尚未完全理解问题时应使用。文档也明确说明:问题看似简单、时间紧迫、管理者要求立刻修复时都不应跳过流程,因为系统化调试比反复试错更快。
限制
该技能是一套流程规范,文中的子技能引用(如 workflow:parallel-agents、debug:root-cause、core:tdd 等)需在相应环境中具备才能配合使用;资料未提供具体安装命令、收费信息、支持的平台或工具集成方式,这些内容暂未提供。