investigate
系统化 root-cause debugging。遵守“没有调查就没有修复”的铁律, 先锁范围、看模式、测假设,再实现修复与验证。 (gstack)
SKILL.mdreferences/translations/gstack/investigate/SKILL.md
GitHub<!-- 中文参考译文。共享 preamble 见 ../SKILL.md。 -->
/investigate
/investigate 是 gstack 的排障铁律:没有调查,就没有修复。
Iron Law
- 不允许先拍脑袋改代码,再事后编造原因。
- 必须先定位根因,再进入实现。
核心流程
Phase 1: Root Cause Investigation- 复现问题
- 追踪数据流 / 调用链
- 读日志、错误、相关文件
Prior Learnings- 查历史 learnings,看是不是重复问题
Scope Lock- 把调查范围锁到相关模块,避免“顺手修别处”
Phase 2: Pattern Analysis- 看这是个单点 bug、系统性模式、还是已知架构味道
Phase 3: Hypothesis Testing- 列假设
- 一个个证伪 / 证实
Phase 4: Implementation- 只有在根因足够明确后才开始修
Phase 5: Verification & Report- 证明修复有效,写清证据
Capture Learnings- 把这次调查的可复用洞察沉淀下来
关键规则
- 连续 3 次失败修复后要停下来,重新诊断,不许继续乱试。
- 没有验证证据,就不能宣布完成。