Claude Code 修 bug 总跑偏?这个四阶段调试流程让 AI 先想清楚再动手

Claude Code 写 bug 满天飞?先让它做四阶段调试再说

你有没有过这种感觉:Claude Code 修了一个 bug,紧接着又冒出两个新 bug,像打地鼠一样停不下来。这不是 Claude 的问题,是你没给它一个系统的调试流程。

最近我在 SkillHub 上挖到一个评分 9.1 的 Claude Code 调试 Skill——flow-debugging,来自开发者 Dimon94。它做的事情很简单粗暴:强制 Claude 在修复前,必须走完四个阶段——根因调查 → 模式分析 → 假设验证 → TDD 修复。跳步?不行,系统会直接 block 住。

四阶段到底怎么跑

Phase 1:根因调查——Claude 必须先找到 bug 的真正来源,不是表面错误信息,而是数据在哪里开始跑偏了。它要输出错误类型、消息、堆栈,并列出”最近改了啥”。

Phase 2:模式分析——找到一处正常工作的类似代码,对比差异,推断出真正原因。这一步防止 Claude 对着错误理解一通乱改。

Phase 3:假设验证——不是直接动手,而是提出一个可测试的假设,再执行测试命令验证。不是靠猜,是靠证据。

Phase 4:TDD 修复——先用测试代码复现 bug,再写修复代码,最后跑通测试。强调最小改动,不引入新问题。

为什么强过”直接让它修”

普通流程是:Claude 看了一眼报错,直接给出修复代码。大多数时候能 work,但偶尔会把原代码改坏,或者修复了表面问题、埋下了深层 bug。

flow-debugging 的逻辑是:理解问题 > 立即修复。它要求每个”完成声明”都必须附带最新执行的命令输出作为证据——没有证据就等于没修。

一个使用者说,用了这套流程之后,Claude Code 可以连续跑 2 小时不跑偏,比之前那种”修完一个来一个”的节奏高效太多了。

怎么安装

SkillHub 有页面可以直接复制安装,也有 npm 包 cc-devflow 可以全局安装。flow-debugging 是这个开发流程套件的核心 Skill 之一,配套还有 flow-fix(自动触发四阶段)、verification-before-completion(验证钩子)等工具,打包使用效果更好。

安装命令(Claude Code 里直接跑):

npx skills add https://github.com/Dimon94/cc-devflow --skill flow-debugging

或者直接装整个 cc-devflow 套件:

npm install -g cc-devflow && cc-devflow init

GitHub 仓库 Dimon94/cc-devflow 目前 109 stars,MIT 协议开源。


GitHub: https://github.com/Dimon94/cc-devflow

评论区

0 条评论

登录后可评论。

拾遗·Skill精选官 11 阅读