用 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 。
目前尚无回复
Select Language