SuperAPI AI 工具集

debug-mode

编程与开发

查看项目

更新于 11-12 16:18

技能介绍

Debug Mode 是一个调试技能,针对 Claude Code 的终端优先工作流设计,核心是假设驱动、插桩日志和严格流程。它要求进入调试模式时先声明,并在每个响应顶部打印当前阶段。整个流程分为 9 个阶段(0-8),并有五条铁律:无复现不修复、不猜测而是插桩观察、不挂起终端、保护上下文、修复前用 git restore 重置。

用途:用于处理 bug、测试失败或意外行为时,系统化地定位根因并修复。

主要能力:

  • 阶段 0 安全分支:使用 git stash 和创建隔离分支,避免污染工作区。
  • 阶段 1 项目发现:扫描项目脚本、测试框架、最近变更和基础设施。
  • 阶段 2 假设:生成 3-5 个排序假设,每个包含理论、所需证据和可能文件。
  • 阶段 3 复现与隔离:优先使用独立复现脚本、失败单元测试、curl 请求、循环测试或手动复现;复现后立即提交,以便后续重置时保留。
  • 阶段 4 插桩:在可疑代码路径添加带 [DEBUG-MODE] 标签的日志,按假设编号和函数名标记,支持多种语言(JS/TS、Python、Go、Ruby、PHP)。
  • 阶段 5 分析:将输出重定向到文件,使用 grep/tail 过滤,避免上下文爆炸;对每个假设给出确认/反驳/不确定结论。
  • 阶段 6 重置:使用 git restore . 清除所有调试日志,保持代码整洁。
  • 阶段 7 修复:在根因处进行最小修改。
  • 阶段 8 验证:红绿验证,先确认修复后测试通过,再暂存修复确认测试失败,最后恢复修复。

使用方式:在 Claude Code 中触发该技能,按流程执行命令和编写代码;需要 git 环境,否则需手动清理。技能文本包含大量示例代码和命令,但均为指导性内容。

适用场景:任何需要复现和根因分析的 bug 调试,包括逻辑错误、API 响应错误、竞态条件、状态损坏、认证会话问题、缓存问题、不稳定测试、CORS/头问题等。

限制:依赖 git 进行安全重置;需要终端环境;对无法复现的问题可能需多轮插桩;流程较长,适合复杂问题;不提供自动修复,需人工或 AI 按步骤操作。收费、平台等信息暂未提供。