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 协议开源。
评论区
登录后可评论。