用 Claude Code 写代码的时候，遇到运行时 bug ，它总是直接看代码就给诊断，经常猜错方向。

Cursor 有个 Debug Mode 挺好的——先插日志探针，跑一遍收集运行时数据，再基于证据定位问题。于是参考这个思路，给 Claude Code 做了一个 /debug-mode Skill 。

核心流程

Step 0: 问诊    — 向用户提问收集线索（预期 vs 实际、复现步骤、报错信息）
Step 1: 假设    — 读代码，列 2-3 个假设，规划探针位置
Step 2: 初始化  — 创建 .claude-debug/ 日志目录
Step 3: 插探针  — 在源码中插入日志探针（带 START/END 块标记）
Step 4: 复现    — 运行代码，收集运行时日志（支持多次运行）
Step 5: 分析    — 读日志，用证据定位根因
Step 6: 修复验证 — 修复后保留探针再跑一次（ VERIFY run ），对比前后日志
Step 7: 清理    — 删除所有探针和调试文件

效果展示

几个设计细节

1. 检查点机制 — 7 个 CHECKPOINT 强制按序执行，不允许跳过插探针直接给答案（ Claude 很喜欢偷懒）

2. 探针块标记 — 用 🔍 DEBUG PROBE [N] / 🔍 DEBUG PROBE END [N] 包裹，清理时按块删除，不会误删正式代码

3. 日志分段 — 每次运行前写 ========== RUN #1 ========== 分隔符，修复验证标记为 ========== VERIFY ==========，前后对比一目了然

4. 多语言 — 支持 JS/TS 、Python 、Swift 、Go 、Kotlin/Java 、Shell

安装

git clone https://github.com/lifedever/claudecode-debug-mode.git ~/.claude/skills/debug-mode

然后在 Claude Code 中输入 /debug-mode 描述你的 bug 即可触发。

仓库地址

GitHub: https://github.com/lifedever/claudecode-debug-mode

欢迎试用和反馈，有问题直接提 issue 。