用途:用于系统化、假设驱动的调试,强调先复现问题再修复,而非凭猜测改动代码。触发场景包括用户要求“debug this”“why is this failing”“find this bug”,调用 /mole-debug,或出现测试失败、间歇性故障、竞态条件、错误信息指向不明、本地正常生产失败等情况。
主要能力与流程:分为五个阶段。FEEL:复现问题,记录完整错误、触发步骤、环境信息并做最小化复现;无法复现时扩大搜索范围或使用 git bisect。DIG:从入口到出口追踪数据流,在系统边界放置带 [MOLE:LOCATION] 标记的探针,可用 gf --agent func、gf --agent search、gf --agent usage、gf --agent impact 等命令辅助。TUNNEL:一次只验证一个假设,进行二分搜索,用 Vibration Log 记录结果;若在三个不同位置修复均失败,触发 Three-Burrow 阈值并停止,升级到架构层面审查。SURFACE:先写能复现 bug 的失败测试,再修复代码使其通过,然后运行受影响 CI,命令为 pnpm install 和 gw ci --affected --fail-fast --diagnose。SEAL:保留回归测试、添加根因注释、检查同类问题、清理所有 [MOLE:*] 调试日志。
限制与要求:必须复现后再修复,必须写失败测试后再改代码,一次只改一个变量,不得随意散落 console.log,不得只修症状,不得在无回归测试下提交修复。资料同时提到与 beaver-build、panther-strike、bloodhound-scout、eagle-architect 等技能配合使用,并提供 references/grove-debugging-patterns.md 与 references/debugging-strategies.md 作为参考。部分工具与运行环境的完整细节暂未提供。