系统化调试 Systematic Debugging

完整覆盖 Full Coverage

遇到 bug 别慌，用科学方法定位根因、修复验证 Don't panic when bugs hit — use scientific methods to find root causes and verify fixes

入口条件 Entry Condition

你发现了一个 bug 或异常行为 You've found a bug or unexpected behavior

交付物 Deliverables

bug 根因已定位，修复已验证，无回归问题 Bug root cause located, fix verified, no regression

3 个步骤 3 Steps

定位根因 Identify Root Cause

Solo Solo

禁止猜测，用证据定位根因，构建最小复现路径 No guessing — use evidence to locate root cause, build minimal reproduction

系统化调试（Systematic Debugging）

质量标准 Quality Criteria

- 不靠猜测，靠证据和数据 - 构建最小复现路径 - 记录完整的调试过程 - 明确根因所在的代码位置 - Evidence and data driven, not guessing - Minimal reproduction path built - Complete debugging process documented - Root cause code location identified

验证门 Verification Gate

是否有明确的证据指向根因？还是在猜测？能否用一句话描述根因？ Is there clear evidence pointing to root cause? Or still guessing?

修复 Fix

Solo Solo

先写能暴露 bug 的测试，再实施修复 Write a test that exposes the bug first, then implement the fix

TDD（测试驱动开发）

质量标准 Quality Criteria

- 先写一个能暴露 bug 的失败测试 - 实施最小化修复 - 确认测试从红变绿 - 不引入额外复杂度 - Write a failing test that exposes the bug - Implement minimal fix - Confirm test goes from red to green - No additional complexity introduced

验证门 Verification Gate

是否先写了暴露 bug 的测试？修复后测试是否从红变绿？ Was a bug-exposing test written first? Did it go from red to green?

验证 Verify

Solo Solo

确认修复完整，无回归，相关功能正常 Confirm fix is complete, no regression, related features work

完成前验证（Verification Before Completion）

质量标准 Quality Criteria

- 原始 bug 已解决 - 无新引入的回归问题 - 相关功能全部正常 - 运行完整测试套件 - Original bug resolved - No newly introduced regressions - All related features working - Full test suite passes

验证门 Verification Gate

验证清单是否全部通过？有没有可能遗漏的回归场景？ Has verification checklist fully passed? Any possibly missed regression scenarios?